getLocation 1.0.0+

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

提示

该 API 需要用户授权方可调用,详细信息可参考用户授权

提示

该 API 需要系统授权方可调用,位置精度和调用耗时会因设备而异。

⚠️ 注意

该 API 有一定性能消耗,请注意不要频繁调用以防设备过热和耗电过快。小程序框架也会做相应的节流处理。

输入

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

名称数据类型属性默认值描述
typestringoptionalwgs84指定坐标系类型,可以是wgs84gcj02

提示

如果要将返回值使用在openLocation中,必须指定坐标系为gcj02

输出

success回调对象参数的扩展属性:

名称数据类型描述
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调用失败`);
  }
});