获取当前的地理位置、速度。
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| type | String | wgs84 | 否 | wgs84 返回 gps 坐标，gcj02 返回可用于 qg.openLocation 的坐标 |
| altitude | Boolean | false | 否 | 传入 true 会返回高度信息，由于获取高度需要较高精确度，会减慢接口返回速度 |
| isHighAccuracy | Boolean | false | 否 | 开启高精度定位 |
| highAccuracyExpireTime | Number | 否 | 高精度定位超时时间(ms)，指定时间内返回最高精度，该值 3000ms 以上高精度定位才有效果 | |
| success | Function | 否 | 接口调用成功的回调函数 | |
| fail | Function | 否 | 接口调用失败的回调函数 | |
| complete | Function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
| 属性 | 类型 | 说明 |
|---|---|---|
| latitude | Number | 纬度，范围为 -90~90，负数表示南纬 |
| longitude | Number | 经度，范围为 -180~180，负数表示西经 |
| speed | Number | 速度，单位 m/s |
| accuracy | Number | 位置的精确度，反应与真实位置之间的接近程度，可以理解成 10 即与真实位置相差 10m，越小越精确 |
| altitude | Number | 高度，单位 m |
| verticalAccuracy | Number | 垂直精度，单位 m（Android 无法获取，返回 0） |
| horizontalAccuracy | Number | 水平精度，单位 m |
qg.getLocation({
type: "wgs84",
success(res) {
const latitude = res.latitude;
const longitude = res.longitude;
const speed = res.speed;
const accuracy = res.accuracy;
}
});
注意 工具中定位模拟使用 IP 定位，可能会有一定误差。且工具目前仅支持 gcj02 坐标。 使用第三方服务进行逆地址解析时，请确认第三方服务默认的坐标系，正确进行坐标转换。
监听地理位置。如果多次调用，仅最后一次调用生效
Object object
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| callback | Function | 是 | 每次位置信息发生变化，都会被回调 |
| fail | Function | 否 | 失败回调，原因可能是用户拒绝 |
callback 回调参数：Object data
| 属性 | 类型 | 说明 |
|---|---|---|
| longitude | Number | 经度 |
| latitude | Number | 纬度 |
fail
| 错误码 | 说明 |
|---|---|
| 200 | 未获取到位置信息 |
| 201 | 用户拒绝，获取定位权限失败 |
| 203 | 无网络或者定位服务关闭 |
| 204 | 定位超时 |
| 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();