宇信科技-新一代移动金融开发平台YUMP

# Location

# getCurrentPosition

获取经纬度

  • 支持平台
Android IOS HarmonyOS
√ √ √
  • 参数说明
参数名 类型 必填 说明
completedCB Function 是 请求完成回调函数，成功/失败都会触发
option optionData 可选 获取位置信息参数，详见下表
  • optionData参数说明
参数名 类型 必填 说明
enableHighAccuracy String 否 是否高精确度获取位置信息，默认是"1"，高精确度获取位置信息。字符串"0":不获取高精度。字符串"1":获取高精度值
timeout Number 否 获取位置信息的超时时间,单位（秒）默认值30
maximumAge Number 否 获取位置信息的间隔时间,单位（秒）默认30
geocode String 否 是否进行地址反编码"1":返回地理位置信息+经纬度,"0":只返回经纬度，默认"0"
  • completedCB返回参数说明
参数名 类型 说明
status Number 调用状态码 0:成功，失败请查看全局状态码
message String 调用结果信息
payload Object 详细结果
  • 返回payload参数说明
参数名 类型 说明
coords Object 经，纬度, 详见下表
time Number 更新时间
address Object 位置信息(根据geocode的值决定是否需要返回),详见下表
coordsType String 高德地图使用的坐标系GCJ-02
  • 返回coords参数说明
参数名 类型 说明
latitude String 纬度
longitude String 经度
  • 返回address参数说明
参数名 类型 说明
provinceName String 省
cityName String 市
cityCode String 城市编码
districtName String 区
adcode String 区域编码
street String 街道名称
  • 示例代码

//不传位置信息参数
foxsdk.location.getCurrentPosition(ret => {
    console.log('location/getCurrentPosition===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
});

//添加位置信息参数设置
foxsdk.location.getCurrentPosition(ret => {
    console.log('location/index.vue2===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
}, {geocode: '1'});

# checkGpsOpen

检查gps服务是否开启。

示例

foxsdk.location.checkGpsOpen(res => {
    console.log('app/checkGpsOpen===', JSON.stringify(res));
})

success 返回参数说明

参数 类型 说明
locationIsOpen string '1',系统定位开关打开,'0',系统定位开关关闭

# watchPosition

监听设备位置变化信息

  • 支持平台
Android IOS HarmonyOS
√ √ ×
  • 参数说明
参数名 类型 必填 说明
completedCB Function 是 请求完成回调函数，成功/失败都会触发
option optionData 可选 获取位置信息参数，详见下表
  • optionData参数说明
参数名 类型 必填 说明
enableHighAccuracy String 否 是否高精确度获取位置信息，默认是"1"，高精确度获取位置信息。字符串"0":不获取高精度。字符串"1":获取高精度值
timeout Boolean 否 获取位置信息的超时时间,单位（秒）默认值30
maximumAge Number 否 获取位置信息的间隔时间,单位（秒）默认30
geocode String 否 是否进行地址反编码"1":返回地理位置信息+经纬度,"0":只返回经纬度，默认"0"
  • completedCB返回参数说明
参数名 类型 说明
status Number 调用状态码,0成功, 1持续监听有位置变化回调一次callback，失败请查看全局状态码
message String 调用结果信息
payload String 详细结果，见下表
  • 返回payload参数说明
参数名 类型 说明
coords Object 经，纬度, 详见下表
time Number 更新时间
address Object 位置信息(根据geocode的值决定是否需要返回),详见下表
coordsType String 高德地图使用的坐标系GCJ-02
  • 返回coords参数说明
参数名 类型 说明
latitude String 经度
longitude String 经度
  • 返回address参数说明
参数名 类型 说明
provinceName String 省
cityName String 市
cityCode String 城市编码
districtName String 区
adcode String 区域编码
street String 街道名称
  • 示例代码

let options = {
    enableHighAccuracy: '1',
    timeout: 30,
    maximumAge: 5,
    coordsType: 'GCJ-02',
    geocode: '0'
};
let watchId1 = foxsdk.location.watchPosition(ret => {
    console.log('location/watchPosition1===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
}, options);

# clearWatch

取消监听设备位置变化信息

  • 支持平台
Android IOS HarmonyOS
√ √ ×
  • 参数说明
参数名 类型 必填 说明
watchId String 是 需要取消的位置监听器标识，调用watchPosition方法的返回值
completedCB Function 可选 请求完成回调函数，成功/失败都会触发
  • completedCB返回参数说明
参数名 类型 说明
status Number 调用状态码,0成功, 失败请查看全局状态码
message String 调用结果信息
payload String 无结果
  • 示例代码

foxsdk.location.clearWatch(watchId1, ret => {
    console.log('location/clearWatch===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
})

# clearWatchall

取消所有监听设备位置变化信息

  • 支持平台
Android IOS HarmonyOS
√ √ ×
  • 参数说明
参数名 类型 必填 说明
completedCB Function 可选 请求完成回调函数，成功/失败都会触发
  • completedCB返回参数说明
参数名 类型 说明
status Number 调用状态码,0成功, 失败请查看全局状态码
message String 调用结果信息
payload String 无结果
  • 示例代码

foxsdk.location.clearWatchAll(ret => {
    console.log('location/index.vue===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
})

# openMap

打开地图（）

  • 支持平台
Android IOS HarmonyOS
√ √ ×
  • 参数说明
参数名 类型 必填 说明
completedCB Function 是 请求完成回调函数，成功/失败都会触发
data Object 可选 获取位置信息参数，详见下表
  • completedCB返回参数说明
参数名 类型 说明
status Number 调用状态码,0成功, 失败请查看全局状态码
message String 调用结果信息
payload optionData 回调详情，见下表
  • 示例代码

let data = {};
foxsdk.location.openMap(data,ret => {
    console.log('location/index.vue===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
})

打开地图导航

  • 支持平台
Android IOS HarmonyOS
√ √ ×
  • 参数说明
参数名 类型 必填 说明
completedCB Function 是 请求完成回调函数，成功/失败都会触发
data Object 可选 获取位置信息参数，详见下表
  • data参数说明
参数名 类型 必填 说明
longitude String 是 经度
latitude String 是 纬度
  • completedCB返回参数说明
参数名 类型 说明
status Number 调用状态码,0成功, 失败请查看全局状态码
message String 调用结果信息
payload optionData 回调详情，见下表
  • 示例代码

let data = {
    longitude:'120.0021',
    latitude:'22.00'
};

foxsdk.location.navigate(data,ret => {
    console.log('location/index.vue===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
})

# getLocation

  • 支持平台
Android IOS HarmonyOS
√ √ √
  • 参数说明
参数名 类型 必填 说明
completedCB Function 可选 请求完成回调函数，成功/失败都会触发
  • completedCB返回参数说明
参数名 类型 说明
status Number 调用状态码,0成功, 失败请查看全局状态码
message String 调用结果信息
payload String 调用返回的经纬度
  • payload返回参数说明
参数名 类型 说明
latitude String 纬度
longitude String 经度
coordsType String 高德地图使用的坐标系GCJ-02
  • 示例代码

foxsdk.location.getLocation(ret => {
    console.log('location/index.vue===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
})
Last Updated: 3/19/2024, 2:45:59 PM

← 人脸活体/二代证 →