示例中心
功能在线体验
控制台
您现在的位置: 开发 > 高德地图车机版 > 开发指南 > 路线规划 >

高德 开发 高德地图车机版 开发指南 路线规划

更新时间:2017年06月09日

交互示例:

1) Auto启动;

2) 车机系统向Auto发送广播,Auto接收到广播协议【开始导航】,Auto响应,进入导航界面,开始导航。

3) 车机系统向Auto发送广播,Auto接收到广播协议【设置起点、途经点和终点】,Auto响应,依据传输的起终点和途经点,开始导航。

4) 车机系统向Auto发送广播,Auto接收到广播协议【目的地直接导航】,Auto响应,以当前位置为起点,传输的目的地为终点,开始导航。

5) 车机系统向Auto发送广播,Auto接收到广播协议【回家/公司】,Auto响应,开始导航至家或公司。

6) 以上协议间无因果关系。

具体协议接口

 

路线偏好参数说明

任何原则均不勾选的情况下,默认“多策略算路”:同时用多种策略算出多条路线,每种策略取最优路线。

协议的偏好参数与auto内部的算路原则的对应关系:


1. 开始导航

说明:仅适用于全程概览界面,相当于执行点击【开始导航】的操作。Auto前台运行时,第三方发送【开始导航】的广播,auto响应进入导航界面。

版本信息:auto1.4.2以上适配渠道版本支持。

参数说明:

      Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
      KEY_TYPE:10009

示例代码:

    Intent intent = new Intent();
    intent.setAction("AUTONAVI_STANDARD_BROADCAST_RECV");
    intent.putExtra("KEY_TYPE", 10009);
    sendBroadcast(intent);

效果示意图:

2. 设置起点、终点并规划路线

说明:auto启动/未启动时,第三方将起点、终点传给auto,auto响应进行路线规划界面。

版本信息:auto1.4.2以上适配渠道版本支持。

参数说明:

    Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
    KEY_TYPE:10007
    EXTRA_SLAT:起点纬度(double)
    EXTRA_SLON:起点经度(double)
    EXTRA_SNAME:起点名称(String)
    EXTRA_DLAT:终点纬度(double)
    EXTRA_DLON:终点经度(double)
    EXTRA_DNAME:终点名称(String)
    EXTRA_DEV:起终点是否偏移(int)
    EXTRA_M:驾车方式(int)
    EXTRA_M (0:lat 和 lon 是已经加密后的,不需要国测加密; 1:需要国测加密)
    EXTRA_M = 1(避免收费) =2(多策略算路)=3 (不走高速) =4(躲避拥堵)
   =5(不走高速且避免收费) =6(不走高速且躲避拥堵)
   =7(躲避收费且躲避拥堵) =8(不走高速躲避收费和拥堵)
   =20 (高速优先) =24(高速优先且躲避拥堵)
   =-1(地图内部设置默认规则) 

示例代码:

    Intent intent = new Intent();
    intent.setAction("AUTONAVI_STANDARD_BROADCAST_RECV");
    intent.putExtra("KEY_TYPE", 10007);
    intent.putExtra("EXTRA_SNAME", "北京大学");
    intent.putExtra("EXTRA_SLON",116.31088);
    intent.putExtra("EXTRA_SLAT",39.99281);
    intent.putExtra("EXTRA_DNAME","复旦大学");
    intent.putExtra("EXTRA_DLON",121.503584);
    intent.putExtra("EXTRA_DLAT",31.296426);
    intent.putExtra("EXTRA_DEV",0);
    intent.putExtra("EXTRA_M",0);
    sendBroadcast(intent);

3. 设置起点、途经点和终点并规划路线

说明:auto启动/未启动时,第三方传入起点,途经点,终点并进入路径规划界面,如无起点则默认使用当前车位。

版本信息:auto1.4.2以上适配渠道版本支持。

参数说明:

    Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
    KEY_TYPE:10032
    EXTRA_SLAT:起点纬度(double)
    EXTRA_SLON:起点经度(double)
    EXTRA_SNAME:起点名称(String)
    EXTRA_FMIDLAT:第一个途径点纬度(double)
    EXTRA_FMIDLON:第一个途径点经度(double)
    EXTRA_FMIDNAME:第一个途径点名称(String)
    EXTRA_SMIDLAT:第二个途径点纬度(double)
    EXTRA_SMIDLON:第二个途径点经度(double)
    EXTRA_SMIDNAME:第二个途径点名称(String)
    EXTRA_TMIDLAT:第三个途径点纬度(double)
    EXTRA_TMIDLON:第三个途径点经度(double)
    EXTRA_TMIDNAME:第三个途径点名称(String)
    EXTRA_DLAT:终点纬度(double)
    EXTRA_DLON:终点经度(double)
    EXTRA_DNAME:终点名称(String)
    EXTRA_DEV:起终点是否偏移(int)
    EXTRA_M:驾车方式(int)
    EXTRA_M (0:lat 和 lon 是已经加密后的,不需要国测加密; 1:需要国测加密)
    EXTRA_M = 1(避免收费) =2(多策略算路)=3 (不走高速) =4(躲避拥堵)
   =5(不走高速且避免收费) =6(不走高速且躲避拥堵)
   =7(躲避收费且躲避拥堵) =8(不走高速躲避收费和拥堵)
   =20 (高速优先) =24(高速优先且躲避拥堵)
   =-1(地图内部设置默认规则)

示例代码:

    Intent intent = new Intent();
    intent.setAction("AUTONAVI_STANDARD_BROADCAST_RECV");
    intent.putExtra("KEY_TYPE", 10032);
    intent.putExtra("EXTRA_SNAME", "百翔软件园酒店");
    intent.putExtra("EXTRA_SLON", 118.182682);
    intent.putExtra("EXTRA_SLAT",24.496706);
    intent.putExtra("EXTRA_FMIDNAME","蔡塘");
    intent.putExtra("EXTRA_FMIDLON",118.162947);
    intent.putExtra("EXTRA_FMIDLAT",24.492793);
    intent.putExtra("EXTRA_SMIDNAME","太川大楼");
    intent.putExtra("EXTRA_SMIDLON",118.148825);
    intent.putExtra("EXTRA_SMIDLAT",24.483256);
    intent.putExtra("EXTRA_TMIDNAME","世界山庄");
    intent.putExtra("EXTRA_TMIDLON",118.163917);
    intent.putExtra("EXTRA_TMIDLAT",24.47658);
    intent.putExtra("EXTRA_DNAME","椰风寨");
    intent.putExtra("EXTRA_DLON",118.17581);
    intent.putExtra("EXTRA_DLAT",24.453688);
    intent.putExtra("EXTRA_DEV",0);
    intent.putExtra("EXTRA_M",0);
    sendBroadcast(intent);

4. (目的地)直接导航

说明:auto启动/未启动时,第三方传入终点,auto以车标为起点规划路径并直接进入导航界面。

版本信息:auto1.4.2以上适配渠道版本支持。

参数说明:

Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
    KEY_TYPE:10038
    SOURCE_APP:第三方应用名称(String)
    POINAME:POI 名称(String)
    LAT:(必填)(double)纬度
    LON:(必填)(double)经度
    DEV:(必填)(int)是否偏移(0:lat 和 lon 是已经加密后的,不需要国测加密; 1:需要国测加密)
    STYLE:(必填)(int)导航方式
    EXTRA_M = 1(避免收费) =2(多策略算路)=3 (不走高速) =4(躲避拥堵)
   =5(不走高速且避免收费) =6(不走高速且躲避拥堵)
   =7(躲避收费且躲避拥堵) =8(不走高速躲避收费和拥堵)
   =20 (高速优先) =24(高速优先且躲避拥堵)
   =-1(地图内部设置默认规则)

示例代码:

    Intent intent = new Intent();
    intent.setAction("AUTONAVI_STANDARD_BROADCAST_RECV");
    intent.putExtra("KEY_TYPE", 10038);
    intent.putExtra("POINAME","厦门大学");
    intent.putExtra("LAT",24.444593);
    intent.putExtra("LON",118.101011);
    intent.putExtra("DEV",0);
    intent.putExtra("STYLE",0);
    intent.putExtra("SOURCE_APP","Third App");
    sendBroadcast(intent);

效果示意图:

5. 回家/去公司(特殊点导航)

说明:auto启动/未启动时,第三方发送相应广播信息,auto执行导航到家/公司。

版本信息:auto1.4.2以上适配渠道版本支持

参数说明:

    Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
    KEY_TYPE:10040
        SOURCE_APP:第三方应用名称(String)
        DEST:(必填)0 回家;1 回公司(int)
        IS_START_NAVI:(必填)是否直接开始导航  0 是;1 否(int)

示例代码:

    Intent intent = new Intent();
    intent.setAction("AUTONAVI_STANDARD_BROADCAST_RECV");
    intent.putExtra("KEY_TYPE", 10040);
    intent.putExtra("DEST", 0);
    intent.putExtra("IS_START_NAVI", 0);
    intent.putExtra("SOURCE_APP","Third App");
    sendBroadcast(intent);

6. 路线方案选择

说明:路径规划完成后再全程概览界面,通过第三方可选择要切换的路线,如方案1,方案2。

版本信息:auto1.4.3以上适配渠道版本支持

参数说明:

    Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
    KEY_TYPE:10055
        EXTRA_CHANGE_ROAD:(int) 1:表示第一条路线;2:表示第二条路线;3:表示第三条路线

示例代码:

    Intent intent = new Intent();
    intent.setAction("AUTONAVI_STANDARD_BROADCAST_RECV");
    intent.putExtra("KEY_TYPE", 10055);
    intent.putExtra("EXTRA_CHANGE_ROAD", 1);
    sendBroadcast(intent);

7. 路线规划失败

说明:路线规划失败后,auto会弹出相关操作提示,第三方选择后将相关结果返回给auto,auto执行相关操作(返回原路径/重新试试)。

版本信息:auto1.4.3以上适配渠道版本支持

参数说明:

    Action:“AUTONAVI_STANDARD_BROADCAST_RECV”
    KEY_TYPE:10051
    EXTRA_CALCULATED_FAIL_OPTION_DATA:true(重新试试);false(返回原路径/退出导航))

示例代码:

    Intent intent = new Intent();
    intent.setAction("AUTONAVI_STANDARD_BROADCAST_RECV");
    intent.putExtra("KEY_TYPE", 10051);
    intent.putExtra("EXTRA_CALCULATED_FAIL_OPTION_DATA", true);
    sendBroadcast(intent);

8. 路线偏好设置(导航场景下)

说明:仅在导航场景下,支持第三方进行路线偏好的重新选择。

版本信息:auto1.4.2以上适配渠道版本支持。

参数说明:

    Action:"AUTONAVI_STANDARD_BR` |`0`
        KEY_TYPE:10005
        NAVI_ROUTE_PREFER:type(int)

路线偏好对照表

type

避免收费

1

多策略算路

2

不走高速

3

躲避拥堵

4

不走高速且避免收费

5

不走高速且躲避拥堵

6

收费和拥堵

7

不走高速躲避收费和拥堵

8

高速优先

20

躲避拥堵且高速优先

24

地图内部设置默认规则

-1

示例代码:

    Intent intent = new Intent();
    intent.setAction("AUTONAVI_STANDARD_BROADCAST_RECV");
    intent.putExtra("KEY_TYPE", 10005);
    intent.putExtra("NAVI_ROUTE_PREFER", 0);
    sendBroadcast(intent);

9. 全览状态

说明:在且仅在导航场景下,通过第三方控制进入或退出全览状态。

版本信息:auto1.4.2以上适配渠道版本支持。

参数说明:

     Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
     KEY_TYPE:10006
     EXTRA_IS_SHOW:isShow(int)

isShow

进入全览

0

退出全览

1

示例代码:

    Intent intent = new Intent();
    intent.setAction("AUTONAVI_STANDARD_BROADCAST_RECV");
    intent.putExtra("KEY_TYPE", 10006);
    intent.putExtra("EXTRA_IS_SHOW", 0);
    sendBroadcast(intent);

效果示意:

10. 停车场设置

交互示例:

1) Auto启动;

2) Auto向系统发送【发送停车场选择消息】通知,告知第三方目的地附近的停车场信息。

3) 车机系统接收到广播消息后,选择停车场,并通过广播协议【接收停车场选择消息】传输回auto。

4) Auto接收到停车场信息,设置停车场;

具体协议接口:

10.1 发送停车场选择消息

说明:Auto给第三方应用发送目的地附近停车场信息。

版本信息:auto1.4.3以上适配渠道版本支持。

参数说明:

     Action:"AUTONAVI_STANDARD_BROADCAST_SEND"
     KEY_TYPE:10052
     EXTRA_PARK_DATA: json字符串,如下:
参数说明:
    1、latitude:纬度
    2、longitude:经度
    3、parkDistance:距离目的地停车场的距离(单位:米)
    4、parkIndex:停车场索引值(0:第一个;1:第二个;2:第三个)
    5、parkName:停车场名称
    6、parkPrice:停车场收费价格`
       [
           {
               "latitude": 104782.361, 
               "longitude": 2154.287, 
               "parkDistance": 200, 
               "parkIndex": 0, 
               "parkName": "停车场一", 
               "parkPrice": "2"
           }, 
           {
               "latitude": 198882.301, 
               "longitude": 3211.267, 
               "parkDistance": 30, 
               "parkIndex": 1, 
               "parkName": "停车场二", 
               "parkPrice": "20"
           }, 
           {
               "latitude": 124782.526, 
               "longitude": 2104.387, 
               "parkDistance": 90, 
               "parkIndex": 2, 
               "parkName": "停车场三", 
               "parkPrice": "6"
           }

10.2 接收停车场选择消息

说明:auto接收第三方对目的地附近停车场的选择,并进行设置。

版本信息:auto1.4.3以上适配渠道版本支持

参数说明:

    Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
    KEY_TYPE:10052
    EXTRA_PARK_DATA:(-1:忽略;0:第一个停车场;1:第二个停车场;2:第三停车场)

示例代码:

    Intent intent = new Intent();
    intent.setAction("AUTONAVI_STANDARD_BROADCAST_RECV");
    intent.putExtra("KEY_TYPE", 10052);
    intent.putExtra("EXTRA_PARK_DATA", 0);
    sendBroadcast(intent);

11. 续航消息

交互示例:

1) Auto启动;

2) Auto向系统发送【发送续航消息】通知,告知第三方应用当前的续航信息;

3) 车机系统接收到广播消息后,进行选择,然后通过广播协议【接收续航消息】将第三方选择发送给Auto;

4) Auto接收到消息后,依据第三方应用选择执行或取消续航消息。

具体协议接口:

11.1 发送续航消息

说明:当auto接收到续航的信息,以及续航信息框消失时,auto发送通知告知第三方。

版本信息:auto1.4.3以上的适配渠道版本支持。

参数说明:

    Action:"AUTONAVI_STANDARD_BROADCAST_SEND"
    KEY_TYPE:10049
    EXTRA_ENDURANCE_DATA:续航弹框title + 弹框内容(目的地)(String)

11.2 接收续航消息

说明:auto接收到第三方应用关于续航消息的选择,以此判断是否续航。

版本信息:auto1.4.3以上适配渠道版本支持。

参数说明:

    Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
    KEY_TYPE:10049
    EXTRA_ENDURANCE_DATA:true(继续),false(取消)

示例代码:

    Intent intent = new Intent();
    intent.setAction("AUTONAVI_STANDARD_BROADCAST_RECV");
    intent.putExtra("KEY_TYPE", 10049);
    intent.putExtra("EXTRA_ENDURANCE_DATA", true);
    sendBroadcast(intent);

12. 退出导航(结束引导)

交互示例:

1) Auto启动;

2) 车机系统向Auto发送【退出导航】通知,

3) Auto接收到通知后,退出导航,回到主图。

具体接口协议:

说明:第三方通知auto结束引导,退出导航状态,回到主图界面。

版本信息:auto1.4.3以上适配渠道版本支持。

参数说明:

    Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
        KEY_TYPE:10010

示例代码:

    Intent intent = new Intent();
        intent.setAction("AUTONAVI_STANDARD_BROADCAST_RECV");
        intent.putExtra("KEY_TYPE", 10010);
        sendBroadcast(intent);

13. 是否从全览自动回到导航

说明:Auto处于全览状态时,接收第三方发送的信息判断是否从全览回到导航界面。

版本信息:auto1.4.3以上适配渠道版本支持。

参数说明:

    Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
    KEY_TYPE:10053
    SOURCE_APP:第三方应用名称(String) 
    EXTRA_AUTO_BACK_NAVI_DATA:true(回车位继续导航);false(暂停在全览界面)

示例代码:

    Intent intent = new Intent();
    intent.setAction("AUTONAVI_STANDARD_BROADCAST_RECV");
    intent.putExtra("KEY_TYPE", 10053);
    intent.putExtra("EXTRA_AUTO_BACK_NAVI_DATA", true);
    sendBroadcast(intent);

14. Send2Car功能

交互示例:

1) Auto启动;

2) Auto接收到高德地图手机版发送的信息后通知车机系统

3) 车机系统处理后将相关信息发送给Auto,Auto相应相关操作。

4) 当弹出框消失时,auto将相关信息发送给第三方

具体接口协议:

14.1 发送Send2Car卡片信息

说明:Auto启动后,手机发送Send2Car卡片信息至Auto,auto将卡片信息透出给第三方

版本信息:auto1.4.3以上适配渠道版本支持。

参数说明:

    Action:"AUTONAVI_STANDARD_BROADCAST_SEND"
    KEY_TYPE:10050
    EXTRA_SEND2CAR_DATA:目的地(String)

14.2 接收Send2Car卡片信息

说明:系统接收到Auto发送的卡片信息后,将相关操作发送给Auto,Auto响应相关操作。

版本信息:auto1.4.3以上适配渠道版本支持

参数说明:

    Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
    KEY_TYPE:10050
    EXTRA_SEND2CAR_DATA:true(规划路线);false(取消)

示例代码:

    Intent intent = new Intent();
    intent.setAction("AUTONAVI_STANDARD_BROADCAST_RECV");
    intent.putExtra("KEY_TYPE", 10050);
    intent.putExtra("EXTRA_SEND2CAR_DATA", true);
    sendBroadcast(intent);

15. 模拟导航

说明:通过指令传起点、中途点、终点与偏好设置后可直接模拟导航,模拟状态可支持单次模拟与循环模拟导航

版本信息:auto2.0.5及以上适配渠道版本支持

参数说明:

    Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
    KEY_TYPE:10076
    EXTRA_SLAT:起点纬度 必须填
    EXTRA_SLON:起点经度 必须填
    EXTRA_SNAME:起点名称 必须填
    EXTRA_FMIDLAT:第一个途径点纬度 必须填
    EXTRA_FMIDLON:第一个途径点经度 必须填
    EXTRA_FMIDNAME:第一个途径点名称 必须填
    EXTRA_SMIDLAT:第二个途径点纬度 必须填
    EXTRA_SMIDLON:第二个途径点经度 必须填
    EXTRA_SMIDNAME:第二个途径点名称 必须填
    EXTRA_TMIDLAT:第三个途径点纬度 必须填
    EXTRA_TMIDLON:第三个途径点经度 必须填
    EXTRA_TMIDNAME:第三个途径点名称 必须填
    EXTRA_DLAT:终点纬度 必须填
    EXTRA_DLON:终点经度 必须填
    EXTRA_DNAME:终点名称 必须填
    EXTRA_DEV:起终点是否需要偏移(0:是已经加密后的,不需要偏移; 1:需要偏移)
    EXTRA_M:驾车方式 =1(避免收费) =2(多策略原则)=3 (不走高速) =4(躲避拥堵)
   =5(不走高速且避免收费) =6(不走高速且躲避拥堵)
   =7(躲避收费且躲避拥堵) =8(不走高速躲避收费和拥堵)
   =20 (高速优先) =24(高速优先且躲避拥堵)
   =-1(地图内部设置默认规则)
    KEY_RECYLE_SIMUNAVI:是否循环模拟导航 true是 false 否

示例代码:

    Intent intent = new Intent();
    intent.setAction("AUTONAVI_STANDARD_BROADCAST_RECV");
    intent.putExtra("KEY_TYPE", 10076);
    intent.putExtra("EXTRA_SLAT", 24.496706);
    intent.putExtra("EXTRA_SLON", 118.182682);
    intent.putExtra("EXTRA_SNAME", "佰翔软件园酒店");
    intent.putExtra("EXTRA_FMIDLAT", 24.492793);
    intent.putExtra("EXTRA_FMIDLON", 118.162947);
    intent.putExtra("EXTRA_FMIDNAME", "蔡塘");
    intent.putExtra("EXTRA_SMIDLAT", 24.483256);
    intent.putExtra("EXTRA_SMIDLON", 118.148825);
    intent.putExtra("EXTRA_SMIDNAME", "太川大楼");
    intent.putExtra("EXTRA_TMIDLAT", 24.47658);
    intent.putExtra("EXTRA_TMIDLON", 118.163917);
    intent.putExtra("EXTRA_TMIDNAME", "世界山庄");
    intent.putExtra("EXTRA_DLAT", 24.453688);
    intent.putExtra("EXTRA_DLON", 118.17581);
    intent.putExtra("EXTRA_DNAME", "椰风寨");
    intent.putExtra("EXTRA_DEV", 0);
    intent.putExtra("EXTRA_M", 0);
    intent.putExtra("KEY_RECYLE_SIMUNAVI", true);
    sendBroadcast(intent);

16. 精简导航

说明:实际导航状态下,进入和退出精简导航模式

版本信息:目前只支持车镜2.0.1及之后的版本

参数说明:

   Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
   KEY_TYPE:12107
   HUD_IS_OPEN:int
 
   /**
     *HUD_IS_OPEN第三方查询地图的状态
     * 0 进入精简导航模式;
     * 1 退出精简导航模式
     */

示例代码:

   int KEY_TYPE =12107;
   int state = 0;// 0:进入Hud;1:退出Hud ;
   Intent intent = new Intent();
   intent.setAction("AUTONAVI_STANDARD_BROADCAST_RECV");
   intent.putExtra("KEY_TYPE", KEY_TYPE);
   intent.putExtra("HUD_IS_OPEN", state);

   sendBroadcast(intent);

示例中心 功能
在线体验
常见问题