tt.getLocation

基础库 1.0.0 开始支持本方法。

获取设备当前的地理位置。

参数 object

继承标准对象输入,扩展属性描述:

属性类型默认值必填说明最低支持版本
typestring"wgs84"指定坐标系类型,可以是 "wgs84""gcj02"1.0.0

success 返回参数说明

object 类型,属性如下:

名称数据类型描述
latitudenumber纬度,范围为-90 ~ 90,正数表示北,负数表示南
longitudenumber经度,范围为-180 ~180,正数表示东,负数表示西
altitudenumber高度,单位 m
accuracynumber位置的精确度
verticalAccuracynumber垂直精度,单位 m(Android 需要系统 8.0 及以上机型并且开启 GPS,否则返回 0)
horizontalAccuracynumber水平精度,单位 m
speednumber速度,单位 m/s
citystring定位到的城市信息(iOS 不支持)

代码示例

tt.getLocation({
  success(res) {
    console.log(`经度${res.longitude},维度${res.latitude}`);
  },
  fail(res) {
    console.log(`getLocation调用失败`);
  }
});

Tip

  • 该 API 需要用户授权方可调用,详细信息可参考 用户授权
  • 该 API 需要系统授权方可调用,位置精度和调用耗时会因设备而异。
  • 该 API 有一定性能消耗,请注意不要频繁调用以防设备过热和耗电过快。小程序框架也会做相应的节流处理。
  • 如果要将返回值使用在 openLocation中,必须指定坐标系为 "gcj02"
点击纠错