更新记录

1.1(2023-02-20)

插件兼容勾选百度定位模块。

1.0(2022-03-15)

新版


平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 14.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 适用版本区间:9 - 17

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


部网络货运信息交互系统位置信息单SDK插件接口说明

插件集成准备

  1. manifest.json中App原生插件配置云端插件选择试用或购买的插件。
  2. manifest.json中App模块配置,勾选Geolocation(定位),再勾选百度定位模块,并设置Android端和iOS端的百度定位appkey。
  3. 制作uniapp自定义调试基座,运行到手机设备进行调试。注:基座打包完成后,建议卸载基座后重新运行安装基座调试

注意:SDK2.1.1版本之后,部网络货运的appId和Android的包名、iOS的BundleID保持一致

插件接口API

1、插件对象

//插件对象
var sdkwx = uni.requireNativePlugin('Hdgq-BDLoc');

onLoad() {  
    //隐私合规接口
    var isAgree = true;//隐私权政策是否取得用户同意  true是用户同意
    sdkwx.setAgreePrivacy(isAgree);

    //检查定位权限
    sdkwx.checkLocationPermission(function(res){
        console.log(res);
    });
}

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

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

3、启用定位

var vehicleNumber = "浙A8XXXX";//车牌号
var driverName = "王师傅";//司机姓名
var remark = "测试";//备注
var 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)                
}];//运单信息列表
sdkwx.start(vehicleNumber, driverName, remark, shippingNoteInfos, function(res){
    console.log(res);
    if (res.type == "onSuccess") {
        //成功
        var shippingNoteInfos = res.data;//运单信息列表
    } else if (res.type == "onFailure"){
        //失败
        var errorCode = res.data.errorCode;//错误码
        var errorMsg = res.data.errorMsg;//错误描述
    }   
});         

4、发送定位

var vehicleNumber = "浙A8XXXX";//车牌号
var driverName = "王师傅";//司机姓名
var remark = "测试";//备注
var 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)                
}];//运单信息列表
sdkwx.send(vehicleNumber, driverName, remark, shippingNoteInfos, function(res){
    console.log(res);
    if (res.type == "onSuccess") {
        //成功
        var shippingNoteInfos = res.data;//运单信息列表
    } else if (res.type == "onFailure"){
        //失败
        var errorCode = res.data.errorCode;//错误码
        var errorMsg = res.data.errorMsg;//错误描述
    }   
});

5、暂停定位

var vehicleNumber = "浙A8XXXX";//车牌号
var driverName = "王师傅";//司机姓名
var remark = "测试";//备注
var 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)                
}];//运单信息列表 
sdkwx.pause(vehicleNumber, driverName, remark, shippingNoteInfos, function(res){
    console.log(res);
    if (res.type == "onSuccess") {
        //成功
        var shippingNoteInfos = res.data;//运单信息列表
    } else if (res.type == "onFailure"){
        //失败
        var errorCode = res.data.errorCode;//错误码
        var errorMsg = res.data.errorMsg;//错误描述
    }   
}); 

6、重启定位

var vehicleNumber = "浙A8XXXX";//车牌号
var driverName = "王师傅";//司机姓名
var remark = "测试";//备注
var 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)                
}];//运单信息列表
sdkwx.restart(vehicleNumber, driverName, remark, shippingNoteInfos, function(res){
    console.log(res);
    if (res.type == "onSuccess") {
        //成功
        var shippingNoteInfos = res.data;//运单信息列表
    } else if (res.type == "onFailure"){
        //失败
        var errorCode = res.data.errorCode;//错误码
        var errorMsg = res.data.errorMsg;//错误描述
    }   
});

7、停止定位

var vehicleNumber = "浙A8XXXX";//车牌号
var driverName = "王师傅";//司机姓名
var remark = "测试";//备注
var 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)                
}];//运单信息列表
sdkwx.stop(vehicleNumber, driverName, remark, shippingNoteInfos, function(res){
    console.log(res);
    if (res.type == "onSuccess") {
        //成功
        var shippingNoteInfos = res.data;//运单信息列表
    } else if (res.type == "onFailure"){
        //失败
        var errorCode = res.data.errorCode;//错误码
        var errorMsg = res.data.errorMsg;//错误描述
    }   
});

同类插件

部网络货运信息交互系统位置信息SDK插件V2高德版(Android和iOS)

隐私、权限声明

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

定位权限

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

插件自身不采集任何数据,插件使用的百度地图定位 SDK采集数据请参考其官方说明:https://lbsyun.baidu.com

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

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问