Web 端地图与定位服务配置说明
Web 端地图（JS API）与定位服务（Web 服务）配置说明
手机顶栏自动定位顺序与后台选项 → 见 WAP 手机端定位流程说明（简明版）
为什么要分开？
各地图平台 同一账号下可创建多个 Key，但 浏览器端（JS API） 与 服务端（Web 服务） 用途、白名单完全不同，不能混用：
| 类型 | 用途 | 白名单 | 后台配置 |
|---|---|---|---|
| 浏览器端 JS API | 内嵌地图、GPS 导航 Tab、发布页选点 | 域名 / Referer | 设置 → 功能设置（config.html） |
| Web 服务 | PHP 服务端 IP 定位、GPS 逆地理编码 | IP | 设置 → 城市分站设置（location.html） |
一、Web 端地图（前台浏览器）
后台：设置 → 常用功能 → 功能设置（/backstage/setting/config.html）
本页 高德 / 百度 / 腾讯 三组 Key 同时展示，可分别填写。
「默认地图（选点/详情）」 下拉只决定：发布页地图选点、PC 商家侧栏小地图等默认用哪一种。
WAP GPS 导航页（如 wap/shop/gps/shop_id/xxx.html）顶栏固定 高德 | 百度 | 腾讯 三个 Tab，通过 URL 切换：
| Tab | URL 参数 | 读取的后台字段 |
|---|---|---|
| 高德 | type=1 或不带 type（跟默认地图） | web_map_gaode_key + web_map_gaode_security_code |
| 百度 | type=2 | web_map_baidu_ak（浏览器端 AK） |
| 腾讯 | type=3 | web_map_tencent_key（Javascript API Key） |
1. 高德 · Web端(JS API)
| 控制台项 | 值 |
|---|---|
| Key 名称 | 如：法律服务平台 |
| 服务平台 | Web端(JS API) |
| 域名白名单 | falvfuwuw.cn、baoanfuwu.cn、banyanfw.com、localhost（本地调试） |
| 安全密钥 | 填入后台「高德安全密钥」 |
| 后台字段 | 说明 |
|---|---|
| 高德 JS API Key | Web端(JS API) Key |
| 高德安全密钥 | securityJsCode（2021-12 后新建 Key 必填） |
加载 JS API 之前须设置：
window._AMapSecurityConfig = { securityJsCode: "您的安全密钥" };
2. 百度 · 浏览器端 JS API（非服务端）
| 控制台项 | 值 |
|---|---|
| 应用类型 | 浏览器端（不是服务端） |
| 启用服务 | JavaScript API |
| Referer 白名单 | 本站域名，如 *.falvfuwuw.cn |
| 后台字段 | 说明 |
|---|---|
| 百度 JS API AK | 浏览器端 AK，填在 config 页 |
| 百度 Web 服务 AK | 填在 location 页，仅服务端逆地理，不能用于 GPS 内嵌地图 |
若 GPS 页百度 Tab 提示「未加载」，常见原因：把 服务端 AK 误填到了 百度 JS API AK。
3. 腾讯 · Javascript API（非 WebService/IP 白名单）
| 控制台项 | 值 |
|---|---|
| 启用产品 | Javascript API、Javascript API GL、地图组件 |
| 域名白名单 | falvfuwuw.cn、baoanfuwu.cn 等 |
| 后台字段 | 说明 |
|---|---|
| 腾讯 JS API Key | config 页，浏览器端 Key |
| 腾讯 Web 服务 Key | location 页，IP 白名单（如 112.26.255.213），不能用于 WAP 内嵌地图 |
控制台公告：新申请的 服务端 AK 不再支持浏览器端；GPS 页须使用 浏览器端 Key。
二、定位服务（PHP 服务端）
后台：设置 → 基本设置 → 城市分站设置（/backstage/setting/location.html）
| 字段 | 说明 |
|---|---|
| IP 定位库 | 高德 / ip2region 等 |
| 高德 Web 服务 Key | Web服务 Key + IP 白名单 |
| 高德数字签名私钥 | 开启数字签名后必填 |
| 百度 Web 服务 AK | 服务端，非浏览器 JS AK |
| 腾讯 Web 服务 Key | 服务端 IP 白名单，非 Javascript API |
| GPS 逆地理服务商 | 浏览器 GPS 坐标转城市（走 Web 服务） |
三、常见失败与处理
| 现象 | 原因 | 处理 |
|---|---|---|
| 百度地图未加载 | 用了服务端 AK 或未填浏览器 AK | config 页填 百度 JS API AK |
| 腾讯地图空白 | 用了 IP 白名单 Web 服务 Key | config 页填 Javascript API Key + 域名白名单 |
| 高德地图空白 | Key/安全密钥错误或域名未白名单 | 检查 JS API Key + securityJsCode |
IP 定位 INVALID_USER_IP | 服务器 IP 不在 Web 服务白名单 | location 页 Key 加出口 IP |
USERKEY_PLAT_NOMATCH | JS API Key 与 Web 服务 Key 混用 | 按上表分开填写 |
| GPS 逆地理只到市 | IP 定位本身精度限制 | 使用手机 GPS + 逆地理可到县/区 |
四、公司坐标选点（商家编辑 / 公司管理）
公司 经度、纬度 跟随后台 「Web 端地图服务 → 默认地图」 的坐标系（默认高德为 GCJ-02）。前台 GPS 导航三 Tab 会按需要自动转换（高德/腾讯用 GCJ，百度用 BD-09）。
| 页面 | 地图 Key 来源 | 说明 |
|---|---|---|
| 系统后台 商家编辑 →「地图选点」弹窗 | config.web_map_*（跟默认地图） | 支持高德/百度/腾讯/Google，可搜索地址 |
| 商家 PC 后台 公司管理 → 公司文字资料 | 同上 | 页内嵌地图选点，与发布页一致 |
| WAP 商家后台 基本设置 → 公司坐标 | 同上，wap/api/maps 跟默认地图 | 弹层选点，回写 lng/lat |
| 发布页 / 生活信息选点 | 同上 web_map_service | 与公司坐标同一套逻辑 |
配置路径：设置 → 常用功能 → 功能设置 → Web 端地图服务（默认地图 + 对应 JS API Key）。
- 默认 高德：须填 高德 JS API Key + 安全密钥（浏览器端，域名白名单）
- 默认 百度：须填 百度 JS API AK（浏览器端，Referer 白名单）
- 默认 腾讯：须填 Javascript API Key（域名白名单）
不是 location 页的 Web 服务 AK（那个只给 IP 定位 / GPS 逆地理用）。
历史数据若曾用百度选点存 BD-09，GPS 页会自动识别；重新选点保存后即为新坐标系。
五、法律站 / 保安站
两端代码共用，各站后台 分别保存 各自 Key：
| 站点 | JS API 域名白名单 | Web 服务 IP 白名单 |
|---|---|---|
| 法律 baoan | falvfuwuw.cn 等 | 该站服务器公网 IP |
| 保安 ba | baoanfuwu.cn 等 | 该站服务器公网 IP |
代码与帮助文档需 两端同步（见 .cursor/rules/sync-to-ba-security-site.mdc）。
六、自检清单
- config 页：高德 JS Key + 安全密钥；百度 浏览器端 AK；腾讯 Javascript API Key
- 默认地图：选一种作为发布选点默认（GPS 页仍可三 Tab 切换）
- location 页：各平台 Web 服务 Key + IP 白名单 + 高德签名私钥（若开启）
- GPS 页测试：
wap/shop/gps/shop_id/xxx/type/1|2|3分别验证 - 控制台：浏览器 Key 用域名白名单；服务端 Key 用 IP 白名单
- 公司坐标：系统后台商家编辑、商家 PC/WAP 公司管理选点是否正常（跟默认地图，须填对应 JS API Key）
