小程序地图选点与定位教程｜权限声明、失败降级与坐标系排查 – MPForge

一、排查顺序：先配置后代码，能省一半时间

结论先记住：定位失败八成不是代码问题，而是权限声明、系统开关、隐私指引、坐标系这四层配置有一层没对齐。

真实项目里最常见的情况是：开发盯着定位回调改了一下午代码，结果发现只是权限字段没声明，或者用户早已在系统层面关掉了定位授权。按固定顺序排查能避免这种空转：

• 第一层看权限声明：app.json 的 requiredPrivateInfos 与 permission 字段是否声明了地理位置用途，声明缺失时接口直接不生效。
• 第二层看系统开关：用户可能在系统设置里关闭了定位，需要在失败分支引导去 小程序打开设置页，而不是干等重试。
• 第三层看隐私指引：隐私保护指引里没写「位置信息」这一项，接口调用会被拦，填写口径参考 小程序用户隐私保护指引填写。
• 第四层看坐标系：腾讯地图体系用 gcj02，业务后端若按 wgs84 存储或计算距离，几百米的偏差就会出现「定位漂移」的错觉。

四层都排过再去看业务代码，这是给开发的硬口径；商家侧只需要记住一句话——定位投诉先问用户「手机系统定位开着吗」。

二、开工前备齐四样材料

缺材料就会停在半路：四样东西少一样，开发到验收阶段都得回头补。

• 隐私用途文案：写清「为什么要用你的位置」，例如「用于推荐附近门店与计算配送距离」，措辞要与实际功能一致。
• 失败降级方案：定位失败时的兜底交互（手动选点、手动填地址），产品与开发先约定好。
• 坐标系约定：前后端、地图服务三方统一写在接口文档里，谁存什么系、谁转换，白纸黑字。
• 地图 key 与配额：确认 key 归属主体、日调用量配额与费用，别在流量高峰日触发限流。

三、选点组件与持续定位：先分清场景再动手

结论：能选点就别强依赖持续定位——一次取点用户可控、审核风险低，持续定位只在真正需要轨迹的场景才用。

持续定位的实现细节参考 小程序持续定位更新；需要用户自己选位置的场景，用选点类接口最省事，口径见 小程序选择位置接口。坐标系一旦混用，距离就会算出负值或超远值，联调时务必先对齐。

四、落地步骤：从权限弹窗到真机验收

顺序不能乱：指引先配、弹窗对齐、两态都测、降级可用、日志脱敏。按这五步走：

1. 指引与弹窗对齐：先在后台把隐私指引里「位置信息」的用途写好，再对齐前端弹窗时机，与 小程序隐私弹窗时机设计 的口径一致。
2. 真机两态测试：拒绝授权、允许授权各走一遍主流程，拒绝路径要能进降级方案。
3. 降级方案验收：定位失败切手动选点，选完能正常下单；弱网下重试不超过 2 次就转降级，不做无限重试。
4. 室内与弱网验收：在写字楼、地下车库各测一次，失败提示文案要说人话，不报原始错误码给用户。
5. 日志脱敏：定位日志只记精度截断后的坐标与错误码，不落完整坐标与手机号，排查够用又不碰合规红线。

五、审核驳回与线上翻车点

结论：定位类驳回集中在三条——未说明用途、强制定位才能浏览、精确到门牌却无降级。

• 未说明用途：申请了定位权限但页面和指引里找不到「为什么要定位」，审核会驳回，改完再提，别原样重提，更多原因看 小程序审核被拒常见原因。
• 强制定位才能浏览：不授权就白屏或弹窗循环，属于典型的高压线；浏览类功能必须支持拒绝授权继续使用。
• 无降级方案：功能说明写着「精确到门牌号」却没有手动选点兜底，地下室、室内场景一翻车就是差评与投诉。

商家侧的验收口径很朴素：拿一部旧手机，关掉系统定位走一遍下单，能顺利完成就达标；开发侧再补弱网与坐标系两道用例。提审前对照 小程序上线发布检查清单 逐项过。

六、避坑清单

这三条坑都和「预期管理」有关：向用户、向审核、向自己。

• 别把 GEO 当地域 SEO：文案里堆城市关键词没用，附近检索靠的是门店地址与经纬度的地理位置配置，不靠营销文案。
• 别默认用户会授权：拒绝授权是常态路径，产品设计与埋点都要覆盖，别只在「允许」分支埋点导致转化数据虚高。
• 别开后台定位凑功能：多数业务不需要后台定位，开了多一份合规与审核负担；真需要轨迹的场景再评估频控与电池说明。
• 别在文案里承诺「厘米级精度」：民用定位在室内误差可达几十米，承诺越满，投诉越多。

七、常见问题 FAQ