小程序开放平台

文档中心
基础
转发
界面
网络
数据缓存
渲染
媒体
文件
开放接口
设备
跳转
位置
getLocation
startLocationUpdate
startLocationUpdateBackground
stopLocationUpdate
onLocationChange
chooseLocation
openLocation
支付

xhs.getLocation

开发
>
JS API
>
位置
>
getLocation
>
更新时间:2024-11-14 11:47:48

以Promise风格调用: 支持

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

参数

Object object

属性
类型
默认值
必填
说明
typestringwgs84wgs84 返回 gps 坐标,gcj02 返回可用于 xhs.openLocation 的坐标。iOS支持
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

属性
类型
说明
latitudenumber纬度,范围为 -90~90,负数表示南纬
longitudenumber经度,范围为 -180~180,负数表示西经
speednumber速度,单位 m/s
accuracynumber位置的精确度
altitudenumber高度,单位 m
verticalAccuracynumber垂直精度,单位 m(Android 无法获取,返回 0)
horizontalAccuracynumber水平精度,单位 m(iOS 无法获取,返回 0)
errMsgstring
该文档是否对您有帮助?