aMapNavi

概述

aMapNavi 插件封装了高德导航的sdk,支持语音导航功能,支持货车导航信息设置。开发者只需输入起点终点经纬度即可轻松集成高德导航功能,本插件是由第三方插件开发者提供,使用本插件需在线应用打包安装包。(提交AppStore必读:本插件的高德导航基础包包含了IDFA,提交苹果审核时请参考高德处理IDFA官方文档)。

使用插件前,请先注册高德开放平台账号。

插件使用攻略

1、key的获取

用户在使用本插件之前需要获取高德地图API Key,Key 申请的具体流程请参照 申请Key。本插件需要的 key 可以和 aMapNavigation 、aMap、aMapLBS 、aMapLocation 、aMapReportLocation 插件的 key 共用。

2、config.xml配置信息如下:

<feature name="aMapNavi">
    <param name="android_api_key" value="0477268b22822ea9b245abef9149ee35" />
    <param name="ios_api_key" value="81qz3dBYB5q2nGji4IYrawr1" />
  </feature>

3、后台定位权限

注意:使用本插件需配置 config.xml 文件 location 字段,获取后台定位权限。

配置实例:

<preference name="backgroundMode" value="audio | location"/>

4、应用打包权限:需要配置定位权限和定位服务权限。

5、安卓插件需要配合配套才能正常使用,如果不包含aMAp插件,则会出现异常配套插件下载

固件要求

Android:4.0.0及以上 iOS:8.0及以上

addEventListener

打开导航后的一些事件监听

addEventListener(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    eventType: '',        //字符串类型;导航事件,取值范围:
                            //onStartNavi 启动导航后的回调
                            //onCalculateRouteFailure 驾车路径规划失败后的回调
                            //onLocationChange 当GPS位置有更新时的回调
                            //onArriveDestination 到达目的地后回调
    type : 0,//-1:未开始导航 1:GPS导航 2:模拟导航
    location : {
        lat : 0,//纬度
        lng : 0,//经度
        speed : 0,//当前定位点的速度。单位:公里/时
        time : 0,//定位时间。
    },
    errorCode : 0,//0 环境初始化错误
                    //2 网络超时或网络失败。
                    //3 起点错误
                    //4 请求协议非法。
                    //6 终点错误
                    //7 算路服务端编码失败
                    //8 路径数据缺乏预览数据
                    //9 Buf数据格式错误
                    //10 起点没有找到道路。
                    //11 终点没有找到道路
                    //12 途径点没有找到道路
                    //13 用户key非法或过期(请检查key是否正确)
                    //14 请求服务不存在。
                    //15 请求服务响应错误。
                    //16 无权限访问此服务。
                    //17 请求超出配额。
                    //18 请求参数非法。
                    //19 未知错误(可能是由于连接的网络无法访问外网)
                    //20 起点/终点/途经点的距离太长(步行距离>100km,骑行距离>1200km)
                    //21 途经点错误
                    //22 MD5安全码未通过验证,需要开发者判定key绑定的SHA1,package是否与sdk包里的一致.
                    //23 单位时间内访问过于频繁
                    //24 请求中使用的key与绑定平台不符,例如:开发者申请的是js api的key,却用来调web服务接口
                    //25 使用路径规划服务接口时可能出现该问题,规划点(包括起点、终点、途经点)不在中国陆地范围内
                    //26 使用路径规划服务接口时可能出现该问题,路线计算失败,通常是由于道路起点和终点距离过长导致
                    //27 无法躲避限行区域。
                    //28 调用直接导航 没有算路 参数错误,缺失有效的导航路径,无法开始导航
}

示例代码

var demo = api.require('aMapNavi');
demo.addEventListener(function(ret, err) {
    api.alert({msg: JSON.stringify(ret)});
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

startNavi

开始导航

startNavi({params})

params

start:

  • 类型:JSON 对象
  • 描述:(可选项)起点信息。
  • 内部字段:
{
    name : '三元桥',          //名称
    lat: 34.556480000000015, //经纬度
    lng: 112.47723797622677, //经纬度
    poiId : ''               //高德POIId
}

wayPoint:

  • 类型:数组
  • 描述:(可选项)途经点位置信息,最多支持3条,请开发者自行控制。
  • 内部字段:
[{
    name : '三元桥',          //名称
    lat: 34.556480000000015, //经纬度
    lng: 112.47723797622677, //经纬度
    poiId : ''               //高德POIId
}]

end:

  • 类型:JSON 对象
  • 描述:(可选项)终点信息。
  • 内部字段:
{
    name : '三元桥',          //名称
    lat: 34.556480000000015, //经纬度
    lng: 112.47723797622677, //经纬度
    poiId : ''               //高德POIId
}

carInfo:

  • 类型:JSON 对象
  • 描述:(可选项)车辆信息。
  • 内部字段:
{
    carType : 1,//设置车辆类型,0:小车; 1:货车. 默认0(小车).
    carNumber : '京DFZ239',//设置车辆的车牌号码. 如:京DFZ239,京ABZ239
    vehicleSize : 4,     //设置货车的类型(大小),1:微型货车; 2:轻型/小型货车; 3:中型货车; 4:重型货车
    vehicleWidth : 2.1,  //设置货车的宽度,范围:(0,5],单位:米
    vehicleHeight : 4,   //设置货车的高度,范围:(0,10],单位:米
    vehicleLength : 25,  //设置货车的长度,范围:(0,25],单位:米
    vehicleWeight : 99,  ///设置货车的总重量,范围:(0,100],单位:吨. 注意:核定载重应小于总重量
    vehicleLoad : 100,   //设置货车的核定载重,范围:(0,100],单位:吨. 注意:核定载重应小于总重量
    vehicleAxis : 6,     //设置货车的轴数(用来计算过路费及限重)
    vehicleLoadSwitch : false, //true代表忽略,重量不会参与算路,false 不忽略,重量会参与算路,默认为false
    restriction : true   //true代表躲避车辆限行,false代表不躲避车辆限行,默认为true
}

theme:

  • 类型:数字型
  • 描述:(可选项)导航样式。(0:蓝色系 1:浅色系 2:暗色系)
  • 默认值:0

showExitNaviDialog:

  • 类型:布尔型
  • 描述:(可选项)设置退出导航组件是否显示退出弹框。(true 显示 false 不显示)
  • 默认值:true

示例代码

var obj = api.require('aMapNavi');
demo.startNavi({
    start: {
        name : '三元桥',
        lat: 34.556480000000015,
        lng: 112.47723797622677,
        poiId : ''
    },
    wayPoint: [{
        name : '北京站',
        lat: 33.43144,
        lng: 109.77539000000002,
        poiId : ''
    }],
    end: {
        name : '北京站',
        lat: 33.784214,
        lng: 111.57062599999995,
        poiId : ''
    },
    carInfo:{
        carType : 1,
        carNumber : '京DFZ239',
        vehicleSize : 4,
        vehicleWidth : 2.1,
        vehicleHeight : 4,
        vehicleLength : 25,
        vehicleWeight : 99,
        vehicleLoad : 100,
        vehicleAxis : 6,
        vehicleLoadSwitch : false,
        restriction : true
    },
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

updatePrivacyShow

更新App是否显示隐私弹窗的状态,隐私弹窗是否包含高德SDK隐私协议内容的状态

updatePrivacyShow({params})

params

showStatus:

  • 类型:布尔型
  • 描述:(可选项)显示隐私弹窗状态(false : 未显示 , true : 已显示)。
  • 默认值:true

containStatus:

  • 类型:布尔型
  • 描述:(可选项)集成SDK隐私信息状态。(false : 未集成 , true : 已集成)
  • 默认值:true

##ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: true,   //布尔型;true||false
}

示例代码

var obj = api.require('aMapNavi');
var ret = demo.updatePrivacyShow({...});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

updatePrivacyAgree

更新用户授权高德SDK隐私协议状态

updatePrivacyAgree({params})

params

agreeStatus:

  • 类型:布尔型
  • 描述:(可选项)显示隐私弹窗状态(false : 未同意 , true : 已同意)。
  • 默认值:true

##ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: true,   //布尔型;true||false
}

示例代码

var obj = api.require('aMapNavi');
var ret = demo.updatePrivacyAgree({...});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

是否仍需要帮助? 请保持联络!
最后更新于 2024/10/10