qg.getLocation(Object object)
获取地理位置
参数 Object object
属性 | 类型 | 必填 | 说明 |
---|
altitude | String | 否 | 默认 false,传入 true 会返回高度信息,由于获取高度需要较高精确度,会减慢接口返回速度 |
success | Function(Object res) | 是 | 成功回调 |
fail | Function | 否 | 失败回调,原因可能是用户拒绝 |
complete | Function | 否 | 执行结束后的回调 |
success 回调函数的参数 Object res
属性 | 类型 | 说明 |
---|
longitude | Number | 经度,范围为 -180~180,负数表示西经 |
latitude | Number | 纬度,范围为 -90~90,负数表示南纬 |
speed | Number | 速度,单位 m/s |
accuracy | Number | 位置的精确度 |
altitude | Number | 高度,单位 m |
verticalAccuracy | Number | 垂直精度,单位 m(Android 无法获取,返回 0) |
horizontalAccuracy | Number | 水平精度,单位 m |
qg.subscribeLocation(Object object) (1090+)
监听地理位置。如果多次调用,仅最后一次调用生效
参数 Object object
属性 | 类型 | 必填 | 说明 |
---|
callback | Function | 是 | 默认 false,传入 true 会返回高度信息,由于获取高度需要较高精确度,会减慢接口返回速度 |
fail | Function | 否 | 成功回调 |
callback 回调参数:Object data
属性 | 类型 | 说明 |
---|
longitude | Number | 经度 |
latitude | Number | 纬度 |
fail 返回错误代码
错误码 | 说明 |
---|
201 | 用户拒绝,获取定位权限失败 |
1000 | 系统位置开关关闭 |
示例
qg.subscribeLocation({
callback: function(data) {
console.log(
`handling success: longitude = ${data.longitude}, latitude = ${data.latitude}`
);
},
fail: function(data, code) {
console.log(`handling fail, code = ${code}`);
}
});
qg.unsubscribeLocation() (1090+)
取消监听地理位置
参数
无
示例
qg.unsubscribeLocation();