Skip to content
On this page

ek.getLocation

支持 Promise

需要用户授权 scope.userLocation

获取当前的地理位置、速度。当用户离开小程序后,此接口无法调用。开启高精度定位,接口耗时会增加,可指定 highAccuracyExpireTime 作为超时时间。地图相关使用的坐标格式应为 gcj02。 高频率调用会导致耗电,如有需要可使用持续定位接口 ek.onLocationChange

参数

参数类型默认值必填说明
typestringwgs84返回的 gps 坐标系
合法值说明
wgs84地球坐标
gcj02火星坐标
altitudebooleanfalse传入 true 会返回高度信息
isHighAccuracybooleanfalse开启高精度定位
highAccuracyExpireTimenumber高精度定位超时时间(ms),指定时间内返回最高精度,该值3000ms以上高精度定位才有效果
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

成功返回

属性类型说明
latitudenumber纬度,范围为 -90~90,负数表示南纬
longitudenumber经度,范围为 -180~180,负数表示西经
speednumber速度,单位 m/s
accuracynumber位置的精确度,反应与真实位置之间的接近程度,可以理解成10即与真实位置相差10m,越小越精确
altitudenumber高度,单位 m
verticalAccuracynumber垂直精度,单位 m
horizontalAccuracynumber水平精度,单位 m

Example

ts
const res = await ek.getLocation({
  type: 'gcj02'
})
console.log(res.latitude, res.longitude)