getLocation 1.0.0+

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

提示

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

提示

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

⚠️注意

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

输入

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

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

提示

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

输出

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

名称 数据类型 描述
latitude number 纬度,范围为-90~90,正数表示北,负数表示南
longitude number 经度,范围为-180~180,正数表示东,负数表示西
altitude number 高度,单位 m
accuracy number 位置的精确度
verticalAccuracy number 垂直精度,单位 m(Android需要系统 8.0及以上机型并且开启GPS,否则返回 0)
horizontalAccuracy number 水平精度,单位 m
speed number 速度,单位 m/s
city string 定位到的城市信息(ios不支持)

代码示例

 








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