为什么需要配置高德地图Key？
做外卖和跑腿生意，位置信息是核心中的核心。用户下单时需要定位到具体地址，骑手配送时需要导航到目的地，商家需要知道服务覆盖的范围——这些功能都依赖地图服务的支撑。
海狐外卖系统接入了高德地图能力，通过配置高德地图Key，您的平台就能实现：
- 用户端定位：顾客打开小程序时自动获取当前位置，快速匹配附近商家
- 地址解析：用户输入模糊地址时，系统自动补全为标准地址
- 配送导航：骑手接单后直接调用高德导航，不走弯路
- 距离计算：自动计算商家与用户的距离，匹配合理的配送费
- 配送范围：基于地图绘制配送区域，一目了然
如果您的后台还没有配置高德地图Key，这些功能要么无法使用，要么会报错。这篇教程就是帮您一步步完成配置。
第一步：注册并实名认证高德开放平台账号
1.1 登录高德开放平台
打开浏览器，访问高德地图开放平台官网：
点击右上角「登录/注册」，使用手机号或支付宝账号完成注册。
1.2 完成实名认证
注册后需要进行实名认证才能创建应用和获取Key。系统测试、演示或学习用途，建议选择「个人认证」，免费且审核快。
如果您已经是商业运营阶段，平台用户体量较大，建议使用「企业认证」，功能权限更完整。需要注意的是，企业认证涉及授权费用（约5万/年），建议根据实际业务阶段选择。
[实名认证操作示意图]
第二步：创建应用
认证通过后，进入控制台首页，找到「应用管理」→「我的应用」，点击「创建新应用」。
2.1 填写应用信息
- 应用名称：可以填写您的平台名称，比如”海狐外卖平台”，这个名称仅用于您自己区分管理，不影响实际功能
- 应用类型：选择「出行」或「生活服务」均可
填写完成后点击提交，应用就创建好了。
第三步：添加Web端（JS API）Key
这是用于用户端小程序和H5页面定位展示的核心Key。
3.1 添加Key
在刚才创建的应用详情页，点击「添加Key」，按以下方式配置：
| 配置项 | 填写内容 |
|---|---|
| Key名称 | 自定义，如”海狐Web端” |
| 服务平台 | 选择「Web端(JS API)」 |
| 域名白名单 | 填写您平台的域名 |
3.2 域名白名单填写规则
域名白名单决定了哪些网站可以调用这个Key，填错会导致地图无法正常加载。请根据您的部署方式填写：
- SaaS版本用户：请联系技术支持获取当前分配的域名
- 独立部署用户：填写您自己的域名，例如：
www.yourdomain.com
注意：如果您暂时不确定域名，可以先不填白名单（留空表示不限制），但正式上线前建议补充完整，避免Key被他人盗用。
3.3 记录Web端Key和安全密钥
添加成功后，系统会生成两个重要参数，请务必复制保存下来：
- Key：一串字母数字组合，如
2e8f2d9d6ff56ea109786757aa0 - 安全密钥：配合Key使用，增强安全性
第四步：添加Web服务Key
除了Web端Key，还需要创建一个「Web服务」类型的Key，用于后台服务端的地址解析、距离计算等接口调用。
4.1 添加Web服务Key
同样在应用详情页，点击「添加Key」：
| 配置项 | 填写内容 |
|---|---|
| Key名称 | 自定义，如”海狐Web服务” |
| 服务平台 | 选择「Web服务」 |
| IP白名单 | 建议留空（不限制） |
为什么IP白名单建议留空？ 因为独立部署的服务器IP可能变动，SaaS版则是多服务器集群，限制IP反而会导致接口调用失败。
4.2 记录Web服务Key
添加成功后，复制并保存Web服务的Key字符串。
至此，您需要保存的凭证共有三项：
- Web端Key（用于前端地图展示）
- 安全密钥（配合Web端Key使用）
- Web服务Key（用于后端接口调用）
第五步：在海狐后台配置高德Key
拿到上述三个参数后，登录海狐外卖系统的总后台，进入「系统设置」→「地图设置」（具体路径可能因版本略有不同，通常在「基础配置」或「第三方服务」分类下）。
将刚才获取的三个参数分别填入对应输入框：
| 配置项 | 填入内容 |
|---|---|
| 高德地图Web端Key | 第三步获取的Key |
| 高德安全密钥 | 第三步获取的安全密钥 |
| 高德Web服务Key | 第四步获取的Key |
填写完成后，点击「保存」。
5.1 验证配置是否生效
保存后，打开用户端小程序或H5页面，尝试以下操作验证：
- 首页是否能自动定位到当前城市
- 选择收货地址时，地址联想是否正常工作
- 下单页面的地图展示是否正常
如果以上功能都能正常使用，说明配置成功。
常见问题（FAQ）
Q1：配置完Key后，小程序还是定位失败，显示”定位获取失败”？
首先检查Key是否复制完整、有没有多余的空格。其次检查域名白名单是否包含了当前小程序使用的域名。最后，确认高德账号的实名认证是否已通过——未认证或认证审核中的账号，Key权限可能受限。
Q2：个人认证和企业认证有什么区别？
个人认证免费，适合测试、演示和初期小规模运营，但调用量有日限额。企业认证需要付费，调用额度更高，且支持更多高级功能（如路径规划、批量计算等）。初期使用个人认证完全够用，等业务量上来后再升级即可。
Q3：一个高德账号可以给多个平台用吗？
可以。一个高德开放平台账号下可以创建多个应用，每个应用下又可以添加多个Key。如果您同时运营多个区域或品牌，建议每个平台单独创建应用和Key，方便管理和排查问题。
Q4：Key泄露了怎么办？
如果发现Key被他人盗用，可以立即进入高德控制台，在Key详情页点击「删除」或「禁用」，然后重新创建一个新的Key并更新到海狐后台。建议定期检查Key的调用量，如果某天的调用量异常偏高，可能是被盗用了。
Q5：为什么需要配置两个Key，一个不够吗？
Web端JS API Key和Web服务Key的使用场景和技术协议不同。Web端Key用于小程序/H5页面中直接调用地圖组件展示，而Web服务Key用于服务器后台调用地址解析、距离计算等HTTP接口。两者各司其职，缺一不可。
相关功能推荐
地图Key配置完成后，您可以继续配置以下关联功能，进一步提升用户体验：
- 【配送范围设置】 —— 在地图上绘制每个商家的配送区域，超出范围的顾客自动提示”不在配送范围内”
- 【骑手导航】 —— 骑手端支持一键唤起高德导航，无需手动输入地址
- 【预计送达时间】 —— 基于距离和路况自动计算预计送达时间，提升用户信任感
地图是整个外卖配送系统的”眼睛”，配置好了，订单流转才会顺畅。如果在配置过程中遇到任何问题，欢迎联系海狐科技技术支持获取帮助。