支付宝小程序API 位置
支付宝小程序API位置
获取用户当前的地理位置信息。
| 名称 |
类型 |
必填 |
描述 |
最低版本 |
| cacheTimeout |
Number |
支付宝客户端经纬度定位缓存过期时间，单位秒。默认 30s。使用缓存会加快定位速度，缓存过期会重新定位 |
- |
| type |
Number |
否 |
0：默认，获取经纬度1：获取经纬度和详细到区县级别的逆地理编码数据2：获取经纬度和详细到街道级别的逆地理编码数据，不推荐使用3：获取经纬度和详细到POI级别的逆地理编码数据，不推荐使用 |
1.1.1 |
| success |
Function |
否 |
调用成功的回调函数 |
- |
| fail |
Function |
否 |
调用失败的回调函数 |
- |
| complete |
Function |
否 |
调用结束的回调函数（调用成功、失败都会执行） |
- |
| 名称 |
类型 |
描述 |
最低版本 |
| 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.setData({
hasLocation: true,
location: formatLocation(res.longitude, res.latitude)
})
},
fail() {
my.hideLoading();
my.alert({ title: '定位失败' });
},
})
使用支付宝内置地图查看位置。
| 名称 |
类型 |
必填 |
描述 |
| 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: '杨高路地铁站',
});
