位置
my.getLocation(OBJECT)
获取用户当前的地理位置信息。扫码体验:
入参
名称 | 类型 | 必填 | 描述 | 最低版本 |
cacheTimeout | Number | 否 | 支付宝客户端经纬度定位缓存过期时间,单位秒。默认 30s。使用缓存会加快定位速度,缓存过期会重新定位 | |
type | Number | 否 | 0:默认,获取经纬度 1:获取经纬度和详细到区县级别的逆地理编码数据 2:获取经纬度和详细到街道级别的逆地理编码数据,不推荐使用 3:获取经纬度和详细到POI级别的逆地理编码数据,不推荐使用 | 1.1.1 |
success | Function | 否 | 调用成功的回调函数 | |
fail | Function | 否 | 调用失败的回调函数 | |
complete | Function | 否 | 调用结束的回调函数(调用成功、失败都会执行) |
success 返回值
名称 | 类型 | 描述 | 最低版本 |
longitude | String | 经度 | |
latitude | String | 纬度 | |
accuracy | String | 精确度,单位m | |
horizontalAccuracy | String | 水平精确度,单位m | |
country | String | 国家(type>0生效) | 1.1.1 |
countryCode | String | 国家编号 (type>0生效) | 1.1.1 |
province | String | 省份(type>0生效) | 1.1.1 |
city | String | 城市(type>0生效) | 1.1.1 |
cityAdcode | String | 城市级别的地区代码(type>0生效) | 1.1.1 |
district | String | 区县(type>0生效) | 1.1.1 |
districtAdcode | String | 区县级别的地区代码(type>0生效) | 1.1.1 |
streetNumber | Object | 需要街道级别逆地理的才会有的字段,街道门牌信息,结构是:{street, number} (type>1生效) | 1.1.1 |
pois | array | 需要POI级别逆地理的才会有的字段,定位点附近的 POI 信息,结构是:{name, address}(type>2生效) | 1.1.1 |
错误码描述
error | 描述 | 解决方案 |
---|---|---|
11 | 请确认定位相关权限已开启 | 提示用户打开定位权限 |
12 | 网络异常,请稍后再试 | 提示用户检查当前网络 |
13 | 定位失败,请稍后再试 | |
14 | 业务定位超时 | 提示用户再次尝试 |
代码示例
my.getLocation({
success(res) {
my.hideLoading();
console.log(res)
/* that对象为Page可以设置数据刷新界面
that.setData({
hasLocation: true,
location: formatLocation(res.longitude, res.latitude)
})
*/
},
fail() {
my.hideLoading();
my.alert({ title: '定位失败' });
},
})
my.openLocation
使用支付宝内置地图查看位置。
入参
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
longitude | String | 是 | 经度 |
latitude | String | 是 | 纬度 |
name | String | 是 | 位置名称 |
address | String | 是 | 地址的详细说明 |
scale | Number | 否 | 缩放比例,范围 3~19,默认为 15 |
success | Function | 否 | 调用成功的回调函数 |
fail | Function | 否 | 调用失败的回调函数 |
complete | Function | 否 | 调用结束的回调函数(调用成功、失败都会执行) |
代码示例
my.openLocation({
longitude: '121.549697',
latitude: '31.227250',
name: '支付宝',
address: '杨高路地铁站',
});
my.chooseLocation
使用支付宝内置地图选择地理位置。
入参
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
success | Function | 否 | 调用成功的回调函数 |
fail | Function | 调用失败的回调函数 | |
complete | Function | 否 | 调用结束的回调函数(调用成功、失败都会执行) |
success返回值
名称 | 类型 | 描述 |
---|---|---|
name | String | 位置名称 |
address | String | 详细地址 |
latitude | Number | 纬度,浮点数,范围为-90~90,负数表示南纬 |
longitude | Number | 经度,浮点数,范围为-180~180,负数表示西经 |
代码示例
my.chooseLocation({
success:(res)=>{
console.log(res)
}
});