手把手教你微信小程序定位功能，从入门到实战全攻略

拿到一个需求，要在小程序里做个定位功能，很多新手第一反应是去翻文档，看那个`wx.getLocation`的API怎么调。这没错，但真到上线那天，你会发现坑不在代码里，而在用户手机里。这篇文章不跟你绕弯子，直接把我踩过的坑、验证过的方案，从接口调用到权限申请，再到那些“年久失修”的坑位，一条条给你捋清楚。

先说最基础的，也是你第一个会碰到的坎：`wx.getLocation`这个接口。官方文档写得挺简单，传个`type`参数，`wgs84`返回国际坐标，`gcj02`返回火星坐标。但很多人忽略了一个前置条件——用户必须授权。所以代码第一行，别急着调接口，先写个`wx.getSetting`去查一下用户是不是已经授权过。如果没授权，你得主动弹窗引导，用`wx.authorize`去请求`scope.userLocation`权限。这里有个细节，如果用户之前拒绝过，`wx.authorize`会直接走fail回调，你需要在fail里用`wx.openSetting`把用户带到设置页，让他手动打开开关。这一步不做，你的定位功能就是个摆设。

拿到坐标只是万里长征第一步。你想想，你拿`wgs84`坐标直接丢给后台，后台再对接地图服务，出来的位置可能偏了几百米。所以实战里，我强烈建议你直接用`gcj02`，这是中国国测局的标准，国内所有地图厂商都认这个。代码就一行，`type: 'gcj02'`，别省这个参数。另外，`wx.getLocation`的`success`回调里，返回的`latitude`和`longitude`是数字类型，但有些开发者在传参给后端时，不小心把它变成了字符串，导致后端做范围计算时精度丢失。这种低级错误，真的会在联调时被后端同事骂到怀疑人生。

定位拿到了，精度却差得离谱，这又是怎么回事？大概率是你没开`enableHighAccuracy`。这个参数默认是`false`，意味着系统会用基站和Wi-Fi粗略定位，省电但误差大。你要做的是在调用时显式传`enableHighAccuracy: true`，同时设置`timeout`和`maximumAge`。`timeout`建议给个5000毫秒，别太长，不然用户等得焦虑；`maximumAge`可以设成0，保证每次拿到的都是新鲜数据。但注意，高精度模式在室内或地下停车场，依然可能一无所获，所以`fail`回调里要写个降级方案，比如用`wx.chooseLocation`让用户手动选一个位置，这招在实战中救了我好几次。

接下来是权限配置，这个坑特别隐蔽。你在代码里写完授权逻辑还不够，还得去`app.json`里声明`permission`字段，指定`scope.userLocation`的用途说明。比如：`"permission": {"scope.userLocation": {"desc": "你的位置信息将用于查找附近的门店"}}`。这句描述会展示在授权弹窗上，写得太生硬或太吓人，用户直接拒绝。我见过有团队写“我们需要你的位置信息”，用户一看就毛了，拒绝率飙升。你换个说法，比如“用于展示离你最近的优惠活动”，同意率明显高很多。这个细节，直接影响你功能上线后的使用率。

你以为配置完就万事大吉了？还没完。小程序后台的“开发管理”里，有个“接口设置”页，需要把`getLocation`这个接口加入白名单，不然真机调试时，接口会直接报错“fail: permission denied”。这个操作很多人会忘，尤其在公司多人协作时，后端同事改了配置，前端不知道，排查半天。另外，小程序从基础库2.9.0开始，`getLocation`在部分安卓机型上会偶发返回缓存数据，你可以在`success`回调里加个判断，比较`timestamp`字段，如果超过5秒，就视为无效数据，重新调用一次。这种防御性编程，在定位场景里特别实用。

再往深一步，你可能会遇到“用户拒绝授权后，重新引导”的场景。这里有个反直觉的坑：`wx.getSetting`返回的`authSetting`里，如果`scope.userLocation`是`false`，说明用户拒绝过；但如果它压根不存在，说明用户还没做过选择。这两种情况要分开处理。拒绝过的，直接弹`wx.openSetting`；没选过的，用`wx.authorize`去请求。如果你图省事，统一走`wx.openSetting`，那用户第一次使用时，会跳到一个空白设置页，体验极差。我自己写了个工具函数包装这层逻辑，每次调用定位前先检查状态，代码量不大，但能省掉大量线上投诉。

聊点架构层面的事。定位逻辑别散落在各个页面里，建议封装成一个`locationService`，统一管理授权状态、缓存策略、错误处理。比如，页面A需要定位，页面B也需要，你就别各写一套。封装好后，每次调用返回一个Promise，成功就resolve坐标，失败就reject一个带错误码的对象。这样排查问题也方便，线上出bug了，看上报的错误码就能定位是权限问题、网络问题还是接口问题。另外，考虑到用户可能在小程序里从A页面跳到B页面，定位结果可以存入全局`globalData`，避免重复请求，省电省流量。

说回标题，这个“从入门到实战”，其实最大的实战不是写代码，而是理解用户。用户对定位功能天然有戒备心，你要做的，是用清晰的文案、合理的降级策略，把这种戒备心降到最低。我见过很多开发者，代码写得漂亮，但忘了处理用户点“拒绝”按钮的那一刻。那一刻，才是你功能真正的分水岭。这篇文章写到的每个细节，都是我自己在项目里被坑过、又爬出来的经验。你照着做，不敢保证百分百没坑，但至少能让你少熬几个夜。