一、申请高德开放平台账号
- 访问 https://console.amap.com/,使用支付宝/淘宝账号登录。
- 首次进入会提示完善开发者信息(实名认证、邮箱、手机号等)。
- 进入"应用管理" → "我的应用",点击"创建新应用"。
一个应用下可以添加多个 Key(JS API、Web 服务 API 等),它们共享同一个账号配额。
二、Web Key 与 SecretKey(前端地图)
前端地图加载需要填写 Web Key(JS API Key) 与 SecretKey(securityJsCode) 两个字段,二者来自同一个 JS API Key。
- 在"我的应用"中点击目标应用右上角的"+添加Key"。
- Key 名称:填写一个易识别的名字(例如"路线规划-前端JS")。
- 服务平台:选择 "Web端(JS API)"。
- 提交后,复制该 Key 的字符串,粘贴到个人设置「高德地图API_KEY」下的 Web Key(JS API Key)。
- 在同一行右侧找到"安全密钥(securityJsCode)",点击"查看"后复制,粘贴到 SecretKey(securityJsCode)。
三、Api Key(REST 服务)
Api Key 用于调用 REST 接口(路径规划、地理编码等),对应的服务平台是"Web服务"。
- 在同一个或新建应用下,再次点击"+添加Key"。
- Key 名称:建议命名为"路线规划-Web服务"。
- 服务平台:选择 "Web服务"。
- IP 白名单:可留空或填写你服务器出口 IP;生产环境建议填写以提高安全性。
- 提交后,复制该 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服务)必须分别申请,混用会直接报类型不匹配。