getLocation 1.0.0+
获取设备当前的地理位置。
提示
该 API 需要用户授权方可调用,详细信息可参考用户授权
提示
该 API 需要系统授权方可调用,位置精度和调用耗时会因设备而异。
⚠️注意
该 API 有一定性能消耗,请注意不要频繁调用以防设备过热和耗电过快。小程序框架也会做相应的节流处理。
输入
继承标准对象输入,扩展属性描述:
名称 | 数据类型 | 属性 | 默认值 | 描述 |
---|---|---|---|---|
type | string | optional | wgs84 | 指定坐标系类型,可以是wgs84 或gcj02 |
提示
如果要将返回值使用在openLocation
中,必须指定坐标系为gcj02
输出
success
回调对象参数的扩展属性:
名称 | 数据类型 | 描述 |
---|---|---|
latitude | number | 纬度,范围为-90 ~90 ,正数表示北,负数表示南 |
longitude | number | 经度,范围为-180 ~180 ,正数表示东,负数表示西 |
代码示例
tt.getLocation({
success (res) {
console.log(`经度${res.longitude},维度${res.latitude}`);
},
fail (res) {
console.log(`getLocation调用失败`);
}
});
已知问题
- 暂不支持
altitude
参数。