**
自 2022 年 7 月 14 日后发布的小程序,若使用wx.getlocation接口,需要在app.json中进行声明,否则将无法正常使用该接口,2022 年 7 月 14 日前发布的小程序不受此影响。该接口暂只针对部分类目的小程序开放,需要先通过类目审核,再在小程序管理后台,「开发」-「开发管理」-「接口设置」中自助开通该接口权限。接口权限申请入口已于 2022 年 3 月 11 日开始内测,于 3 月 31 日全量上线。从 4 月 18 日开始,在代码审核环节将检测该接口是否已完成开通,如未开通,将在代码提审环节进行拦截。
相关接口仅针对国内主体的部分类目的小程序开放,在申请接口前,你需要根据提供的小程序服务,补充相关类目,只有选择了对应开放的类目,审核才会通过。你可以在微信公众平台的相关文档中查看具体开放的类目列表,确认自己的小程序所属类目是否在开放范围内。例如,常见的涉及到地理位置服务的类目有电商平台、生活服务(如外卖、打车、旅游等)、线下门店导航等。
登录微信小程序管理后台(mp.weixin.qq.com)。
进入【开发】-【开发管理】-【接口设置】页面。
在接口列表中找到【获取用户当前的地理位置、速度】,点击【去开通】,进入申请页面。
申请原因填写:填写详细且准确的申请原因,说明小程序业务中为何需要使用该接口获取用户地理位置信息。例如,如果是电商小程序涉及商品配送服务,可以填写 “因当前业务涉及商品发货、配送服务,为了更精准地为用户提供配送服务,确定用户位置,需要获取用户当前的地理位置信息”;若是线下门店导航小程序,可以写 “因当前业务涉及线下商超导览、导航服务,为引导用户顺利到达门店,需获取用户当前的地理位置”。
辅助信息上传(非常重要):
提供调用地图定位功能的页面截图:明确 getLocation 接口的使用范围,截取调用地图定位功能的具体页面,并展示页面打开后的地图定位效果。截图要清晰,能直观看到定位相关元素,如地图展示、定位图标等。如果页面有操作流程,建议在截图上用箭头、文字等进行标注,指示从进入小程序到定位功能展示的关键步骤。
录制使用场景视频:录制一段完整的视频作为附件提交,记录小程序中地图定位功能的调用流程。视频内容需包含从小程序进入开始,找到调用自动定位的页面的全过程,包括页面跳转、弹窗触发(若有)等操作。例如,用户进入小程序首页,点击某个按钮后跳转到地图页面,地图自动定位到用户位置,以及可以进行的相关操作(如放大缩小地图、查看周边信息等)都要完整展示。视频中尽量避免无关操作和过长的等待时间,突出定位功能的使用场景。
在小程序的app.json文件中,添加如下代码声明需要调用的地理位置相关接口及权限描述:
{"permission": {"scope.userLocation": {"desc": "你的位置信息将用于小程序地图定位"}},"requiredPrivateInfos": ["getLocation"]}
这样可以让小程序在调用wx.getlocation接口时,向用户明确获取位置信息的用途,符合微信小程序的规范要求。
提交申请后,需要耐心等待微信官方的审核。审核时间通常不会太长,但具体时长取决于提交申请的数量和复杂程度等因素。在审核期间,你可以在小程序管理后台的接口设置页面查看审核状态。若审核通过,接口权限将被开通,你就可以在代码中正常调用wx.getlocation API;若审核不通过,会给出驳回理由,你需要根据理由修改申请原因或补充更完善的辅助信息后重新提交申请。常见的驳回理由如 “申请的接口因提供的申请原因 / 辅助图片 / 网页 / 视频内容 / 无法确认申请接口使用场景”,遇到此类情况,要仔细检查之前提供的信息是否准确、完整地展示了定位功能的使用场景,按照要求进行改进。