getLocation

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

支持说明

应用能力	Android	iOS	PC	预览效果
小程序	3.0.0	3.0.0	X	扫码预览 用BoosHi扫码或PC端点击
网页应用	3.3.0	3.3.0	X	待补充

输入

继承标准对象输入，扩展属性描述：

名称	数据类型	必填	默认值	描述
type	string	否	wgs84	坐标系类型 待开发 可选值： wgs84：wgs84 坐标系 gcj02：gcj02 坐标系
timeout	number	否	5000	定位超时时间，单位毫秒。
cacheTimeout	number	否	0	定位缓存超时时间，单位毫秒； 待开发
accuracy	string	否	high	待开发 指定期望精度，支持 high，best。当指定 high 时，期望精度值为100m，当指定 best 时期望精度值为20m。当定位得到的精度不符合条件时，在timeout之前会继续定位，尝试拿到符合要求的定位结果。 可选值： high：期望精度值为100m best：期望精度值为20m

输出

success返回对象的扩展属性：

名称	数据类型	描述
latitude	number	纬度，范围为-90~90，正数表示北，负数表示南
longitude	number	经度，范围为-180~180，正数表示东，负数表示西
accuracy	number	位置的精确度 待开发 Android/iOS 均返回水平精度
verticalAccuracy	number	垂直精度，单位 m 待开发 Android 无法获取，返回 0
horizontalAccuracy	number	待开发 水平精度，单位 m
authorizationAccuracy	string	指示应用程序有权使用的位置准确性级别。 待开发 可选值： reduced：非精确位置授权 full：精确位置授权
timestamp	number	定位数据的时间戳，单位 ms

示例代码

bz.getLocation({
    "type": "gcj02",
    "timeout": 5,
    "cacheTimeout": 30,
    "accuracy": "best",
    success(res) {
      console.log(JSON.stringify(res));
    },
    fail(res) {
      console.log(`getLocation fail: ${JSON.stringify(res)}`);
    }
});

success返回对象示例：

{
    "authorizationAccuracy": "full",
    "latitude": 30.48318898654514,
    "errMsg": "getLocation:ok",
    "longitude": 120.03518184678819,
    "accuracy": 148,
    "horizontalAccuracy": 148,
    "verticalAccuracy": 13.574329376220703,
    "timestamp": 1637490791204
}