地理编码与逆地理编码
将结构化地址解析为高德坐标与行政区信息，或按坐标返回地址和周边 POI，适合地址补全与门店定位。
接入要求使用 Web 服务 Key，输入完整地址；经纬度使用高德坐标。地理编码暂不支持台湾省详细地址返回，不能据此承诺全球地址覆盖。
把地址转成坐标并反查地址站内调用手册 · 参数、代码与排错开发与云服务 / AMap Web Service API
高德开放平台
通过高德 Web 服务 API 把结构化地址转成经纬度、反查地点、搜索 POI 并计算驾车或步行等路线，适合门店查询、地址录入、位置工具和出行应用。本条目聚焦服务端 HTTP 接口，地图展示、定位 SDK、导航 SDK 需按各端产品另行接入。
01 / CAPABILITIES
开放功能
核心接口调用手册
2 个场景覆盖地址解析与逆查、v5 驾车路线规划两个场景，共三个操作。提供请求、参数、返回结构和错误处理；服务端 Web 服务 Key 与 GCJ-02 坐标必须匹配，未包含导航 SDK 和数字签名生成。
路径规划 2.0
计算驾车、步行、骑行和公交等路线；驾车可选推荐、避拥堵、少收费等策略，并按 show_fields 返回耗时、费用和路径点。
接入要求起终点须为高德经纬度，顺序为经度在前；各交通方式参数不同，货车和高级规划需按对应产品核对。
规划驾车路线并读取耗时站内调用手册 · 参数、代码与排错POI 地点搜索
按关键词、周边或区域查找地点，取得名称、地址、坐标及所选扩展信息，构建附近门店与目的地检索。
接入要求按搜索 API 2.0 配置服务权限和筛选参数；这类调用属于基础搜索服务组，与地理编码的 LBS 服务组分别统计额度。
坐标体系转换
把 GPS、百度或图吧坐标转换成高德坐标，使外部采集的位置与高德地图及路线接口匹配。
接入要求明确原始 coordsys，最多一次传 40 对坐标；已是高德 GCJ-02 坐标不要重复偏移，不提供任意坐标系双向转换保证。
02 / REQUIREMENTS
接入条件
- 适用主体
- 位置服务与门店工具开发者、地址录入和履约系统团队、出行与地图应用开发者
- 接入方式
- Web 服务类型 API Key，通过请求参数 key 传入 / Key 可配 IP 白名单；启用数字签名后按官方规则提供 sig
- 申请概况
- 注册认证开发者并申请 Web 服务类型 Key；个人研究学习与商业用途适用不同许可及收费条件。
- 注册高德开放平台账号并完成适用的开发者认证；企业商业项目先核对服务协议、技术服务许可与实际主体。
- 在控制台应用管理创建应用，添加 Key 时服务平台选择 Web 服务；JavaScript API、Android 或 iOS 的 Key 不可混用于本页 REST 接口。
- Web 服务 Key 留在服务端，配置固定出口 IP 白名单；若启用数字签名，还必须依官方算法计算 sig，本站最小请求不包含签名生成。
- 坐标统一为 GCJ-02 高德坐标，按经度,纬度传入；外部 WGS-84/GPS、百度坐标先使用官方坐标转换能力处理。
- 商业用途并不只指向用户收费。官方协议涵盖内部管理系统、受托开发等直接或间接收益场景；为第三方开发时，开发方及系统运营方的许可义务须分别核对。
03 / GET STARTED
开通步骤
- 01
判断用途和许可主体
先区分个人研究学习与商业项目；企业运营、内部系统、受托开发按协议办理技术服务许可，不用免费 Key 代替商业许可。
- 02
申请正确类型的 Key
控制台 → 应用管理创建应用并添加 Web 服务 Key，记录启用的服务、IP 白名单和签名配置。
- 03
从地址解析开始
在服务器设置 AMAP_KEY，先用普通公开地址核对返回的 status、count、level 和 location，再把高德坐标用于路线规划。
- 04
监控共享配额和并发
分别看 LBS、搜索等服务组的月配额和各项 QPS，业务增加时购买相应用量或并发；不在客户端暴露服务端 Key。
04 / COSTS & LIMITS
费用、边界与测试方式
费用概况
按免费期限、商业许可、调用流量与并发四项核算；不沿用旧版日配额。
- 官方 2025 年 5 月 20 日起的新定价采用服务组月配额。非商业用途个人认证开发者，以及经评估符合非商业用途的企业，可在自注册认证起 1 年享受所列免费月配额；不表述为长期免费。
- 个人非商业免费期内，基础 LBS 服务每月 150,000 次、基础搜索每月 5,000 次；企业对应额度不同。地理编码、路线规划和坐标转换共同消耗 LBS 服务组额度。
- 公开基础调用价中，LBS 与搜索服务均为 30 元/万次，基础地图定位为 3 元/万次；流量包有效期 1 年，适用折扣和实际订单价格以购买页为准。
- 商业项目的技术服务许可独立于流量包。公开页面基础版为 50,000 元/年、高级版 100,000 元/年，随许可提供的基础服务配额与个人免费期不同；定向邀请的乘风计划不能作为所有企业的免费资格。
- 月调用量与并发分开。QPS 升级需逐服务购买，公开范围为 400–1,500 元/月/10 QPS，账号下全部 Key 共用该服务 QPS。未登录核对特定账户的当前额度与折扣。
使用范围与限制
- 普通地理编码与路径规划不是全球服务承诺；世界地图、货车、高级路径规划等产品的范围和开通条件不能套用到本条目。
- 高德使用 GCJ-02；WGS-84 或 BD-09 坐标直接代入可能产生偏移，不能只互换经纬度解决。
- HTTP 成功返回不等于业务成功；需检查 status、infocode 和 info，status=1 时仍需处理零结果和匹配级别不足。
- 服务配额由同服务组的多个 API、SDK 共享；多个 Key 不会为同账号复制出多份配额或 QPS。
- 接口结果的展示、留存、再分发及与其他数据混用须遵守服务协议和授权范围；本站不据公开接口推断可建立或转售地图数据库。
如何进行开发测试
- 正式 REST 域名为 restapi.amap.com；示例请求会消耗目标账号实际服务配额，未确认统一隔离沙箱。
- 测试和生产建议分别管理 Key 与 IP 范围，但同账号的服务组配额及 QPS 仍共享。
- 本次未注册认证、申请 Key、开通商业许可、购买流量或执行真实 API 调用。
接入前再确认
- 采用当前 Web 服务 v3 地理编码和 v5 路径规划；不把旧版路线参数混入 v5。
- 价格、免费期和许可来自当前公开页，个人及企业实际可用资格、QPS 和合同价格未登录确认。
- 地理编码文档 developer 子域读取异常时，读取其官方 lbs.amap.com 对应页面核对。
05 / OFFICIAL SOURCES
官方资料
以下资料用于核对本页内容。申请与使用时，请以对应接口的最新规则为准。
- 01地理与逆地理编码 API已核对官方资料 · 2026-10-15
- 02路径规划 2.0：v5 驾车、步行等接口已核对官方资料 · 2026-10-15
- 03搜索 POI 2.0已核对官方资料 · 2026-10-15
- 04坐标转换 API已核对官方资料 · 2026-10-15
- 05官方坐标系说明：GCJ-02已核对官方资料 · 2026-10-15
- 06创建应用与 Web 服务 Key已核对官方资料 · 2026-10-15
- 07Web 服务错误码说明已核对官方资料 · 2026-10-15
- 08产品定价、共享月配额与技术服务许可已核对官方资料 · 2026-10-15
- 09高德开放平台服务协议与商业用途许可已核对官方资料 · 2026-10-15
- 10基础服务调整与取消旧日配额公告已核对官方资料 · 2026-10-15
- 11高德开放平台控制台官方入口 · 细则待复核 · 2026-10-15
官方文档核对，未进行接口实测
最近核验 2026-10-15 · 查看核验说明
最近核验 2026-10-15 · 查看核验说明
