地理位置

getLocationInfo

使用说明

客户端	Android	iOS	PC
支持说明	支持	支持	/

const params = {
    coordinate:1,
    withReGeocode:true
}
window.ksoxz_sdk.getLocationInfo({params, onSuccess, onError})

参数说明

参数	类型	是否必须	描述	备注
coordinate	number	否	坐标系类型	0：wgs84 坐标系 1：gcj02 坐标系 默认为 gcj02 坐标系
withReGeocode	bolean	否	是否需要逆编码信息	默认为是

返回结果

参数	类型	是否必须	描述	备注
longitude	number	是	经度	字符串,按需截取和转换
latitude	number	是	维度	字符串,按需截取和转换
address	object	否	逆编码位置信息	标准 gps 坐标获取无此字段返回

adress:

参数	类型	是否必须	描述	备注
description	string	否	地理位置逆编码信息	如:湖北省武汉市洪山区雄庄路 100 号光谷 app 广场 2 号楼
provice	string	否	省	如:湖北省
city	string	否	城市	如:武汉市; 直辖市为空
district	string	否	行政区	如:洪山区
road	string	否	街道	如:雄庄路 100 号

startLocationUpdate

startLocationUpdate(Object object) 用于在开启网页应用（在前台时）接收位置更新消息。

使用说明

客户端	Android	iOS	PC
支持说明	支持	支持	/

window.ksoxz_sdk.startLocationUpdate({ params, onSuccess, onError });

参数说明

参数	类型	是否必须	描述	备注
type	number	否	坐标系类型	0：wgs84 坐标系 1：gcj02 坐标系 默认为 gcj02 坐标系

错误码

errno	msg	含义
1021002	GPS permission not obtained	用户未授予 App 定位权限
1022102	GPS is disabled	GPS 未打开
1501001	continuous location service has started	持续定位服务已启动

stopLocationUpdate

stopLocationUpdate(Object object) 用于关闭监听实时位置变化，停止位置消息接收。

使用说明

客户端	Android	iOS	PC
支持说明	支持	支持	/

window.ksoxz_sdk.stopLocationUpdate({ params, onSuccess, onError });

onLocationChange

监听实时地理位置变化事件，需结合 startLocationUpdate 使用。

使用说明

客户端	Android	iOS	PC
支持说明	支持	支持	/

window.ksoxz_sdk.startLocationUpdate({ params, onSuccess, onError })
window.ksoxz_sdk.onLocationChange(callback)

返回结果

参数	类型	描述	备注
latitude	number	纬度	范围为-90~90，正数表示北，负数表示南
longitude	number	经度	范围为-180~180，正数表示东，负数表示西
accuracy	number	位置的精确度，单位 m	iOS 返回水平精确度与垂直精确度中较大的值 Android 返回水平精确度值
verticalAccuracy	number	垂直精度，单位 m	安卓无法获取此值，返回 0
horizontalAccuracy	number	水平精度，单位 m	/
timestamp	number	定位时间戳，单位 ms	/

offLocationChange

移除持续定位接口返回失败时触发的监听函数

使用说明

客户端	Android	iOS	PC
支持说明	支持	支持	/

该接口需要与 onLocationChange 接口配套使用。

window.ksoxz_sdk.offLocationChange(callback)