Appearance
startGeolocation 持续获取地理位置(废弃)
接口说明
连续获取当前地理位置信息(持续定位)
参数说明
名称 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
targetAccuracy | Number | 否 | 期望定位精度半径(单位米) 定位结果尽量满足该参数要求,不保证小于该误差,开发者需要读取返回结果的 accuracy 字段校验坐标精度; 建议按照业务需求设置定位精度,推荐采用200m,可获得较好的精度和较短的响应时长 | |
iOSDistanceFilter | Number | 否 | iOS端位置变更敏感度,单位为m,此值会影响iOS端callback回调速率 | |
useCache | Boolean | 否 | 是否缓存地理位置信息,默认是true。 设置true,客户端缓存定位的地理位置信息,在缓存期内(分钟)再次定位会返回旧的定位; 设置false,不缓存地址位置信息 | |
withReGeocode | Boolean | 否 | 是否需要带有逆地理编码信息; 该功能需要网络请求,请根据自己的业务场景使用 | |
callBackInterval | Number | 否 | 数据回传最小时间间隔,单位ms | |
sceneId | String | 是 | 定位场景id;不同scenceId互不影响 | |
onSuccess | Function | 否 | 连续定位调用callback | |
onFail | Function | 否 | 定位失败回调 |
返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
longitude | Number | 经度 | |
latitude | Number | 纬度 | |
accuracy | Number | 实际的定位精度半径(单位米) | |
address | String | 格式化地址,如:北京市朝阳区南磨房镇北京国家广告产业园区 | |
province | String | 省份,如:北京市 | |
city | String | 城市,直辖市会返回空 | |
district | String | 行政区,如:朝阳区 | |
road | String | 街道,如:西大望路甲12-2号楼 | |
netType | String | 当前设备网络类型,如:wifi、3g等 | |
operatorType | String | 当前设备使用移动运营商,如:CMCC等 | |
errorMessage | String | 对错误码的描述 | |
errorCode | Number | 错误码;若errorCode=13,表示持续定位已开启,非业务异常,不影响正常使用 | |
isWifiEnabled | Boolean | 仅Android支持,wifi设置是否开启,不保证已连接上 | |
isGpsEnabled | Boolean | 仅Android支持,gps设置是否开启,不保证已连接上 | |
isFromMock | Boolean | 仅Android支持,定位返回的经纬度是否是模拟的结果 | |
provider | String | 仅Android支持,我们使用的是混合定位,具体定位提供者有wifi/lbs/gps这三种 | |
isMobileEnabled | Boolean | 仅Android支持,移动网络是设置是否开启,不保证已连接上 |
用法示例
javascript
SZHN_HZT_SDK.startGeolocation({
// 期望定位精度半径(单位米)
targetAccuracy: 500,
// iOS端位置变更敏感度,单位为m,此值会影响iOS端callback回调速率
iOSDistanceFilter: 100,
useCache: true,
// 是否需要带有逆地理编码信息;
withReGeocode: false,
// 数据回传最小时间间隔,单位ms
callBackInterval: 1000,
sceneId: "1234",
onSuccess: (geoResult) => {
/* {
accuracy: 29
address: "广东省广州市天河区潭乐街159号靠近广电平云广场B塔"
city: "广州市"
district: "天河区"
errorCode: 0
errorMessage: "success"
isFromMock: false
isGpsEnabled: true
isMobileEnabled: false
isWifiEnabled: true
latitude: 23.118506
longitude: 113.351249
netType: "WIFI"
operatorType: ""
provider: "lbs"
province: "广东省"
road: "潭乐街"
}
*/
},
onFail: (error) => {
console.log(error)
}
}).then(res => {
console.log(res)
}).catch(err => { })