更新记录

1.0.1(2022-09-23)

根据HBuilder X - 3.6.3编译,其他版本是否可用未知

1.0.0(2022-01-04)

1.初版提交,高德导航组件。本插件默认 隐私权政策包含高德开平隐私权政策,并弹窗展示告知用户,且取得用户同意!!!app内做条件判断用户是否同意,再调用。 2.不影响uni原有map组件和定位api。


平台兼容性

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

原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


完整版 https://ext.dcloud.net.cn/plugin?id=7109

精简版 https://ext.dcloud.net.cn/plugin?id=7110

精简版体积小,方便打调试包。

先看这里!!!

请先下载示例,示例中带配置带配置说明和测试APP。

下载地址: https://gitee.com/819589789/uni

HBX版本兼容性

当前版本(1.0.0)通过HBX3.3.5测试正常,自己打包前可先参照示例及说明(内置一个apk安装包可安装测试)

隐私合规【上架必须】

隐私权政策是否包含高德开平隐私权政策 true是包含

隐私权政策是否弹窗展示告知用户 true是展示

隐私权政策是否取得用户同意 true是用户同意

均为true ,如果不符合应用请勿使用。

1.接口

引入

const aMapNavi = uni.requireNativePlugin('FUN-AMapNavi');

1.1.开启导航或路线规划

开启后会有FunNaviInfoCallback回调【见下方说明】

高德官方文档提示-特别注意:货车路径规划是收费接口,您如果申请试用或者正式应用都请通过工单系统提交商务合作类工单进行沟通,否则默认是无法算路成功的。

所有参数均非必填(不强制填充)。

            // 导航/路线规划
            aMapNavi.showRoute({
                    theme: 0, ////主题,默认0蓝,取之范围0-2分别表示蓝,浅,暗 
                    // carInfo: {//设置车辆信息,进行尾号限行与货车导航。没有在高德申请货车路径规划(收费接口)的请不要使用此参数
                    //  carNumber: "京C123456", // 设置车辆的车牌号码 String  如:京DFZ239,京ABZ239
                    //  restriction: true, //设置是否躲避车辆限行
                    //  carType: "1", //设置车辆类型 String  0-燃油客车,1-燃油货车,2-纯电动客车,3-纯电动货车,4-插电式混动汽车,5-插电式混动货车,11-摩托车
                    //  vehicleHeight: "3.56", //设置货车的高度  String   单位:米,mCarType = 1时候生效,取值[0-25.5] 如:1.8,1.5等等。默认为1.6米
                    //  vehicleLoad: "25.99", //设置货车的总重,即车重+核定载重  String   单位:吨,mCarType = 1时候生效,取值[0-6553.5]
                    //  vehicleLoadSwitch: true, //设置货车重量是否参与算路  boolean   true-重量会参与算路;false-重量不会参与算路。默认为false
                    //  vehicleWidth: "2.5", //设置货车的最大宽度  String   单位:米,mCarType = 1时候生效,取值[0-25.5] 如:1.8,1.5等等。默认2.5米
                    //  vehicleLength: "7.3", //设置货车的最大长度  String   单位:米,mCarType = 1时候生效,取值[0-25] 如:1.8,1.5等等,默认6米
                    //  vehicleSize: "4", //设置货车的大小,默认为2  String   1-微型货车 2-轻型/小型货车 3-中型货车 4-重型货车
                    //  vehicleAxis: "6", ////设置货车的轴数,mCarType = 1时候生效,取值[0-255],默认为2
                    //  vehicleWeight: "20", //设置货车的核定载重  String   单位:吨,mCarType = 1时候生效,取值[0-6553.5]
                    // },
                    start: { //起点 
                            name: "黄河口生态旅游区", // 地名 String
                            coordinate: { //经纬度信息
                                lat: 37.79749,
                                lng: 119.064246
                            },
                            poiId: "" //POI信息 String 可通过官方接口获取[推荐]或文档
                        },
                        end: { //终点
                            /**Poi支持传入经纬度和PoiID,PoiiD优先级更高,使用Poiid算路,导航终点会更合理 (建议根据)**/
                            poiId: "",
                            name: "乌兰察布市政府",
                            coordinate: {
                                lat: 40.994469,
                                lng: 113.132142
                            }
                        },
                    waysPoiIds: [{//途经点,最多3个
                        coordinate: {
                            lat: 39.941823,
                            lng: 116.426319
                        },
                        name: "北京大学",
                        poiId: "B000A816R6"
                    }],
                    navi: false,//导航或路线 boolean 取值true/false, 对应:直接导航/路线
                    trafficEnabled: true,//交通路况 boolean 取值true/false
                    naviType: 0,//导航类型 int 0 驾车/货车 1 步行 2 骑行 3 摩托车
                    naviMode: 1,//设置直接导航模式(仅在使用组件直接导航(不调起算路页面)时生效) int 1-实时导航 2-模拟导航
                    multipleRouteNaviMode: false,//设置多路线导航模式(导航中拥有若干条备选路线供用户选择), 或单路线导航模式(默认模式). boolean 取值true/false
                    routeStrategy: 10,//设置组件规划路线的策略 int 取值 0-20  参考https://lbs.amap.com/api/android-navi-sdk/guide/route-plan/drive-route-plan 默认:速度优先+躲避拥堵+距离较短
                    showCrossImage: false,// 设置驾车导航时是否显示路口放大图 boolean
                    broadcastMode: 1,// 设置播报模式 int 1-简洁播报 2-详细播报 3-静音模式
                    dayAndNightMode: 0// 设置导航页面昼夜模式 int 0-自动切换 1-白天 2-夜间
                },
                (ret) => {
                    console.log(JSON.stringify(ret));
                }
            );

1.2.退出导航或路线规划

aMapNavi.exitRoute((ret) => {
    console.log(JSON.stringify(ret));
    // modal.toast({
    //  message: ret.code + ","+ret.message,
    //  duration: 1.5
    // });
});

2.FunNaviInfoCallback回调

2.1.使用

var globalEvent = uni.requireNativePlugin('globalEvent');//内置模块
globalEvent.addEventListener('FunNaviInfoCallback', function(e) {
  console.log('FunNaviInfoCallback:'+JSON.stringify(e));
});

2.2.返回值说明(标题为type)

  • onInitNaviFailure

    导航初始化失败时的回调函数。

    • 其他参数:
  • onGetNavigationText

    导航播报信息回调函数。

    • 其他参数:

    text - 播报文字。

  • onLocationChange

    当GPS位置有更新时的回调函数。

    • 其他参数:

    location - 当前位置的定位信息。

    示例{"accuracy":50,"altitude":0,"bearing":179.36407,"coord":{"latitude":39.999999,"longitude":116.8888888},"curLinkIndex":0,"curPointIndex":0,"curStepIndex":0,"locationType":1,"matchNaviPath":true,"roadBearing":-1,"speed":0,"time":1640955905718}

  • onArriveDestination

    到达目的地后回调函数。

    • 其他参数:

    isEmulaterNavi - true代表是模拟导航到达目的地,false代表实时导航到达目的地

  • onStartNavi

    启动导航后的回调函数

    • 其他参数:

    naviType - 导航类型:巡航模式(数值:3) 模拟导航(数值:2) 实时导航(数值:1) 未开始导航(数值:-1)

  • onCalculateRouteSuccess

    算路成功回调

    • 其他参数:

    ids - 路线索引id数组,第一条为12,第二条为13,第三条为14。

  • onCalculateRouteFailure

    驾车路径规划失败后的回调函数。

    • 其他参数:

    errorInfo - 参见【附录-1.路径规划错误码

  • onStopSpeaking

    停止播报回调 当退出组件导航页,或切换组件的播报模式为静音的时候,会触发该回调。建议在收到该回调时,停止外部一切导航相关的播报。

    • 其他参数:
  • onReCalculateRoute

    重新规划的回调

    • 其他参数:

    type - 参见【附录-2.重新算路原因类型

  • onExitPage

    退出组件或退出组件导航的回调函数

    • 其他参数:

    pageType - 参见【附录-3.组件类型

  • onStrategyChanged

    切换算路偏好回调

    • 其他参数:

    strategy - 切换后偏好 参见【附录-4.算路策略类型

  • onArrivedWayPoint

    驾车路径导航到达某个途经点的回调函数。

    • 其他参数:

    wayID - 到达途径点的编号,标号从0开始,依次累加。

  • onMapTypeChanged

    组件地图白天黑夜模式切换回调

    • 其他参数:

    mapType - 枚举值参考AMap类, 3-黑夜,4-白天

  • onNaviDirectionChanged

    导航视角变化回调

    • 其他参数:

    naviMode - 导航视角, 1-正北朝上模式 2-车头朝上状态

  • onDayAndNightModeChanged

    昼夜模式设置变化回调

    • 其他参数:

    mode - 0-自动切换 1-白天 2-夜间

  • onBroadcastModeChanged

    播报模式变化回调

    • 其他参数:

    mode - 1-简洁播报 2-详细播报 3-静音

  • onScaleAutoChanged

    比例尺智能缩放设置变化回调

    • 其他参数:

    enable - 是否开启

3.错误调试【试用】

3.1.错误信息监听

var globalEvent = uni.requireNativePlugin('globalEvent');//内置模块
globalEvent.addEventListener('funNavError', function(e) {
  console.log('funNavError:'+JSON.stringify(e));
});

文档持续更新中。。。

隐私、权限声明

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

定位相关权限

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

插件不采集,高德SDK请关注高德平台文档https://lbs.amap.com

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

插件无广告

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