地图接口申请与配置

一、地图的用途

地图用于商家位置标注与信息位置展示，配置保存在 kf_map_config 表中。地图密钥在 后台 → 网站设置 → 地图设置 中填写，并选择使用百度地图或腾讯地图。

两家的密钥互不通用，切换地图类型后必须改成对应平台的密钥，否则前台地图区域会一直空白。填写保存后先清空模板缓存，再刷新前台确认效果。

二、百度地图 AK 申请

1. 登录百度地图开放平台，进入控制台，点击创建应用；
2. 应用类型选择「浏览器端」，启用服务保持默认；
3. Referer 白名单填写 *.你的域名*，不填会导致前台因来源校验失败而不显示地图；
4. 提交后复制生成的 AK，填入后台地图设置。

三、腾讯地图 KEY 申请

1. 登录腾讯位置服务控制台，在「应用管理 → 我的应用」中添加应用；
2. 在应用下添加 KEY，启用产品勾选「WebServiceAPI」与「域名白名单」，白名单留空；
3. 进入「配额管理 → 账户额度」，对该 KEY 执行一键分配；
4. 复制 KEY 填入后台地图设置。

未分配额度的 KEY 调用会失败，这一步最容易被漏掉。

四、生效检查

保存后打开一个带地址的信息详情页与一个商家页，确认地图能正常加载、标注点位置正确。

# 若前台地图空白，先确认页面已经引用了地图脚本
grep -rn "map" template/pc/info/ template/wap/info/ | head

若地图为空白，查看浏览器控制台是否提示密钥无效、来源未授权或配额超限。

五、常见问题

• 域名白名单未覆盖当前访问域名，注意 www 与非 www、HTTP 与 HTTPS 的差异；
• 前端调用与后端调用需要不同类型的密钥，须与申请时选择的应用类型一致；
• 服务器 IP 或域名变更后，回到地图平台更新白名单并重新测试；
• 同一密钥不要在多个站点间共用，避免额度被互相占用；
• 密钥泄露或被滥用时，回到地图平台删除旧密钥并新建一个，再更新后台设置。