API 文档
API 文档中心
地图帮 GeoAPI 共 11 个接口、5 个能力分类，覆盖地理编码、POI/AOI 检索、路径规划、行政区划，以及自有城市/行业数据查询。所有接口通过 HTTP/HTTPS 调用，统一使用 API Key 鉴权、按接口独立计费。
三步开始调用
2
携带 API Key 请求
在 Header 加 X-API-Key，按接口文档拼接请求 URL。
3
解析返回
读取统一 JSON 信封中的 data 与 quota_remaining。
鉴权与流量豆
所有需鉴权的接口在 Header 携带 X-API-Key: 你的API-Key。系统按接口消耗流量豆，调用成功扣减对应流量豆、失败不扣；流量豆不足返回 429，未开通接口返回 403。速率限制默认 60 秒 200 次。
错误码总览
| HTTP | 含义 | 常见原因 |
|---|---|---|
200 | 成功 | 请求正常处理 |
400 | 参数错误 | 缺少必填参数、格式不合法 |
401 | 鉴权失败 | API Key 缺失 / 不存在 / 停用 / 过期 |
403 | 权限不足 | API Key 未开通该接口 |
429 | 流量豆不足 / 限流 | 流量豆用完或超出速率 |
503 | 服务暂时不可用 | 服务暂时异常 |
地址解析
地址与经纬度互转，支持全国地址解析
路径规划
驾车、步行、骑行、公交多种出行方式路径规划
POI 检索
POI 关键词、区域检索
区域边界与行政区划
AOI 边界数据、行政区划查询
其他接口
未归类接口