wx.chooseLocation

wx.chooseLocation(Object object)

为确保选择地理位置接口的合理使用，位置接口调整参考 选择地理位置接口调整公告

以 Promise 风格 调用：支持

用户授权：需要 scope.userLocation

小程序插件：支持，需要小程序基础库版本不低于 1.9.6

微信 Windows 版：支持

微信 Mac 版：支持

功能描述

打开地图选择位置。

使用方法

自 2022 年 7 月 14 日后发布的小程序，若使用该接口，需要在 app.json 中进行声明，否则将无法正常使用该接口，2022年7月14日前发布的小程序不受影响。具体规则见公告

申请开通

暂只针对具备与地理位置强相关的使用场景的小程序开放，在小程序管理后台，「开发」-「开发管理」-「接口设置」中自助开通该接口权限。 接口权限申请入口将于2022年3月11日开始内测，于3月31日全量上线。并从4月18日开始，在代码审核环节将检测该接口是否已完成开通，如未开通，将在代码提审环节进行拦截。

参数

Object object

属性	类型	默认值	必填	说明	最低版本
latitude	number		否	目标地纬度	2.9.0
longitude	number		否	目标地经度	2.9.0
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数

Object res

属性	类型	说明
name	string	位置名称
address	string	详细地址
latitude	number	纬度，浮点数，范围为-90~90，负数表示南纬。使用 gcj02 国测局坐标系
longitude	number	经度，浮点数，范围为-180~180，负数表示西经。使用 gcj02 国测局坐标系

示例