Version: 3.0.0-beta.5
Taro.chooseLocation(param)
打开地图选择位置。
使用方式同 wx.chooseLocation
,支持 Promise
化使用。
使用前注意
chooseLocation
api功能是依赖于腾讯位置服务,所以需要使用 api 密钥。如果您没有,可以前往腾讯位置服务开发者控制台进行申请。
获得 api 密钥后,您需要将它填入项目的常量配置defineConstants.LOCATION_APIKEY
中:
// config/index.js
const config = {
defineConstants: {
LOCATION_APIKEY: JSON.stringify('XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX')
},
// ...
}
参数
object param
Property | Type | Description |
---|---|---|
[success] | function | 接口调用成功的回调函数 |
[fail] | function | 接口调用失败的回调函数 |
[complete] | function | 接口调用结束的回调函数(调用成功、失败都会执行) |
参数
success(obj)
Name | Type | Description |
---|---|---|
name | string | 位置名称 |
address | string | 详细地址 |
latitude | string | 纬度,浮点数,范围为-90~90,负数表示南纬。使用 gcj02 国测局坐标系 |
longitude | string | 经度,浮点数,范围为-180~180,负数表示西经。使用 gcj02 国测局坐标系 |
示例代码
import Taro from '@tarojs/taro'
Taro.chooseLocation(params).then(...)
API 支持度
API | 微信小程序 | H5 | React Native |
---|---|---|---|
Taro.chooseLocation | ✔️ | ✔️ |