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