Mapbox Geocoding V6 — 地址与坐标转换

官方 API 将地点/地址文本转换为坐标，或将坐标转换为地点与地址；V6 还支持独立批量端点。要求 Mapbox access_token，并有结果存储、地图使用和按请求计量限制；没有进行地理编码或缓存结果。

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-a689b2599aa8a5cf6e09492e
Card version: 2
Updated: 2026-10-24T18:34:31.4359207+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

正向 GET /search/geocode/v6/forward 接收 q 或结构化地址；反向 GET /search/geocode/v6/reverse 接收 longitude/latitude。响应包含标准化地址、地理上下文及坐标，默认 GeoJSON 格式。批量 POST /search/geocode/v6/batch 一次最多包含 1000 项正向/反向查询，响应按查询顺序返回；每项分别计为请求。V6 不再提供 POI 数据，不能当作 Search Box API。数据可能持续更新，接口版本不保证字段值恒定。

Inputs

Mapbox access_token
正向 UTF-8 地址/地名或结构化地址，或反向经度/纬度
可选国家、区域框、语言、worldview、结果类型与存储模式等过滤

Outputs

标准化地址、地理上下文和坐标的地理要素
默认 GeoJSON FeatureCollection；批量响应按查询顺序组织结果，均未实际获取

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "api_key",
    "notes": "\u8BF7\u6C42\u53C2\u6570 access_token \u9700\u8981 Mapbox \u8BBF\u95EE\u4EE4\u724C\uFF1B\u672C\u8F6E\u672A\u8BFB\u53D6\u6216\u914D\u7F6E\u4EE4\u724C\u3002"
  },
  "command": null,
  "entry_url": "https://api.mapbox.com/search/geocode/v6/forward",
  "kind": "http_api",
  "method": "GET",
  "requirements": [
    "Mapbox \u8D26\u6237\u53CA\u6709\u6548 access_token",
    "\u9075\u5B88 Temporary/Permanent \u5B58\u50A8\u548C Mapbox \u5730\u56FE\u4F7F\u7528\u6761\u4EF6",
    "\u6309\u5B9E\u9645\u8D26\u6237\u6838\u5B9E\u8BA1\u8D39\u3001\u9650\u6D41\u53CA\u5730\u5740\u8FC7\u6EE4\u53C2\u6570"
  ]
}

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": "free_tier",
  "notes": "\u6B63\u6587\u8BF4\u660E\u6309\u8BF7\u6C42\u8BA1\u91CF\uFF0C\u5B58\u5728\u514D\u8D39\u5C42\uFF0C\u8D85\u51FA\u540E\u6309\u8BF7\u6C42\u8BA1\u8D39\uFF1B\u514D\u8D39\u6570\u91CF\u548C\u5355\u4EF7\u8F6C\u5F15\u4EF7\u683C\u9875\uFF0C\u5F53\u524D\u6B63\u6587\u672A\u7ED9\u5177\u4F53\u503C\u3002\u6279\u91CF\u5404\u9879\u72EC\u7ACB\u8BA1\u8D39\u3002",
  "source_url": null
}

{
  "location": "provider_server",
  "notes": "\u5730\u5740\u3001\u67E5\u8BE2\u6587\u672C\u6216\u5750\u6807\u53D1\u9001\u81F3 Mapbox\uFF1B\u672C\u8F6E\u672A\u53D1\u9001\u5B9E\u9645\u4F4D\u7F6E\u6570\u636E\u3002Temporary \u4E0D\u5F97\u7F13\u5B58\uFF0CPermanent \u5B58\u50A8\u6709\u989D\u5916\u8D26\u6237\u6761\u4EF6\uFF1B\u670D\u52A1\u7AEF\u4FDD\u7559\u671F\u548C\u9690\u79C1\u7EC6\u5219\u672A\u77E5\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

未请求 API、调用地图、定位用户或保存地理编码结果。
正向 q 不得含分号，解码后最多 20 个词/数字且最多 256 字符。
默认 Temporary 结果不得缓存；Permanent 允许缓存和长期存储，但需账户有效信用卡或企业合同，并显式选择永久模式。
正文规定 Geocoding API 响应只能结合 Mapbox 地图使用，不能据其文档视为无条件开放数据。
默认限流为每分钟 1000 请求，可按账户调整；达到限制会返回 429。
自动补全每次按键可计为一次请求；批量的各项也分别计量。
V6 不含 POI，entrances 为文档所称 Public Preview，不是本轮已验证能力。

Unknowns

当前账户免费量、单价、令牌权限及最终配额未核实。
实际地址覆盖、准确度、客户端显示和中文检索质量未测试。
V6 为 API 版本，不是已安装软件版本；未验证任何组合工作流。

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:29.6892658\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://docs.mapbox.com/api/search/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": null,
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u5730\u5740\u3001\u67E5\u8BE2\u6587\u672C\u6216\u5750\u6807\u53D1\u9001\u81F3 Mapbox\uFF1B\u672C\u8F6E\u672A\u53D1\u9001\u5B9E\u9645\u4F4D\u7F6E\u6570\u636E\u3002Temporary \u4E0D\u5F97\u7F13\u5B58\uFF0CPermanent \u5B58\u50A8\u6709\u989D\u5916\u8D26\u6237\u6761\u4EF6\uFF1B\u670D\u52A1\u7AEF\u4FDD\u7559\u671F\u548C\u9690\u79C1\u7EC6\u5219\u672A\u77E5\u3002"
  },
  "description": "\u6B63\u5411 GET /search/geocode/v6/forward \u63A5\u6536 q \u6216\u7ED3\u6784\u5316\u5730\u5740\uFF1B\u53CD\u5411 GET /search/geocode/v6/reverse \u63A5\u6536 longitude/latitude\u3002\u54CD\u5E94\u5305\u542B\u6807\u51C6\u5316\u5730\u5740\u3001\u5730\u7406\u4E0A\u4E0B\u6587\u53CA\u5750\u6807\uFF0C\u9ED8\u8BA4 GeoJSON \u683C\u5F0F\u3002\u6279\u91CF POST /search/geocode/v6/batch \u4E00\u6B21\u6700\u591A\u5305\u542B 1000 \u9879\u6B63\u5411/\u53CD\u5411\u67E5\u8BE2\uFF0C\u54CD\u5E94\u6309\u67E5\u8BE2\u987A\u5E8F\u8FD4\u56DE\uFF1B\u6BCF\u9879\u5206\u522B\u8BA1\u4E3A\u8BF7\u6C42\u3002V6 \u4E0D\u518D\u63D0\u4F9B POI \u6570\u636E\uFF0C\u4E0D\u80FD\u5F53\u4F5C Search Box API\u3002\u6570\u636E\u53EF\u80FD\u6301\u7EED\u66F4\u65B0\uFF0C\u63A5\u53E3\u7248\u672C\u4E0D\u4FDD\u8BC1\u5B57\u6BB5\u503C\u6052\u5B9A\u3002",
  "inputs": [
    "Mapbox access_token",
    "\u6B63\u5411 UTF-8 \u5730\u5740/\u5730\u540D\u6216\u7ED3\u6784\u5316\u5730\u5740\uFF0C\u6216\u53CD\u5411\u7ECF\u5EA6/\u7EAC\u5EA6",
    "\u53EF\u9009\u56FD\u5BB6\u3001\u533A\u57DF\u6846\u3001\u8BED\u8A00\u3001worldview\u3001\u7ED3\u679C\u7C7B\u578B\u4E0E\u5B58\u50A8\u6A21\u5F0F\u7B49\u8FC7\u6EE4"
  ],
  "invocation": {
    "authentication": {
      "kind": "api_key",
      "notes": "\u8BF7\u6C42\u53C2\u6570 access_token \u9700\u8981 Mapbox \u8BBF\u95EE\u4EE4\u724C\uFF1B\u672C\u8F6E\u672A\u8BFB\u53D6\u6216\u914D\u7F6E\u4EE4\u724C\u3002"
    },
    "command": null,
    "entry_url": "https://api.mapbox.com/search/geocode/v6/forward",
    "kind": "http_api",
    "method": "GET",
    "requirements": [
      "Mapbox \u8D26\u6237\u53CA\u6709\u6548 access_token",
      "\u9075\u5B88 Temporary/Permanent \u5B58\u50A8\u548C Mapbox \u5730\u56FE\u4F7F\u7528\u6761\u4EF6",
      "\u6309\u5B9E\u9645\u8D26\u6237\u6838\u5B9E\u8BA1\u8D39\u3001\u9650\u6D41\u53CA\u5730\u5740\u8FC7\u6EE4\u53C2\u6570"
    ]
  },
  "limitations": [
    "\u672A\u8BF7\u6C42 API\u3001\u8C03\u7528\u5730\u56FE\u3001\u5B9A\u4F4D\u7528\u6237\u6216\u4FDD\u5B58\u5730\u7406\u7F16\u7801\u7ED3\u679C\u3002",
    "\u6B63\u5411 q \u4E0D\u5F97\u542B\u5206\u53F7\uFF0C\u89E3\u7801\u540E\u6700\u591A 20 \u4E2A\u8BCD/\u6570\u5B57\u4E14\u6700\u591A 256 \u5B57\u7B26\u3002",
    "\u9ED8\u8BA4 Temporary \u7ED3\u679C\u4E0D\u5F97\u7F13\u5B58\uFF1BPermanent \u5141\u8BB8\u7F13\u5B58\u548C\u957F\u671F\u5B58\u50A8\uFF0C\u4F46\u9700\u8D26\u6237\u6709\u6548\u4FE1\u7528\u5361\u6216\u4F01\u4E1A\u5408\u540C\uFF0C\u5E76\u663E\u5F0F\u9009\u62E9\u6C38\u4E45\u6A21\u5F0F\u3002",
    "\u6B63\u6587\u89C4\u5B9A Geocoding API \u54CD\u5E94\u53EA\u80FD\u7ED3\u5408 Mapbox \u5730\u56FE\u4F7F\u7528\uFF0C\u4E0D\u80FD\u636E\u5176\u6587\u6863\u89C6\u4E3A\u65E0\u6761\u4EF6\u5F00\u653E\u6570\u636E\u3002",
    "\u9ED8\u8BA4\u9650\u6D41\u4E3A\u6BCF\u5206\u949F 1000 \u8BF7\u6C42\uFF0C\u53EF\u6309\u8D26\u6237\u8C03\u6574\uFF1B\u8FBE\u5230\u9650\u5236\u4F1A\u8FD4\u56DE 429\u3002",
    "\u81EA\u52A8\u8865\u5168\u6BCF\u6B21\u6309\u952E\u53EF\u8BA1\u4E3A\u4E00\u6B21\u8BF7\u6C42\uFF1B\u6279\u91CF\u7684\u5404\u9879\u4E5F\u5206\u522B\u8BA1\u91CF\u3002",
    "V6 \u4E0D\u542B POI\uFF0Centrances \u4E3A\u6587\u6863\u6240\u79F0 Public Preview\uFF0C\u4E0D\u662F\u672C\u8F6E\u5DF2\u9A8C\u8BC1\u80FD\u529B\u3002"
  ],
  "outputs": [
    "\u6807\u51C6\u5316\u5730\u5740\u3001\u5730\u7406\u4E0A\u4E0B\u6587\u548C\u5750\u6807\u7684\u5730\u7406\u8981\u7D20",
    "\u9ED8\u8BA4 GeoJSON FeatureCollection\uFF1B\u6279\u91CF\u54CD\u5E94\u6309\u67E5\u8BE2\u987A\u5E8F\u7EC4\u7EC7\u7ED3\u679C\uFF0C\u5747\u672A\u5B9E\u9645\u83B7\u53D6"
  ],
  "pricing": {
    "model": "free_tier",
    "notes": "\u6B63\u6587\u8BF4\u660E\u6309\u8BF7\u6C42\u8BA1\u91CF\uFF0C\u5B58\u5728\u514D\u8D39\u5C42\uFF0C\u8D85\u51FA\u540E\u6309\u8BF7\u6C42\u8BA1\u8D39\uFF1B\u514D\u8D39\u6570\u91CF\u548C\u5355\u4EF7\u8F6C\u5F15\u4EF7\u683C\u9875\uFF0C\u5F53\u524D\u6B63\u6587\u672A\u7ED9\u5177\u4F53\u503C\u3002\u6279\u91CF\u5404\u9879\u72EC\u7ACB\u8BA1\u8D39\u3002",
    "source_url": null
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "public_record",
      "checked_at": "2026-10-24T18:33:29.6892658\u002B00:00",
      "title": "Geocoding API | API Docs | Mapbox",
      "url": "https://docs.mapbox.com/api/search/geocoding/"
    }
  ],
  "summary": "\u5B98\u65B9 API \u5C06\u5730\u70B9/\u5730\u5740\u6587\u672C\u8F6C\u6362\u4E3A\u5750\u6807\uFF0C\u6216\u5C06\u5750\u6807\u8F6C\u6362\u4E3A\u5730\u70B9\u4E0E\u5730\u5740\uFF1BV6 \u8FD8\u652F\u6301\u72EC\u7ACB\u6279\u91CF\u7AEF\u70B9\u3002\u8981\u6C42 Mapbox access_token\uFF0C\u5E76\u6709\u7ED3\u679C\u5B58\u50A8\u3001\u5730\u56FE\u4F7F\u7528\u548C\u6309\u8BF7\u6C42\u8BA1\u91CF\u9650\u5236\uFF1B\u6CA1\u6709\u8FDB\u884C\u5730\u7406\u7F16\u7801\u6216\u7F13\u5B58\u7ED3\u679C\u3002",
  "tags": [
    "Mapbox",
    "\u5730\u7406\u7F16\u7801",
    "\u5730\u5740",
    "\u5750\u6807",
    "GeoJSON"
  ],
  "terms_url": null,
  "title": "Mapbox Geocoding V6 \u2014 \u5730\u5740\u4E0E\u5750\u6807\u8F6C\u6362",
  "unknowns": [
    "\u5F53\u524D\u8D26\u6237\u514D\u8D39\u91CF\u3001\u5355\u4EF7\u3001\u4EE4\u724C\u6743\u9650\u53CA\u6700\u7EC8\u914D\u989D\u672A\u6838\u5B9E\u3002",
    "\u5B9E\u9645\u5730\u5740\u8986\u76D6\u3001\u51C6\u786E\u5EA6\u3001\u5BA2\u6237\u7AEF\u663E\u793A\u548C\u4E2D\u6587\u68C0\u7D22\u8D28\u91CF\u672A\u6D4B\u8BD5\u3002",
    "V6 \u4E3A API \u7248\u672C\uFF0C\u4E0D\u662F\u5DF2\u5B89\u88C5\u8F6F\u4EF6\u7248\u672C\uFF1B\u672A\u9A8C\u8BC1\u4EFB\u4F55\u7EC4\u5408\u5DE5\u4F5C\u6D41\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T18:33:29.6892658\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://docs.mapbox.com/api/search/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-a689b2599aa8a5cf6e09492e",
  "version": 2,
  "source_url": "https://docs.mapbox.com/api/search/geocoding/",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://docs.mapbox.com/api/search/geocoding/",
    "final_url": "https://docs.mapbox.com/api/search/geocoding/",
    "status_code": 200,
    "title": "Geocoding API | API Docs | Mapbox",
    "description": null,
    "checked_at": "2026-10-24T18:33:29.6892658\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:33:33.4356384\u002B00:00",
  "updated_at": "2026-10-24T18:34:31.4359207\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-a689b2599aa8a5cf6e09492e?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-a689b2599aa8a5cf6e09492e?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\u5740\u4E0E\u5750\u6807\u5730\u7406\u7F16\u7801 API",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-2b8342dc05e79e6ceacc74b0477cccf8",
        "source_url": "https://docs.mapbox.com/api/search/geocoding/",
        "content_sha256": "50e33ba0b85f47ec151c18ae29e3621bc5b7c61db0df3dc03eb2a8358923160e",
        "decoded_bytes": 462892,
        "content_type": "text/html",
        "captured_at": "2026-10-24T18:33:29.6892658\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "50e33ba0b85f47ec151c18ae29e3621bc5b7c61db0df3dc03eb2a8358923160e",
        "text_utf8_bytes": 462892,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-a689b2599aa8a5cf6e09492e/materials/material-2b8342dc05e79e6ceacc74b0477cccf8?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-3fa35ae1031647ce884a458f2486ad3f",
    "reason": "\u4EC5\u4F9D\u636E\u672C\u6B21\u5DF2\u4FDD\u5B58\u5B98\u65B9\u516C\u5F00\u6B63\u6587\u6574\u7406\u7528\u9014\u3001\u5165\u53E3\u3001\u6761\u4EF6\u548C\u672A\u77E5\u9879\uFF1B\u4FDD\u7559\u539F\u6587\u8BC1\u636E\uFF0C\u4E0D\u5C06\u8BF4\u660E\u6587\u6863\u5192\u5145\u5B9E\u9645\u63A5\u901A\u3001\u529F\u80FD\u5B9E\u6D4B\u6216\u53EF\u7528\u6027\u4FDD\u8BC1\u3002",
    "source_urls": [
      "https://docs.mapbox.com/api/search/geocoding/"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-a689b2599aa8a5cf6e09492e",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-a689b2599aa8a5cf6e09492e?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-a689b2599aa8a5cf6e09492e?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"
    ]
  }
}

Submit another public source · Privacy and disclosure