tt.getLocation
基础库 1.0.0 开始支持本方法。
获取设备当前的地理位置。
参数 object
继承标准对象输入,扩展属性描述:
属性 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
---|---|---|---|---|---|
type | string | "wgs84" | 否 | 指定坐标系类型,可以是 "wgs84" 或 "gcj02" | 1.0.0 |
success 返回参数说明
object 类型,属性如下:
名称 | 数据类型 | 描述 |
---|---|---|
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调用失败`);
}
});
Tip
- 该 API 需要用户授权方可调用,详细信息可参考 用户授权
- 该 API 需要系统授权方可调用,位置精度和调用耗时会因设备而异。
- 该 API 有一定性能消耗,请注意不要频繁调用以防设备过热和耗电过快。小程序框架也会做相应的节流处理。
- 如果要将返回值使用在 openLocation中,必须指定坐标系为 "gcj02"