高德地图

高德地图配置指南

完成地图服务配置后，即可在系统中使用地理位置相关功能（如定位、地图展示等）。

一、注册高德地图账号

访问高德开放平台并完成账号注册：

👉 https://lbs.amap.com/

二、创建应用并申请 Key

登录后，进入控制台创建应用并获取 Key 与安全密钥（Secret Key）。

操作步骤

  1. 创建应用
  2. 添加 Key
  3. 配置服务类型（建议选择 Web 端 JS API）

如下图所示：

图片

图片

图片

三、系统中配置 Key

将获取到的 Key 与 安全密钥（Secret Key） 填入系统对应配置项中。

配置完成后，请刷新或重启浏览器使配置生效。

图片

四、调用额度说明

高德地图提供免费调用额度，但存在一定限制。 具体配额及计费规则，请以高德官方说明为准。

五、代码方式配置（适用于无界面版本）

若当前版本不支持界面化配置，可通过代码方式完成 Key 配置：

  1. 打开项目中的 amap.js 文件
  2. 将文件中标注位置替换为您的 Key 与安全密钥

示意如下：

图片

六、常见问题（FAQ）

1. Key 配置后不生效？

可能原因：

  • 未刷新或重启浏览器
  • Key 或安全密钥填写错误
  • 浏览器缓存未更新

建议排查：

  • 确认 Key / Secret Key 是否完整复制
  • 清除浏览器缓存或强制刷新（Ctrl + F5）
  • 检查控制台是否有报错信息

2. 提示 Key 无效或请求被拒绝？

可能原因：

  • Key 未启用对应服务（如未开通 JS API）
  • Key 被限制访问来源（Referer 白名单）
  • Key 填写错误或已失效

解决方案：

  • 登录高德控制台，确认 Key 已启用 Web端（JS API）服务
  • 检查“安全设置”中的 Referer 限制
    • 若配置了域名白名单，请确保当前访问域名在允许范围内
  • 临时排查可先关闭 Referer 限制（不建议长期关闭）

3. 地图加载失败或显示异常？

可能原因：

  • 网络问题或高德服务不可达
  • Key 超出调用额度
  • JS 资源加载失败

建议排查：

  • 打开浏览器开发者工具（F12），查看 Network / Console 报错
  • 检查是否有 INVALID_USER_KEY、OVER_QUOTA 等提示
  • 确认 Key 未超过调用配额

4. 超出调用额度怎么办？

高德地图免费额度存在上限，超出后会影响正常使用。

解决方案：

  • 登录高德开放平台查看当前配额使用情况
  • 根据业务需求升级为付费套餐
  • 优化调用频率，避免重复请求