位置

my.getLocation(OBJECT)

获取用户当前的地理位置信息。扫码体验:

img.jpg

入参


名称

类型

必填

描述

最低版本

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业务定位超时提示用户再次尝试

代码示例

  1. my.getLocation({
  2. success(res) {
  3. my.hideLoading();
  4. console.log(res)
  5. /* that对象为Page可以设置数据刷新界面
  6. that.setData({
  7. hasLocation: true,
  8. location: formatLocation(res.longitude, res.latitude)
  9. })
  10. */
  11. },
  12. fail() {
  13. my.hideLoading();
  14. my.alert({ title: '定位失败' });
  15. },
  16. })

my.openLocation

使用支付宝内置地图查看位置。

img.jpg

入参

名称类型必填描述
longitudeString经度
latitudeString纬度
nameString位置名称
addressString地址的详细说明
scaleNumber缩放比例,范围 3~19,默认为 15
successFunction调用成功的回调函数
failFunction调用失败的回调函数
completeFunction调用结束的回调函数(调用成功、失败都会执行)

代码示例

  1. my.openLocation({
  2. longitude: '121.549697',
  3. latitude: '31.227250',
  4. name: '支付宝',
  5. address: '杨高路地铁站',
  6. });

my.chooseLocation

使用支付宝内置地图选择地理位置。

入参

名称类型必填描述
successFunction调用成功的回调函数
failFunction调用失败的回调函数
completeFunction调用结束的回调函数(调用成功、失败都会执行)

success返回值

名称类型描述
nameString位置名称
addressString详细地址
latitudeNumber纬度,浮点数,范围为-90~90,负数表示南纬
longitudeNumber经度,浮点数,范围为-180~180,负数表示西经

代码示例

  1. my.chooseLocation({
  2. success:(res)=>{
  3. console.log(res)
  4. }
  5. });

原文: https://docs.alipay.com/mini/api/location