# 小程序地理位置接口申请与使用指引

• 为进一步规范开发者调用涉用户信息相关接口或功能，保障用户合法权益，平台于2022年4月18日开始对如下地理位置相关接口调用实行准入开通，公告详情可查看《小程序地理位置相关接口调整》以及《地理位置接口新增与相关流程调整》

• 如果小程序在代码中使用了地理位置相关接口，但是未申请对应权限或者未按照开发文档在requiredPrivateInfos中声明，都将无法提交代码审核。因此，为了帮助开发者更好的申请小程序地理位置接口权限以及使用，可查看下方文档说明。

# 申请权限

• 可通过applyPrivacyInterface接口申请地理位置相关api的权限。注意，api_name参数需要填写正确的接口名称，区分大小写。
• 在在提交申请前可通过getPrivacyInterface接口查看有哪些地理位置相关的api。
• 提交申请后，审核结果会推送至【第三方平台 - 开发资料 - 消息与事件url】
• 提交审核后，也是可以通过getPrivacyInterface接口查看审核结果、驳回原因等信息。

# 使用接口

• 在代码中使用的地理位置相关接口，开发者均需要在 commit 接口 的 ext_json 参数中 使用 requiredPrivateInfos 配置项进行声明，代码格式如下：

{
  "template_id": "95",
  "ext_json": "{\"requiredPrivateInfos\":[\"onLocationChange\",\"startLocationUpdate\"]}",
  "user_version": "V1.0",
  "user_desc": "test"
}

# 常见问题

# 61039

• 指的是上传代码后，检测任务尚未结束，开发者就提交代码审核了。
• 开发者可以通过getCodePrivacyInfo接口获取检测结果，确认检测任务结束后再提交代码审核
• 此外，不要将上传代码和提交代码审核两个接口一起重试，否则每次上传代码后的检测任务未结束又发起新的检测任务，依旧会出现61039报错

# 61040

• 如果代码里使用了地理位置相关接口，但是又尚未在ext_json参数中配置requiredPrivateInfos。那么提交代码审核时会出现61040报错。此时，开发者可以通过重新上传代码（上传代码时按照要求配置requiredPrivateInfos即可）
• 如果代码里使用了地理位置相关接口，但是该小程序appid又未获得对应地理位置api的权限，那么提交代码审核时会出现61040报错。
• 如果ext_json配置了地理位置相关接口，但是该小程序appid又未获得对应地理位置api的权限，那么提交代码审核时会出现61040报错。
• 如果开发者确认不需要使用地理位置相关接口，那么不需要去申请权限，只需要通过提交代码审核接口中的privacy_api_not_use参数进行声明不使用即可。如果开发者确认需要使用该api，那么需要通过applyPrivacyInterface接口申请地理位置相关api的权限，且审核通过后，再来提交代码审核。