uni-app微信小程序GPS位置获取爬坑

前情

uni-app是我比较喜欢的跨平台框架,它能开发小程序/H5/APP(安卓/iOS),重要的是对前端开发友好,自带的IDE让开发体验也挺棒的,现在所在公司项目有抖音、快手、微信、支付、APP端,就是使用uni-app来开发的。

坑位

最近接手的项目是需要在下单前获取用户所有位置的GPS信息,再服务端会根据当前用户的GPS信息来判定是否给当前用户一定优惠。本以为就是调用一个API的事,但当你直接调用的时候你会发现根本无法使用。

Why?

位置信息属于用户隐私,从23年9月开始如果小程序需要获取位置信息需要去小程序管理后台:开发与服务-开发管理-接口设置-接口权限页申请地理位置api权限方才能使用。

解决方案

STEP 1:申请权限

开发与服务-开发管理-接口设置-接口权限申请权限,这里又有一小坑,微信提供了二个获取位置的接口

  1. wx.getLocation:获取当前的地理位置、速度,支持高精度定位
  2. wx.getFuzzyLocation:获取当前的模糊地理位置

在申请地理位置获取api权限的时候,你需要填二项必填项,申请理由和场景说明,官方有提供申请成功的案例

uni-app微信小程序GPS位置获取爬坑

我第一感觉是申请支持高精度定位的wx.getLocation,模精定位特有接口能做的支持高精度定位也一定能实现需求,于是我就申请了wx.getLocation接口,同时针对场景截了图提交了申请,一天后发现申请不通过,于是又完善了资料再次提交又碰壁了,二天二次申请都被打回,一脸蒙逼。

uni-app微信小程序GPS位置获取爬坑

搜了论坛都是说申请全被拒的,用模糊定位接口又不准,后面问了产品,我们只需要定位到市区级别行不行,产品说可以的,不用那么精确,于是转而申请wx.getFuzzyLocation,半小时时间未到就收到申请通过的短信提醒(怀疑是机审,走个过场,哈哈哈)

uni-app微信小程序GPS位置获取爬坑

所以在申请接口前要跟产品确认好对于gps位置的精度要求,如果模糊定位能实现那就不要去折腾申请高精度定位的接口了,微信对wx.getLocation接口管理的比较严格,如果你确实需要高精度接口,那你就按官方提供的参考申请案例补充资料再申请吧,但是从论坛里的抱怨来看申请可能不是那么容易,如果你要申请那就多费点心吧,在此祝好。

STEP 2:填写接口权限配置

申请接口了并不就是说你就能直接调用了,你需要去app.json里补全位置权限获取说明描述和对应的接口权限注明

"permission" : { 		"scope.userFuzzyLocation" : { 			"desc" : "为了给用户提供更好的服务" 		} 	}, 	"requiredPrivateInfos": ["getFuzzyLocation"] 

如果你是使用uni-app的话,你直接用hbuilderx以源码视图方式打开manifest.json文件,找到mp-weixin微信项配置按如下配置好

uni-app微信小程序GPS位置获取爬坑

STEP 3:接口调用

查了uni-app官方文挡都没有找到uni.getFuzzyLocation接口的说明,但是你在调用的时候是可以调用的,如果你实在不放心,可以直接使用wx.getFuzzyLocation接口。

接口调用注意事项:

你调用uni/wx.getFuzzyLocation的时候如果没有授过权会弹出授权的提示弹框,只有用户同意了才能获取地理位置信息,这里如果用户拒绝就无法再次唤起授权弹框,微信会记住授权状态,所以这里如果用户选了同意,那就万事大吉了,但是如果用户选择了拒绝,那后面就一直无法再获取用户位置信息了。

如果你获取用户的位置是可有可无的,你可以把位置信息当可选项,用户不同意你就不上传即可,但是如果你需求是位置信息是必需要的,那这里你需要做一些引导,引导用户去开启权限,对于引导你又要注意二种情况,一种是小程序位置授权没开启,另一种是微信APP位置权限没开启,下面是关键代码:

uni.getFuzzyLocation({ 	type: 'gcj02', 	success(res){ 		// 位置信息获取成功 		// ... 	}, 	fail(err) { 		// 位置信息获取失败 		if (['getLocation:fail auth deny','getLocation:fail:auth denied','getLocation:fail:system permission denied'].includes(err.errMsg)) { 			if (是否是需要强制获取位置信息的) { 			  //小程序位置信息获取被拒绝 				if (['getLocation:fail auth deny','getLocation:fail:auth denied'].includes(err.errMsg)) { 					uni.showModal({ 						content: "为了您享受到更好的优惠,请授权位置信息后下单", 						confirmText: '去授权', 						cancelText: '再想想', 						success(res) { 							if (res.confirm) { 								// 去小程序位置授权页 								uni.openSetting(); 							} else if (res.cancel) { 								console.log('小程序权授没有开启。微信用户点击取消'); 							} 						} 					}) 				} 				// 微信位置信息获取权限没有打开 				if (err.errMsg === 'getLocation:fail:system permission denied') { 					uni.showModal({ 						content: "请确认是否已授权APP位置权限", 						confirmText: '知道了', 						showCancel: false, 						success(res) { 							console.log('微信app权限没有开启', res); 						} 					}) 				} 			} 		} 	} }) 

注:查了微信官方文挡,并没有对应的错误提示说明,我是多次测试发现的上面的错误提示加入的判断,如果你有官方的错误提示说明文挡链接,欢迎分享出来,谢谢了。

总结

使用微信的地理位置接口分三步

  1. 申请权限:按需选用wx.getFuzzyLocation(易申请)、wx.getLocation(较难申请)
  2. 填写接口权限配置:原生小程序在app.json里配置,uniapp在manifest.json里配置
  3. 接口调用:根据自己需求这里要对权限失败的场景做好引导
发表评论

相关文章