微信小程序打开地图教程｜openLocation 坐标校验、失败降级与隐私说明 – MPForge

一、导航按钮最大的风险不是打不开，而是「开错地方」

结论先记住：openLocation 本身很稳定，出事的几乎全是坐标数据。脏坐标、越界坐标、未说明用途，是这类页面被驳回和被投诉的三大来源。

典型翻车现场：商家在后台用地址文本搜索随手选了个近似点，用户导航后被带到两公里外的同名路；坐标串成了经度纬度顺序颠倒，地图直接定位到海上；还有页面没写清「为什么要获取你的位置」，隐私问题被审核追问。三种问题的修复成本都很低，前提是上线前有人核对过。

分工口径：商家负责提供门店真实位置并逐一确认，开发负责坐标校验逻辑与降级路径，两边各签一次字再上线。

二、openLocation 的接入步骤

顺序是：先采坐标，再校验，最后才是调 API。按这五步走：

1. 采集真实坐标：门店位置用小程序后台的地图选点功能标定，别靠地址文本搜索估算，选完立刻在真机预览核对。
2. 校验经纬度范围：调用前检查经度在 -180 到 180、纬度在 -90 到 90 之间，且经纬度顺序与参数定义一致，非法值走降级。
3. 补齐展示参数：name 为空时给门店名或默认标题，address 写到门牌号，scale 按场景取 16 到 18，别用默认值导致视野过远。
4. 设计失败降级：openLocation 调用失败或坐标非法时，展示完整地址文本并支持一键复制，用户可自行粘贴到任意地图 App。
5. 真机验收：iOS 与安卓各测一台，重点看返回小程序后页面状态、以及弱网下地图页能否正常拉起。

如果页面还涉及定位权限，先过一遍 小程序隐私保护指引填写，把位置用途写清楚再提审。

三、失败降级与体验设计

降级不是可选项：导航失败的下一跳必须有人接。对照这张表：

四、单点导航与多点展示的取舍

openLocation 只适合单点导航，连锁多门店请直接上地图页。硬把多个门店做成多个按钮逐个跳 openLocation，用户要在列表和地图之间来回横跳，体验很差；正确做法是用 map 组件做一个门店地图页，聚合标记、支持点选，再从标记进入单点导航。

地图组件的交互细节，可参考 小程序地图控制实务；定位能力本身的开通与限制见 小程序定位能力说明。判断标准很简单：用户眼里只有一个目的地，用 openLocation；需要在多个目的地之间比较，先看地图再导航。

顺带说明：门店在「附近的小程序」里的曝光靠的是 GEO 地理位置配置（地址、经纬度、类目在后台的录入），与页面里调不调 openLocation 是两套体系，上线前两边都要核对。

五、避坑清单

三个坑都在数据层：脏坐标、空名称、没解释用途。

• 别用地址搜索代替选点：文本搜索选出的坐标偏差可达数公里，门店坐标必须用地图选点并在真机复核。
• 别让失败变成白屏：任何 openLocation 异常都要落到地址文本与复制路径，这是成本最低的兜底。
• 别漏写位置用途：隐私指引里写清「用于门店导航」，弹窗时机放在用户点击导航按钮时，而不是进页面就要权限。
• 别把经纬度顺序写反：不同系统的坐标字段顺序不一致，接入前用真实点位在地图上标一次验证。

六、常见问题 FAQ