Skip to content

startGeolocation 持续获取地理位置(废弃)

接口说明

连续获取当前地理位置信息(持续定位)

参数说明
名称类型是否必填示例值描述
targetAccuracyNumber期望定位精度半径(单位米) 定位结果尽量满足该参数要求,不保证小于该误差,开发者需要读取返回结果的 accuracy 字段校验坐标精度; 建议按照业务需求设置定位精度,推荐采用200m,可获得较好的精度和较短的响应时长
iOSDistanceFilterNumberiOS端位置变更敏感度,单位为m,此值会影响iOS端callback回调速率
useCacheBoolean是否缓存地理位置信息,默认是true。 设置true,客户端缓存定位的地理位置信息,在缓存期内(分钟)再次定位会返回旧的定位; 设置false,不缓存地址位置信息
withReGeocodeBoolean是否需要带有逆地理编码信息; 该功能需要网络请求,请根据自己的业务场景使用
callBackIntervalNumber数据回传最小时间间隔,单位ms
sceneIdString定位场景id;不同scenceId互不影响
onSuccessFunction连续定位调用callback
onFailFunction定位失败回调

返回参数

名称类型示例值描述
longitudeNumber经度
latitudeNumber纬度
accuracyNumber实际的定位精度半径(单位米)
addressString格式化地址,如:北京市朝阳区南磨房镇北京国家广告产业园区
provinceString省份,如:北京市
cityString城市,直辖市会返回空
districtString行政区,如:朝阳区
roadString街道,如:西大望路甲12-2号楼
netTypeString当前设备网络类型,如:wifi、3g等
operatorTypeString当前设备使用移动运营商,如:CMCC等
errorMessageString对错误码的描述
errorCodeNumber错误码;若errorCode=13,表示持续定位已开启,非业务异常,不影响正常使用
isWifiEnabledBoolean仅Android支持,wifi设置是否开启,不保证已连接上
isGpsEnabledBoolean仅Android支持,gps设置是否开启,不保证已连接上
isFromMockBoolean仅Android支持,定位返回的经纬度是否是模拟的结果
providerString仅Android支持,我们使用的是混合定位,具体定位提供者有wifi/lbs/gps这三种
isMobileEnabledBoolean仅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 => { })