WAP 手机端定位流程说明（简明版）

适用：手机浏览器访问 WAP 前台，顶栏自动显示当前城市

更新：2026-07-09（定位策略简化版）

关联文档：Web 端地图与定位服务配置说明

一、一句话说明

后台 选一种手机端定位策略，前台 只走这一种流程，不再 IP 与 GPS 并行混跑。

顶栏定位 与 商家 GPS 导航页 用的是 两套不同的 Key，请勿混填。

二、后台定位策略（三选一）

路径：设置 → 基本设置 → 城市分站设置 →「定位策略」

PC 端：固定 仅 IP 定位（PC 无 GPS）。

策略与下方配置的关系

三、微信内用 wx 还是浏览器 GPS？

四、流程图（推荐策略 gps_then_ip）

flowchart TD
    A[手机打开 WAP] --> B{缓存/手动/分站跳转?}
    B -->|是| Z[保持当前城市]
    B -->|否| C{手机端策略}
    C -->|仅IP| D[IP定位库]
    C -->|仅GPS| E[微信wx或浏览器GPS]
    C -->|GPS再IP| E
    E -->|成功| F[GPS逆地理 → 城市]
    E -->|失败| D
    D --> G{成功?}
    G -->|是| H[显示城市]
    G -->|否| I[默认城市]
    F --> H

五、后台如何设置（旧版字段说明保留）

定位相关配置分 两个后台页面，用途不同：

4.1 城市分站设置（location 页）— 顶栏定位必配

选择建议：

1. 只要快速、稳定到市级：IP 定位库选 ip2region，可不开 GPS（关闭浏览器定位）。
2. 要精确到县/区：开启 浏览器定位 + 配好 GPS 逆地理服务商 及对应 Web 服务 Key；站点须 HTTPS，用户须允许定位权限。
3. IP 用在线 API：IP 定位库选高德/百度/腾讯，并填对应 Web 服务 Key（服务器出口 IP 加白名单）。
4. GPS 逆地理与 IP 库可不同：例如 IP 用 ip2region，GPS 逆地理用高德。

4.2 功能设置（config 页）— 与顶栏定位无关

详见：Web 端地图与定位服务配置说明

五、两套 Key 对照（易混）

填错常见现象：导航页地图空白、或定位报 USERKEY_PLAT_NOMATCH / INVALID_USER_IP。

六、精度说明

七、与 GPS 导航页的区别

八、自检清单

1. location 页：默认城市、浏览器定位、IP 定位库、GPS 逆地理、Web 服务 Key + IP 白名单
2. config 页：仅在内嵌地图/导航需要时配置 JS API Key（与顶栏定位分开）
3. 手机 HTTPS 下测试：允许定位后顶栏是否到县/区
4. 关闭 GPS 测试：仅 IP 时是否稳定到市
5. 调试：URL 加 ?locdebug=1 打开城市弹层查看定位方式（GPS / IP / 默认 / 手动）

九、法律站 / 保安站

两端代码一致，各站后台 分别保存 各自 Key 与默认城市；文档与代码需 两端同步。