更新记录

1.0.0（2026-10-09）

新版发布。

平台兼容性

uni-app(4.64)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
√ √ × × √ √ × × √
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
× × × × × × × × × × × ×

uni-app x(4.87)

Chrome Safari Android iOS 鸿蒙 微信小程序
× × × × √ ×

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
× × × √

【鸿蒙】部网络货运信息交互系统位置信息单SDK插件2.0接口文档

1. 货运UTS插件

<script>

    //货运UTS插件
    import * as Hdgq from "@/uni_modules/Lizii-HdgqHar";

    export default {
    }

</script>

2. 检查定位服务是否打开

//检查定位服务是否打开
let enable = Hdgq.locationServicesEnabled();//true:定位服务打开 false:定位服务关闭

3. 进入打开定位服务界面

//进入打开定位服务界面
Hdgq.openLocationSetting();

4. 检查定位权限

//检查定位权限是否授权，并申请定位权限
Hdgq.checkLocationPermission(function(res){
    console.log(res);
    if (res.result == true) {

    } else {
        //打开app设置界面 设置始终定位权限
        Hdgq.openAppSetting();
    }
});

5. 打开app设置界面

//打开app设置界面
Hdgq.openAppSetting();

6、授权接口，SDK2.1.1版本之后，appId必需和app包名保持一致

let appId = "";//网络货运企业APP的唯一标识
let appSecurity = "";//网络货运企业在省平台申请的接入安全码
let enterpriseSenderCode = "";//网络货运企业在省平台申请的企业发送代码
let environment = "debug";//正式环境release，测试环境debug
Hdgq.auth(appId, appSecurity, enterpriseSenderCode, environment, function(res){
    console.log(res);
    if (res.type == "onSuccess") {
        //成功
    } else if (res.type == "onFailure"){
        //失败
        let errorCode = res.data.errorCode;//错误码
        let errorMsg = res.data.errorMsg;//错误描述
    }
});

7、开启定位

let vehicleNumber = "浙A8XXXX";//车牌号
let driverName = "王师傅";//司机姓名
let remark = "测试";//备注
let shippingNoteInfos = [{
    shippingNoteNumber:"YD20211012",//运单号
    serialNumber:"0000",//分单号
    startCountrySubdivisionCode:"330108",//起点位置行政区划代码，调 用 start/stop/pause/restart 时 必填，调用 send 非必填
    endCountrySubdivisionCode:"330205",//到达位置行政区划代码，调 用 start/stop/pause/restart 时 必填，调用 send 非必填
    startLongitude:"120.152193",//起点位置经度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    startLatitude:"30.281367",//起点位置纬度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    endLongitude:"121.552812",//到达位置经度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    endLatitude:"29.885021",//到达位置纬度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    startLocationText:"杭州",//起点地址文字描述，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    endLocationText:"宁波",//到达地址文字描述，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    vehicleNumber:"浙A8XXXX",//车牌号，SDK 回调返回，调 用 start/stop/pause/restart/必 填，send 时非必填
    driverName:"王师傅",//司机姓名，SDK 回调返回， 调用 start/stop/pause/restart/ 必填，send 时非必填
    interval:"5000"//请求时间间隔，SDK 回调返 回(单位 ms)
}];//运单信息列表
Hdgq.start(vehicleNumber, driverName, remark, shippingNoteInfos, function(res){
    console.log(res);
    if (res.type == "onSuccess") {
        //成功
        let shippingNoteInfos = res.data;//运单信息列表
    } else if (res.type == "onFailure"){
        //失败
        let errorCode = res.data.errorCode;//错误码
        let errorMsg = res.data.errorMsg;//错误描述
    }
});

8、发送定位

let vehicleNumber = "浙A8XXXX";//车牌号
let driverName = "王师傅";//司机姓名
let remark = "测试";//备注
let shippingNoteInfos = [{
    shippingNoteNumber:"YD20211012",//运单号
    serialNumber:"0000",//分单号
    startCountrySubdivisionCode:"330108",//起点位置行政区划代码，调 用 start/stop/pause/restart 时 必填，调用 send 非必填
    endCountrySubdivisionCode:"330205",//到达位置行政区划代码，调 用 start/stop/pause/restart 时 必填，调用 send 非必填
    startLongitude:"120.152193",//起点位置经度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    startLatitude:"30.281367",//起点位置纬度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    endLongitude:"121.552812",//到达位置经度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    endLatitude:"29.885021",//到达位置纬度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    startLocationText:"杭州",//起点地址文字描述，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    endLocationText:"宁波",//到达地址文字描述，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    vehicleNumber:"浙A8XXXX",//车牌号，SDK 回调返回，调 用 start/stop/pause/restart/必 填，send 时非必填
    driverName:"王师傅",//司机姓名，SDK 回调返回， 调用 start/stop/pause/restart/ 必填，send 时非必填
    interval:"5000"//请求时间间隔，SDK 回调返 回(单位 ms)
}];//运单信息列表
Hdgq.send(vehicleNumber, driverName, remark, shippingNoteInfos, function(res){
    console.log(res);
    if (res.type == "onSuccess") {
        //成功
        let shippingNoteInfos = res.data;//运单信息列表
    } else if (res.type == "onFailure"){
        //失败
        let errorCode = res.data.errorCode;//错误码
        let errorMsg = res.data.errorMsg;//错误描述
    }
});

9、暂停定位

let vehicleNumber = "浙A8XXXX";//车牌号
let driverName = "王师傅";//司机姓名
let remark = "测试";//备注
let shippingNoteInfos = [{
    shippingNoteNumber:"YD20211012",//运单号
    serialNumber:"0000",//分单号
    startCountrySubdivisionCode:"330108",//起点位置行政区划代码，调 用 start/stop/pause/restart 时 必填，调用 send 非必填
    endCountrySubdivisionCode:"330205",//到达位置行政区划代码，调 用 start/stop/pause/restart 时 必填，调用 send 非必填
    startLongitude:"120.152193",//起点位置经度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    startLatitude:"30.281367",//起点位置纬度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    endLongitude:"121.552812",//到达位置经度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    endLatitude:"29.885021",//到达位置纬度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    startLocationText:"杭州",//起点地址文字描述，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    endLocationText:"宁波",//到达地址文字描述，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    vehicleNumber:"浙A8XXXX",//车牌号，SDK 回调返回，调 用 start/stop/pause/restart/必 填，send 时非必填
    driverName:"王师傅",//司机姓名，SDK 回调返回， 调用 start/stop/pause/restart/ 必填，send 时非必填
    interval:"5000"//请求时间间隔，SDK 回调返 回(单位 ms)
}];//运单信息列表
Hdgq.pause(vehicleNumber, driverName, remark, shippingNoteInfos, function(res){
    console.log(res);
    if (res.type == "onSuccess") {
        //成功
        let shippingNoteInfos = res.data;//运单信息列表
    } else if (res.type == "onFailure"){
        //失败
        let errorCode = res.data.errorCode;//错误码
        let errorMsg = res.data.errorMsg;//错误描述
    }
});

10、重启定位

let vehicleNumber = "浙A8XXXX";//车牌号
let driverName = "王师傅";//司机姓名
let remark = "测试";//备注
let shippingNoteInfos = [{
    shippingNoteNumber:"YD20211012",//运单号
    serialNumber:"0000",//分单号
    startCountrySubdivisionCode:"330108",//起点位置行政区划代码，调 用 start/stop/pause/restart 时 必填，调用 send 非必填
    endCountrySubdivisionCode:"330205",//到达位置行政区划代码，调 用 start/stop/pause/restart 时 必填，调用 send 非必填
    startLongitude:"120.152193",//起点位置经度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    startLatitude:"30.281367",//起点位置纬度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    endLongitude:"121.552812",//到达位置经度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    endLatitude:"29.885021",//到达位置纬度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    startLocationText:"杭州",//起点地址文字描述，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    endLocationText:"宁波",//到达地址文字描述，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    vehicleNumber:"浙A8XXXX",//车牌号，SDK 回调返回，调 用 start/stop/pause/restart/必 填，send 时非必填
    driverName:"王师傅",//司机姓名，SDK 回调返回， 调用 start/stop/pause/restart/ 必填，send 时非必填
    interval:"5000"//请求时间间隔，SDK 回调返 回(单位 ms)
}];//运单信息列表
Hdgq.restart(vehicleNumber, driverName, remark, shippingNoteInfos, function(res){
    console.log(res);
    if (res.type == "onSuccess") {
        //成功
        let shippingNoteInfos = res.data;//运单信息列表
    } else if (res.type == "onFailure"){
        //失败
        let errorCode = res.data.errorCode;//错误码
        let errorMsg = res.data.errorMsg;//错误描述
    }
});

11、停止定位

let vehicleNumber = "浙A8XXXX";//车牌号
let driverName = "王师傅";//司机姓名
let remark = "测试";//备注
let shippingNoteInfos = [{
    shippingNoteNumber:"YD20211012",//运单号
    serialNumber:"0000",//分单号
    startCountrySubdivisionCode:"330108",//起点位置行政区划代码，调 用 start/stop/pause/restart 时 必填，调用 send 非必填
    endCountrySubdivisionCode:"330205",//到达位置行政区划代码，调 用 start/stop/pause/restart 时 必填，调用 send 非必填
    startLongitude:"120.152193",//起点位置经度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    startLatitude:"30.281367",//起点位置纬度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    endLongitude:"121.552812",//到达位置经度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    endLatitude:"29.885021",//到达位置纬度，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    startLocationText:"杭州",//起点地址文字描述，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    endLocationText:"宁波",//到达地址文字描述，调用 start/stop/pause/restart 时必 填，调用 send 非必填
    vehicleNumber:"浙A8XXXX",//车牌号，SDK 回调返回，调 用 start/stop/pause/restart/必 填，send 时非必填
    driverName:"王师傅",//司机姓名，SDK 回调返回， 调用 start/stop/pause/restart/ 必填，send 时非必填
    interval:"5000"//请求时间间隔，SDK 回调返 回(单位 ms)
}];//运单信息列表
Hdgq.stop(vehicleNumber, driverName, remark, shippingNoteInfos, function(res){
    console.log(res);
    if (res.type == "onSuccess") {
        //成功
        let shippingNoteInfos = res.data;//运单信息列表
    } else if (res.type == "onFailure"){
        //失败
        let errorCode = res.data.errorCode;//错误码
        let errorMsg = res.data.errorMsg;//错误描述
    }
});

隐私、权限声明

1. 本插件需要申请的系统权限列表：

定位权限

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

插件自身不采集任何数据，插件使用的定位 SDK采集数据请参考其官方说明：http://wlhy.mot.gov.cn

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

评论列表 撰写评论 向官方投诉

暂无用户评论。