MapTiler Search and Geocoding API

MapTiler 官方地理编码 API 需 API key，支持按名称、坐标、feature ID 或批量查询，返回 GeoJSON FeatureCollection。正向查询可按区域、国家、类型和语言过滤；limit最多10，价格、配额及再利用条款未知，未调用。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

整理进度：已整理 · 语义分类：地理空间／MapTiler 地名与 POI 地理编码 · 证据等级：公开文档，未实测。

公开来源正文附件（安全文本） · 3782ff65b5f360ad436eef67a8ac8ce034e7fe14d680fffb6a91e5052d6247fc

本卡采用官方 Zurich 正向地理编码 GET 示例，服务能搜索地名与 POI。可直接由前后端 HTTP 调用，不要求安装 SDK；搜索结果与标签可能受类型、语言、proximity 及 worldview 设置影响，不能将示例当当前准确结果。

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-c4e872b044f85e7d9a83cfd8 · 版本 2 · 保存此版本引用

尚未深检；没有深度profile，条件保持未知，不表示不支持。

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

稳定标识: cap-c4e872b044f85e7d9a83cfd8
名片版本: 2
资料更新: 2026-10-24T18:35:00.1129470+00:00
原作者 / 提供者: MapTiler
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

query 必填地名，可混合 POI 类别与名称；bbox 按[w,s,e,n]严格限制范围，proximity=[lon,lat]或ip影响排序。
可选 country、language、types、excludeTypes、fuzzyMatch、autocomplete、worldview；正向 limit 默认5、范围1–10。
批量路径以未编码分号分隔最多50个查询；forward、reverse 或 feature ID 可组合，但本卡示例只用单条正向查询。

输出

200 返回 application/json 的 GeoJSON FeatureCollection；features 含几何、id、名称、place_type、context 等，具体字段依结果。
示例有 query 和 attribution；400 表示查询过长/参数无效，403 表示 key 缺失、无效或受限。
批量返回与输入顺序对应的 FeatureCollection 数组；不是一份合并后的地图图像。

使用方式

类型: HTTP 接口
入口: 原使用入口
HTTP 方法: GET

鉴权：API 密钥。本页明确必须 MapTiler API key，官方 curl 示例用 key query 参数；缺失、无效或受限 key 返回403。未获取或使用凭据。

运行前提

具备有效 MapTiler API key；默认 server 为 https://api.maptiler.com。
查询名称放入 /geocoding/{query}.json；可直接HTTP调用，SDK为可选工具。
EU endpoint 仅在本页链接到另文，本卡不猜其完整地址或区域处理保证。
不注册、获取key、安装SDK、运行交互测试或提交真实地址。

公开请求示例

{
  "method": "GET",
  "notes": "\u5B98\u65B9\u6B63\u5411\u67E5\u8BE2\u793A\u4F8B\uFF1B\u53E6\u9700 key query \u53C2\u6570\uFF0C\u672A\u6267\u884C\u3002",
  "url": "https://api.maptiler.com/geocoding/Zurich.json"
}

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

未知。本页提到可按API requests或SDK sessions追踪使用，但没有计划/费率、免费额度或超额价格正文。

价格来源 · 未知

资料去向

提供者服务器。名称、地址、坐标和key送至MapTiler；proximity=ip可触发服务端IP地理定位。日志、保留与区域处理政策未包含，本次未查询。

限制

返回 feature ID 会在数据库重建索引时变化，不应视为永久稳定标识。
worldview 改变争议地区边界、名称、国家过滤和 context；默认/auto行为不同，需按应用显式选择。
reverse limit>1 有单一 types 等额外要求，不能把正向参数规则无条件推广到反向查询。
本页未给数值速率、月额度、费用、SLA或完整数据许可；请求/会话两种用量方式也需对应计费文档确认。

仍需核对

真实key权限、费用、数值限流/配额、SLA、日志/区域保留政策与再利用许可未知。
实际搜索覆盖、准确性、当前结果与EU替代endpoint未验证。

提交者报告的验证

仅查阅资料 · 未测试

仅读取公开来源；未调用所述工具。

日期: 2026-10-24T18:33:56.7408894+00:00
软件版本: 未知

实际检查

来源HTTPS响应可读取

未验证范围

功能、鉴权、安装、输出质量、长期可用性均未由本站测试。

公开证据

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

Search and geocoding API | MapTiler API | MapTiler · 官方文档 · 2026-10-25T02:33:56.7408894+08:00

提交者自述：NAVONAVO public material importer。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://docs.maptiler.com/cloud/api/geocoding/",
  "final_url": "https://docs.maptiler.com/cloud/api/geocoding/",
  "status_code": 200,
  "title": "Search and geocoding API | MapTiler API | MapTiler",
  "description": "Forward and reverse geocoding API for global location search.",
  "checked_at": "2026-10-24T18:33:56.7408894\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-c4e872b044f85e7d9a83cfd8",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://docs.maptiler.com/cloud/api/geocoding/"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。