帮助中心 · 高德地图 API_KEY 获取说明

本页面说明如何申请和配置个人设置中「高德地图API_KEY」所需的三个 Key。

一、申请高德开放平台账号

  1. 访问 https://console.amap.com/,使用支付宝/淘宝账号登录。
  2. 首次进入会提示完善开发者信息(实名认证、邮箱、手机号等)。
  3. 进入"应用管理" → "我的应用",点击"创建新应用"。
一个应用下可以添加多个 Key(JS API、Web 服务 API 等),它们共享同一个账号配额。

二、Web Key 与 SecretKey(前端地图)

前端地图加载需要填写 Web Key(JS API Key) 与 SecretKey(securityJsCode) 两个字段,二者来自同一个 JS API Key。

  1. 在"我的应用"中点击目标应用右上角的"+添加Key"。
  2. Key 名称:填写一个易识别的名字(例如"路线规划-前端JS")。
  3. 服务平台:选择 "Web端(JS API)"。
  4. 提交后,复制该 Key 的字符串,粘贴到个人设置「高德地图API_KEY」下的 Web Key(JS API Key)。
  5. 在同一行右侧找到"安全密钥(securityJsCode)",点击"查看"后复制,粘贴到 SecretKey(securityJsCode)。

三、Api Key(REST 服务)

Api Key 用于调用 REST 接口(路径规划、地理编码等),对应的服务平台是"Web服务"。

  1. 在同一个或新建应用下,再次点击"+添加Key"。
  2. Key 名称:建议命名为"路线规划-Web服务"。
  3. 服务平台:选择 "Web服务"。
  4. IP 白名单:可留空或填写你服务器出口 IP;生产环境建议填写以提高安全性。
  5. 提交后,复制该 Key 字符串,粘贴到个人设置「高德地图API_KEY」下的 Api Key。

四、个人设置中填写位置

打开应用右上角头像 → 个人设置,在 高德地图API_KEY: 下依次填写以下三个字段:

  • Web Key(JS API Key):对应服务平台为"Web端(JS API)"的 Key,用于前端地图展示。
  • SecretKey(securityJsCode):对应同一个 JS API Key 下的"安全密钥",与 Web Key 配套使用。
  • Api Key:对应服务平台为"Web服务"的 Key,用于 REST 接口调用。

五、常见问题

  • 地图显示空白?请先检查 Web Key 与 SecretKey 是否同时填写并正确保存,刷新页面重试。
  • Key 能否给多端共用?不能,Web Key(JS API)与 Api Key(Web服务)必须分别申请,混用会直接报类型不匹配。