wx.getLocation(Object object)

本接口从基础库版本 1.9.6 起支持在小程序插件中使用

调用前需要 用户授权 scope.userLocation

获取当前的地理位置、速度。当用户离开小程序后,此接口无法调用。开启高精度定位,接口耗时会增加,可指定 highAccuracyExpireTime 作为超时时间。地图相关使用的坐标格式应为 gcj02。

参数

Object object

属性类型默认值必填说明最低版本
typestringwgs84wgs84 返回 gps 坐标,gcj02 返回可用于 wx.openLocation 的坐标
altitudestringfalse传入 true 会返回高度信息,由于获取高度需要较高精确度,会减慢接口返回速度1.6.0
isHighAccuracybooleanfalse开启高精度定位2.9.0
highAccuracyExpireTimenumber高精度定位超时时间(ms),指定时间内返回最高精度,该值3000ms以上高精度定位才有效果2.9.0
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

参数
Object res
属性类型说明最低版本
latitudenumber纬度,范围为 -90~90,负数表示南纬
longitudenumber经度,范围为 -180~180,负数表示西经
speednumber速度,单位 m/s
accuracynumber位置的精确度
altitudenumber高度,单位 m1.2.0
verticalAccuracynumber垂直精度,单位 m(Android 无法获取,返回 0)1.2.0
horizontalAccuracynumber水平精度,单位 m1.2.0

示例代码

  1. wx.getLocation({
  2. type: 'wgs84',
  3. success (res) {
  4. const latitude = res.latitude
  5. const longitude = res.longitude
  6. const speed = res.speed
  7. const accuracy = res.accuracy
  8. }
  9. })

注意

  • 工具中定位模拟使用IP定位,可能会有一定误差。且工具目前仅支持 gcj02 坐标。
  • 使用第三方服务进行逆地址解析时,请确认第三方服务默认的坐标系,正确进行坐标转换。