咨询客服
MapTiler API
2026年09月09日 09:09
GISBox是一站式三维GIS数据编辑、转换、发布平台，支持OSGB/GEOTIFF/RVT等多种GIS格式编辑，转换为3DTiles/Terrain等并发布。
简介
MapTiler API是一套可通过编程方式访问你MapTiler账户内所有地图数据、服务与资源的接口集合，它以只读的安全形式适配各类面向公众的终端应用，你只需传入专属API密钥，就能在网站或应用中直接接入地图瓦片、生成自定义静态地图图片、完成地址地理编码、基于IP获取访客大致位置等各类地理信息相关操作，覆盖从基础地图展示到定制化地理功能开发的多种场景。
文件结构
MapTiler API核心文件结构，集体如下：
- 地图资源基础路径：以https://api.maptiler.com/maps/{mapId}/为根路径，所有地图相关资源都基于该路径扩展，mapId为对应地图的唯一标识，如streets-v4。
- 样式JSON文件：路径为/style.json，返回描述地图制图规则的JSON对象，可直接对接Mapbox GL JS、OpenLayers等库加载矢量地图。
- 精灵资源文件：路径格式为/sprite{scale}.{format}，提供矢量地图渲染所需的地图符号资源，支持@2x高清规格，格式包含png和json。
- 栅格瓦片文件：路径格式为/{tileSize}/{z}/{x}/{y}{scale}.{format}，遵循XYZ瓦片规范，按缩放层级z、瓦片列x、瓦片行y组织栅格地图切片，支持png、jpg、webp等格式。
- 嵌入HTML视图文件：根路径直接返回可嵌入的交互式HTML地图页面，无需额外配置即可快速在业务系统中集成地图展示能力。
优点
- 开发体验友好：基于TypeScript编写，自带完整的类型提示、代码补全与上下文辅助能力，能大幅减少拼写错误，降低开发过程中的调试成本。
- 跨环境兼容：同时支持Node.js服务端环境和浏览器端运行，适配前后端不同开发场景，且提供开源使用许可，无额外版权限制。
- 接口稳定性强：官方对API端点变更提供向后兼容保障，后续接口迭代不会直接导致现有业务代码失效，降低维护风险。
- 功能覆盖全面：一站式封装正向/反向地理编码、IP定位、坐标系统转换、GeoJSON数据拉取、静态地图生成、批量高程查询等能力，无需对接多个第三方服务。
- 成本优势突出：个人免费计划每月提供10万次地图访问量，完全覆盖中小站点日常需求；商业定价透明，无隐形收费，相比同类地图API大幅降低高频使用场景的成本支出。
- 地理编码能力优质：依托持续更新的全球地址数据库，不断接入官方公开数据源，地址搜索与逆地理编码的结果精准度和全球覆盖度持续提升。
缺点
- 静态地图接口限制：静态地图生成能力完全不对免费计划开放，仅能在任意付费套餐中解锁使用，个人非商业场景无法直接调用该能力。
- 部分高级功能门槛高：批量地理编码、企业级专属数据部署等能力仅能在高阶付费计划中获取，小成本商业项目无法低成本解锁相关功能。
- 终端渲染依赖：矢量瓦片的渲染运算完全在用户本地终端完成，低性能设备上可能出现地图加载卡顿、渲染延迟的问题。
- 免费计划有软限制：免费版的地图访问量为月度软限制，超出后会被限流，无法满足高流量公开站点的长期免费使用需求。
应用场景
MapTiler API的应用场景覆盖多个地理信息相关领域，它可以生成带自定义标记、路线的非交互式静态地图图片，直接用于网页配图、邮件内嵌地图、业务报表等无需交互的展示场景，也能对接前端地图开发库快速搭建可缩放的交互式网页地图，同时依托配套的地理编码、IP定位能力，为LBS类应用提供地址转坐标、访客属地识别的底层支撑，还支持全地图元素自定义，帮助企业快速生成匹配自身品牌视觉风格的专属地图，适配各类个性化产品的展示需求。
示例图
1. 创建图例控制。
文件打开方式
1. 瓦片地图切片。
