ek.getLocation
支持 Promise
需要用户授权
scope.userLocation
。
获取当前的地理位置、速度。当用户离开小程序后,此接口无法调用。开启高精度定位,接口耗时会增加,可指定 highAccuracyExpireTime 作为超时时间。地图相关使用的坐标格式应为 gcj02。 高频率调用会导致耗电,如有需要可使用持续定位接口 ek.onLocationChange。
参数
参数 | 类型 | 默认值 | 必填 | 说明 | |||||||
---|---|---|---|---|---|---|---|---|---|---|---|
type | string | wgs84 | 否 | 返回的 gps 坐标系 | |||||||
| |||||||||||
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 |
horizontalAccuracy | number | 水平精度,单位 m |
Example
ts
const res = await ek.getLocation({
type: 'gcj02'
})
console.log(res.latitude, res.longitude)