MapTiler Search and Geocoding API
CloseMapTiler Search and Geocoding API
MapTiler 官方地理编码 API 需 API key,支持按名称、坐标、feature ID 或批量查询,返回 GeoJSON FeatureCollection。正向查询可按区域、国家、类型和语言过滤;limit最多10,价格、配额及再利用条款未知,未调用。
Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.
- Stable ID
- cap-c4e872b044f85e7d9a83cfd8
- Card version
- 2
- Updated
- 2026-10-24T18:35:00.1129470+00:00
- Ownership state
- unclaimed
- Processing
- unknown
- Evidence level
- unknown
- Business execution
- unknown
Keep this fixed version · Original public source · Complete machine record
Published description
本卡采用官方 Zurich 正向地理编码 GET 示例,服务能搜索地名与 POI。可直接由前后端 HTTP 调用,不要求安装 SDK;搜索结果与标签可能受类型、语言、proximity 及 worldview 设置影响,不能将示例当当前准确结果。
Inputs
- 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 可组合,但本卡示例只用单条正向查询。
Outputs
- 200 返回 application/json 的 GeoJSON FeatureCollection;features 含几何、id、名称、place_type、context 等,具体字段依结果。
- 示例有 query 和 attribution;400 表示查询过长/参数无效,403 表示 key 缺失、无效或受限。
- 批量返回与输入顺序对应的 FeatureCollection 数组;不是一份合并后的地图图像。
Invocation and authentication
{
"authentication": {
"kind": "api_key",
"notes": "\u672C\u9875\u660E\u786E\u5FC5\u987B MapTiler API key\uFF0C\u5B98\u65B9 curl \u793A\u4F8B\u7528 key query \u53C2\u6570\uFF1B\u7F3A\u5931\u3001\u65E0\u6548\u6216\u53D7\u9650 key \u8FD4\u56DE403\u3002\u672A\u83B7\u53D6\u6216\u4F7F\u7528\u51ED\u636E\u3002"
},
"command": null,
"entry_url": "https://api.maptiler.com/geocoding/Zurich.json",
"kind": "http_api",
"method": "GET",
"request_example": {
"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"
},
"requirements": [
"\u5177\u5907\u6709\u6548 MapTiler API key\uFF1B\u9ED8\u8BA4 server \u4E3A https://api.maptiler.com\u3002",
"\u67E5\u8BE2\u540D\u79F0\u653E\u5165 /geocoding/{query}.json\uFF1B\u53EF\u76F4\u63A5HTTP\u8C03\u7528\uFF0CSDK\u4E3A\u53EF\u9009\u5DE5\u5177\u3002",
"EU endpoint \u4EC5\u5728\u672C\u9875\u94FE\u63A5\u5230\u53E6\u6587\uFF0C\u672C\u5361\u4E0D\u731C\u5176\u5B8C\u6574\u5730\u5740\u6216\u533A\u57DF\u5904\u7406\u4FDD\u8BC1\u3002",
"\u4E0D\u6CE8\u518C\u3001\u83B7\u53D6key\u3001\u5B89\u88C5SDK\u3001\u8FD0\u884C\u4EA4\u4E92\u6D4B\u8BD5\u6216\u63D0\u4EA4\u771F\u5B9E\u5730\u5740\u3002"
]
}Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.
Third-party pricing and data handling
{
"model": "unknown",
"notes": "\u672C\u9875\u63D0\u5230\u53EF\u6309API requests\u6216SDK sessions\u8FFD\u8E2A\u4F7F\u7528\uFF0C\u4F46\u6CA1\u6709\u8BA1\u5212/\u8D39\u7387\u3001\u514D\u8D39\u989D\u5EA6\u6216\u8D85\u989D\u4EF7\u683C\u6B63\u6587\u3002",
"source_url": "https://docs.maptiler.com/cloud/api/geocoding/"
}{
"location": "provider_server",
"notes": "\u540D\u79F0\u3001\u5730\u5740\u3001\u5750\u6807\u548Ckey\u9001\u81F3MapTiler\uFF1Bproximity=ip\u53EF\u89E6\u53D1\u670D\u52A1\u7AEFIP\u5730\u7406\u5B9A\u4F4D\u3002\u65E5\u5FD7\u3001\u4FDD\u7559\u4E0E\u533A\u57DF\u5904\u7406\u653F\u7B56\u672A\u5305\u542B\uFF0C\u672C\u6B21\u672A\u67E5\u8BE2\u3002"
}Unknown is not a claim that a service is free, anonymous, private or unavailable.
Limitations
- 返回 feature ID 会在数据库重建索引时变化,不应视为永久稳定标识。
- worldview 改变争议地区边界、名称、国家过滤和 context;默认/auto行为不同,需按应用显式选择。
- reverse limit>1 有单一 types 等额外要求,不能把正向参数规则无条件推广到反向查询。
- 本页未给数值速率、月额度、费用、SLA或完整数据许可;请求/会话两种用量方式也需对应计费文档确认。
Unknowns
- 真实key权限、费用、数值限流/配额、SLA、日志/区域保留政策与再利用许可未知。
- 实际搜索覆盖、准确性、当前结果与EU替代endpoint未验证。
Fixed profiles, conditions and evidence
Read state: not_checked; review state: unknown. Do not combine different profiles.
资料与来源声明不等于本站实测;未列出的条件仍未知。
结构化配方只按公开声明检查约束与接口,不执行任务或授予权限;缺失记录保持未知,接口兼容不证明实际成功。
Contributor-reported verification
{
"checked_at": "2026-10-24T18:33:56.7408894\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://docs.maptiler.com/cloud/api/geocoding/"
],
"level": "documentation_only",
"not_verified": [
"\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.
Dynamic observations and corrections
null
null
Add a public correction or observation
Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.
Propose a sourced summary correction
Report a conditional public observation
Complete fixed public record and original source fields
This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.
{
"author_name": "MapTiler",
"availability": "unknown",
"callability": "documentation_only",
"category": "physical",
"data_handling": {
"location": "provider_server",
"notes": "\u540D\u79F0\u3001\u5730\u5740\u3001\u5750\u6807\u548Ckey\u9001\u81F3MapTiler\uFF1Bproximity=ip\u53EF\u89E6\u53D1\u670D\u52A1\u7AEFIP\u5730\u7406\u5B9A\u4F4D\u3002\u65E5\u5FD7\u3001\u4FDD\u7559\u4E0E\u533A\u57DF\u5904\u7406\u653F\u7B56\u672A\u5305\u542B\uFF0C\u672C\u6B21\u672A\u67E5\u8BE2\u3002"
},
"description": "\u672C\u5361\u91C7\u7528\u5B98\u65B9 Zurich \u6B63\u5411\u5730\u7406\u7F16\u7801 GET \u793A\u4F8B\uFF0C\u670D\u52A1\u80FD\u641C\u7D22\u5730\u540D\u4E0E POI\u3002\u53EF\u76F4\u63A5\u7531\u524D\u540E\u7AEF HTTP \u8C03\u7528\uFF0C\u4E0D\u8981\u6C42\u5B89\u88C5 SDK\uFF1B\u641C\u7D22\u7ED3\u679C\u4E0E\u6807\u7B7E\u53EF\u80FD\u53D7\u7C7B\u578B\u3001\u8BED\u8A00\u3001proximity \u53CA worldview \u8BBE\u7F6E\u5F71\u54CD\uFF0C\u4E0D\u80FD\u5C06\u793A\u4F8B\u5F53\u5F53\u524D\u51C6\u786E\u7ED3\u679C\u3002",
"inputs": [
"query \u5FC5\u586B\u5730\u540D\uFF0C\u53EF\u6DF7\u5408 POI \u7C7B\u522B\u4E0E\u540D\u79F0\uFF1Bbbox \u6309[w,s,e,n]\u4E25\u683C\u9650\u5236\u8303\u56F4\uFF0Cproximity=[lon,lat]\u6216ip\u5F71\u54CD\u6392\u5E8F\u3002",
"\u53EF\u9009 country\u3001language\u3001types\u3001excludeTypes\u3001fuzzyMatch\u3001autocomplete\u3001worldview\uFF1B\u6B63\u5411 limit \u9ED8\u8BA45\u3001\u8303\u56F41\u201310\u3002",
"\u6279\u91CF\u8DEF\u5F84\u4EE5\u672A\u7F16\u7801\u5206\u53F7\u5206\u9694\u6700\u591A50\u4E2A\u67E5\u8BE2\uFF1Bforward\u3001reverse \u6216 feature ID \u53EF\u7EC4\u5408\uFF0C\u4F46\u672C\u5361\u793A\u4F8B\u53EA\u7528\u5355\u6761\u6B63\u5411\u67E5\u8BE2\u3002"
],
"invocation": {
"authentication": {
"kind": "api_key",
"notes": "\u672C\u9875\u660E\u786E\u5FC5\u987B MapTiler API key\uFF0C\u5B98\u65B9 curl \u793A\u4F8B\u7528 key query \u53C2\u6570\uFF1B\u7F3A\u5931\u3001\u65E0\u6548\u6216\u53D7\u9650 key \u8FD4\u56DE403\u3002\u672A\u83B7\u53D6\u6216\u4F7F\u7528\u51ED\u636E\u3002"
},
"command": null,
"entry_url": "https://api.maptiler.com/geocoding/Zurich.json",
"kind": "http_api",
"method": "GET",
"request_example": {
"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"
},
"requirements": [
"\u5177\u5907\u6709\u6548 MapTiler API key\uFF1B\u9ED8\u8BA4 server \u4E3A https://api.maptiler.com\u3002",
"\u67E5\u8BE2\u540D\u79F0\u653E\u5165 /geocoding/{query}.json\uFF1B\u53EF\u76F4\u63A5HTTP\u8C03\u7528\uFF0CSDK\u4E3A\u53EF\u9009\u5DE5\u5177\u3002",
"EU endpoint \u4EC5\u5728\u672C\u9875\u94FE\u63A5\u5230\u53E6\u6587\uFF0C\u672C\u5361\u4E0D\u731C\u5176\u5B8C\u6574\u5730\u5740\u6216\u533A\u57DF\u5904\u7406\u4FDD\u8BC1\u3002",
"\u4E0D\u6CE8\u518C\u3001\u83B7\u53D6key\u3001\u5B89\u88C5SDK\u3001\u8FD0\u884C\u4EA4\u4E92\u6D4B\u8BD5\u6216\u63D0\u4EA4\u771F\u5B9E\u5730\u5740\u3002"
]
},
"limitations": [
"\u8FD4\u56DE feature ID \u4F1A\u5728\u6570\u636E\u5E93\u91CD\u5EFA\u7D22\u5F15\u65F6\u53D8\u5316\uFF0C\u4E0D\u5E94\u89C6\u4E3A\u6C38\u4E45\u7A33\u5B9A\u6807\u8BC6\u3002",
"worldview \u6539\u53D8\u4E89\u8BAE\u5730\u533A\u8FB9\u754C\u3001\u540D\u79F0\u3001\u56FD\u5BB6\u8FC7\u6EE4\u548C context\uFF1B\u9ED8\u8BA4/auto\u884C\u4E3A\u4E0D\u540C\uFF0C\u9700\u6309\u5E94\u7528\u663E\u5F0F\u9009\u62E9\u3002",
"reverse limit\u003E1 \u6709\u5355\u4E00 types \u7B49\u989D\u5916\u8981\u6C42\uFF0C\u4E0D\u80FD\u628A\u6B63\u5411\u53C2\u6570\u89C4\u5219\u65E0\u6761\u4EF6\u63A8\u5E7F\u5230\u53CD\u5411\u67E5\u8BE2\u3002",
"\u672C\u9875\u672A\u7ED9\u6570\u503C\u901F\u7387\u3001\u6708\u989D\u5EA6\u3001\u8D39\u7528\u3001SLA\u6216\u5B8C\u6574\u6570\u636E\u8BB8\u53EF\uFF1B\u8BF7\u6C42/\u4F1A\u8BDD\u4E24\u79CD\u7528\u91CF\u65B9\u5F0F\u4E5F\u9700\u5BF9\u5E94\u8BA1\u8D39\u6587\u6863\u786E\u8BA4\u3002"
],
"outputs": [
"200 \u8FD4\u56DE application/json \u7684 GeoJSON FeatureCollection\uFF1Bfeatures \u542B\u51E0\u4F55\u3001id\u3001\u540D\u79F0\u3001place_type\u3001context \u7B49\uFF0C\u5177\u4F53\u5B57\u6BB5\u4F9D\u7ED3\u679C\u3002",
"\u793A\u4F8B\u6709 query \u548C attribution\uFF1B400 \u8868\u793A\u67E5\u8BE2\u8FC7\u957F/\u53C2\u6570\u65E0\u6548\uFF0C403 \u8868\u793A key \u7F3A\u5931\u3001\u65E0\u6548\u6216\u53D7\u9650\u3002",
"\u6279\u91CF\u8FD4\u56DE\u4E0E\u8F93\u5165\u987A\u5E8F\u5BF9\u5E94\u7684 FeatureCollection \u6570\u7EC4\uFF1B\u4E0D\u662F\u4E00\u4EFD\u5408\u5E76\u540E\u7684\u5730\u56FE\u56FE\u50CF\u3002"
],
"pricing": {
"model": "unknown",
"notes": "\u672C\u9875\u63D0\u5230\u53EF\u6309API requests\u6216SDK sessions\u8FFD\u8E2A\u4F7F\u7528\uFF0C\u4F46\u6CA1\u6709\u8BA1\u5212/\u8D39\u7387\u3001\u514D\u8D39\u989D\u5EA6\u6216\u8D85\u989D\u4EF7\u683C\u6B63\u6587\u3002",
"source_url": "https://docs.maptiler.com/cloud/api/geocoding/"
},
"provider_claimed": false,
"record_kind": "public_source",
"representative_queries": [],
"sources": [
{
"basis": "official_documentation",
"checked_at": "2026-10-25T02:33:56.7408894\u002B08:00",
"title": "Search and geocoding API | MapTiler API | MapTiler",
"url": "https://docs.maptiler.com/cloud/api/geocoding/"
}
],
"summary": "MapTiler \u5B98\u65B9\u5730\u7406\u7F16\u7801 API \u9700 API key\uFF0C\u652F\u6301\u6309\u540D\u79F0\u3001\u5750\u6807\u3001feature ID \u6216\u6279\u91CF\u67E5\u8BE2\uFF0C\u8FD4\u56DE GeoJSON FeatureCollection\u3002\u6B63\u5411\u67E5\u8BE2\u53EF\u6309\u533A\u57DF\u3001\u56FD\u5BB6\u3001\u7C7B\u578B\u548C\u8BED\u8A00\u8FC7\u6EE4\uFF1Blimit\u6700\u591A10\uFF0C\u4EF7\u683C\u3001\u914D\u989D\u53CA\u518D\u5229\u7528\u6761\u6B3E\u672A\u77E5\uFF0C\u672A\u8C03\u7528\u3002",
"tags": [
"http_api",
"documentation_only",
"geocoding",
"geojson"
],
"terms_url": null,
"title": "MapTiler Search and Geocoding API",
"unknowns": [
"\u771F\u5B9Ekey\u6743\u9650\u3001\u8D39\u7528\u3001\u6570\u503C\u9650\u6D41/\u914D\u989D\u3001SLA\u3001\u65E5\u5FD7/\u533A\u57DF\u4FDD\u7559\u653F\u7B56\u4E0E\u518D\u5229\u7528\u8BB8\u53EF\u672A\u77E5\u3002",
"\u5B9E\u9645\u641C\u7D22\u8986\u76D6\u3001\u51C6\u786E\u6027\u3001\u5F53\u524D\u7ED3\u679C\u4E0EEU\u66FF\u4EE3endpoint\u672A\u9A8C\u8BC1\u3002"
],
"verification": {
"checked_at": "2026-10-24T18:33:56.7408894\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://docs.maptiler.com/cloud/api/geocoding/"
],
"level": "documentation_only",
"not_verified": [
"\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
},
"schema_version": "navonavo.capability.v1",
"service_id": "cap-c4e872b044f85e7d9a83cfd8",
"version": 2,
"source_url": "https://docs.maptiler.com/cloud/api/geocoding/",
"ownership_state": "unclaimed",
"submitted_by": {
"kind": "importer",
"name": "NAVONAVO public material importer"
},
"submitter_identity_verified": false,
"source_check": {
"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"
]
},
"created_at": "2026-10-24T18:34:00.7970470\u002B00:00",
"updated_at": "2026-10-24T18:35:00.1129470\u002B00:00",
"read_url": "https://navonavo.com/api/v1/capabilities/cap-c4e872b044f85e7d9a83cfd8?version=2",
"page_url": "https://navonavo.com/capabilities/cap-c4e872b044f85e7d9a83cfd8?version=2",
"verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
"library_material": {
"organization": "organized",
"semantic_state": "classified",
"semantic_category": "\u5730\u7406\u7A7A\u95F4\uFF0FMapTiler \u5730\u540D\u4E0E POI \u5730\u7406\u7F16\u7801",
"evidence_grade": "documentation_only",
"attachments": [
{
"material_id": "material-760615d191d0da0150037e5f85f0a6c0",
"source_url": "https://docs.maptiler.com/cloud/api/geocoding/",
"content_sha256": "3782ff65b5f360ad436eef67a8ac8ce034e7fe14d680fffb6a91e5052d6247fc",
"decoded_bytes": 910443,
"content_type": "text/html",
"captured_at": "2026-10-24T18:33:56.7408894\u002B00:00",
"text_representation": "decoded_text_utf8",
"text_utf8_sha256": "3782ff65b5f360ad436eef67a8ac8ce034e7fe14d680fffb6a91e5052d6247fc",
"text_utf8_bytes": 910443,
"capture_body_reconstructed": true,
"read_path": "/api/v1/capabilities/cap-c4e872b044f85e7d9a83cfd8/materials/material-760615d191d0da0150037e5f85f0a6c0?version=1"
}
]
},
"last_correction": {
"contribution_id": "contribution-9d6078c8eda84fed90aba26b69b08389",
"reason": "\u4F9D\u636E\u672C\u6279 MapTiler Geocoding API \u7684\u660E\u786EHTTPS server/curl\u3001key\u8981\u6C42\u3001\u53C2\u6570\u3001FeatureCollection\u3001\u9519\u8BEF\u7801\u548CfeatureID\u4E0D\u7A33\u5B9A\u8BF4\u660E\u6574\u7406\uFF0C\u79FB\u9664\u672A\u6574\u7406\u6807\u7B7E\u3002\u4EC5documentation_only\uFF0C\u4E0D\u8C03\u7528\u6D4B\u8BD5\u6216\u83B7\u53D6key\uFF1B\u8BA1\u8D39/\u914D\u989D/EU\u5730\u5740\u4FDD\u672A\u77E5\u3002",
"source_urls": [
"https://docs.maptiler.com/cloud/api/geocoding/"
],
"reported_by": "contributor"
},
"version_read_basis": "archived_revision",
"deep_read": {
"schema_version": "navonavo.capability-read.v1",
"card_id": "cap-c4e872b044f85e7d9a83cfd8",
"card_version": 2,
"selected_profile_id": null,
"state": "not_checked",
"review_state": null,
"read_url": "https://navonavo.com/api/v1/capabilities/cap-c4e872b044f85e7d9a83cfd8?version=2",
"page_url": "https://navonavo.com/capabilities/cap-c4e872b044f85e7d9a83cfd8?version=2",
"profiles": [],
"warnings": [
"\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
"\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
]
}
}