示例中心
功能在线体验
控制台

高德 开发 高德地图车机版 开发指南 导航信息透出

更新时间:2017年06月06日

交互示例:

1) Auto启动;

2) Auto向系统发送【地图状态】通知,告知第三方应用导航状态发生变更。

3) Auto向系统发送【到达目的地】通知,告知第三方已到达目的地。

4) Auto向系统发送【心跳】通知,告知第三方导航处于活跃状态。

5) Auto向系统发送【获取当前路线信息】通知,告知路线规划完毕后当前道路的信息。

6) Auto向系统发送【引导信息传递】通知第三方应用,引导信息发生了变化。

具体接口协议:

1. 地图状态

1.1 地图状态发送

说明:当导航发生状态变更时,将相应的状态通知给系统。

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

参数说明:

Action:"AUTONAVI_STANDARD_BROADCAST_SEND"
KEY_TYPE:10019
EXTRA_STATE:运行状态(int)

导航状态值

type

开始运行,Application启动即为开始运行

0

初始化完成,每次创建地图完成通知

1

运行结束,退出程序

2

进入前台,OnStart函数中调用

3

进入后台,OnStop函数中调用

4

开始算路

5

算路完成,成功

6

算路完成,失败

7

开始导航

8

结束导航

9

开始模拟导航

10

暂停模拟导航

11

停止模拟导航

12

开始TTS播报

13

停止TTS播报

14

比例尺放大 (待实现)

15

比例尺缩小 (待实现)

16

2D车首上 (待实现)

17

2D北首上 (待实现)

18

3D车首上 (待实现)

19

TMC打开 (待实现)

20

TMC关闭 (待实现)

21

达到最大比例尺 (待实现)

22

达到最小比例尺 (待实现)

23

进入巡航播报状态(待实现)

24

退出巡航播报状态

25

收藏夹家信息变更通知

26

收藏夹公司信息变更通知

27

主图点击菜单—『查周边』的通知

28

主图点击菜单—『搜地点』的通知

29

SEND TO CAR卡片消失通知

30

停车场推送卡片消失通知

31

续航通知对话框消失通知

32

算路失败对话框消失通知

33

导航中手动退出导航对话框弹出时通知

34

导航中手动退出导航时对话框消失通知

35

普通收藏夹变化通知(不包括家和公司)

36

昼夜模式白天状态通知

37

昼夜模式黑夜状态通知

38

到达目的地通知

39

心跳通知

40

警告界面在前台(前装2.1.7.1300支持)

105

警告界面在后台(前装2.1.7.1300支持)

106

1.2 地图状态接收

说明:auto主动保存最后一次地图状态消息,当第三方发送相关请求时,auto将最后一次地图状态消息发送给第三方。

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

参数说明:

Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
KEY_TYPE:10061

2. 到达目的地

说明:auto正常到达目的地后,发送“到达目的地”广播给第三方。(与结束导航不同)

版本信息:auto2.0.4以上适配渠道版本支持。

参数说明:

Action:"AUTONAVI_STANDARD_BROADCAST_SEND"
KEY_TYPE:10019
EXTRA_STATE:运行状态(int)

导航状态值

type

到达目的地通知

39

3. 心跳

说明:auto定时发送消息给第三方说明auto是否处于活跃状态,发送频率1分钟一次(发送频率需要可配置)

版本信息:auto2.0.4以上适配渠道版本支持。

参数说明:

Action:"AUTONAVI_STANDARD_BROADCAST_SEND"
KEY_TYPE:10019
EXTRA_STATE:运行状态(int)

导航状态值

type

心跳通知

40

4. 导航恢复出厂设置

说明:当auto启动时候,第三方发送恢复出厂设置信息给auto,auto在任意界面响应导航恢复出厂设置的动作。

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

参数说明:

Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
KEY_TYPE:11001

示例代码:

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

5. 获取当前路线信息

说明:路径规划完后,auto发送当前道路的信息给第三方系统。

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

参数说明:

Action:"AUTONAVI_STANDARD_BROADCAST_SEND"
KEY_TYPE:10056
EXTRA_ROAD_INFO:(String)路线信息json串
//字段说明:
ToPoiName //终点名
ToPoiAddr //终点地址
ToPoiLatitude//终点纬度
ToPoiLongitude//终点经度
midPoisNum//中途点个数
midPoiArray//中途点POI信息
FromPoiName//起点名
FromPoiAddr//起点地址
FromPoiLongitude//起点经度
FromPoiLatitude//起点纬度
pathNum//路线个数
path_info//路线信息
streetNamesSize//道路名个数
streetNames//道路名
method//标签
time//总时间 (秒)
distance//总距离 (米)
{
"ToPoiName": "海淀区",
"ToPoiLongitude": "116.3241568207741",
"midPoisNum": 0,
"FromPoiLongitude": "116.47933602333069",
"FromPoiAddr": "",
"FromPoiName": "我的位置",
"path_info": [
{
"distance": "14600",
"time": "1020",
"streetNames": [
"我的位置",
"望京街",
"阜荣街",
"阜通西大街",
"北四环西路",
 "海淀区"
],
"method": "推荐",
"streetNamesSize": 6
},
{
"distance": "14300",
"time": "1020",
"streetNames": [
"我的位置",
"望京街",
"姜庄路",
"鼎成路",
"北四环西路",
"海淀区"
],
"method": "方案2",
"streetNamesSize": 6
},
{
"distance": "19700",
"time": "1260",
"streetNames": [
"我的位置",
"望京街",
"京密路",
"S12机场高速",
"北三环东路",
"北四环西路",
"海淀区"
],
"method": "方案3",
"streetNamesSize": 7
}
],
"pathNum": 3,
"FromPoiLatitude": "39.99456393372591",
"ToPoiLatitude": "39.98579530512801",
"ToPoiAddr": "在北四环西路与北四环西路入口交叉口附近"
}

6. 引导信息

6.1 引导信息发送

说明:在导航/巡航/模拟导航中auto主动将变化的引导信息发送给第三方系统。

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

参数说明:

Action:"AUTONAVI_STANDARD_BROADCAST_SEND"
KEY_TYPE: 10001
//(extra见下面实体的各字段。)
//引导信息对应的KEY值机器描述
public class GuideInfoExtraKey
{
//导航类型,对应的值为int类型
//:GPS导航
//1:模拟导航
public static final String TYPE = "TYPE";
//当前道路名称,对应的值为String类型
public static final String CUR_ROAD_NAME = "CUR_ROAD_NAME";
//下一道路名,对应的值为String类型
public static final String NEXT_ROAD_NAME = "NEXT_ROAD_NAME";
//距离最近服务区的距离,对应的值为int类型,单位:米
public static final String SAPA_DIST = "SAPA_DIST";
//服务区类型,对应的值为int类型
//0:高速服务区
//1:其他服务器
public static final String SAPA_TYPE = "SAPA_TYPE";
//距离最近的电子眼距离,对应的值为int类型,单位:米
public static final String CAMERA_DIST = "CAMERA_DIST";
//电子眼类型,对应的值为int类型
//0 测速摄像头
//1为监控摄像头
//2为闯红灯拍照
//3为违章拍照
//4为公交专用道摄像头
//5为应急车道摄像头
public static final String CAMERA_TYPE = "CAMERA_TYPE";
//电子眼限速度,对应的值为int类型,无限速则为0,单位:公里/小时
public static final String CAMERA_SPEED = "CAMERA_SPEED";
//下一个将要路过的电子眼编号,若为-1则对应的道路上没有电子眼,对应的值为int类型
public static final String CAMERA_INDEX = "CAMERA_INDEX";
//导航转向图标,对应的值为int类型
public static final String ICON = "ICON";
//路径剩余距离,对应的值为int类型,单位:米
public static final String ROUTE_REMAIN_DIS = "ROUTE_REMAIN_DIS";
//路径剩余时间,对应的值为int类型,单位:秒
public static final String ROUTE_REMAIN_TIME = "ROUTE_REMAIN_TIME";
//当前导航段剩余距离,对应的值为int类型,单位:米
public static final String SEG_REMAIN_DIS = "SEG_REMAIN_DIS";
//当前导航段剩余时间,对应的值为int类型,单位:秒
public static final String SEG_REMAIN_TIME = "SEG_REMAIN_TIME";
//自车方向,对应的值为int类型,单位:度,以正北为基准,顺时针增加
public static final String CAR_DIRECTION = "CAR_DIRECTION";
//当前道路速度限制,对应的值为int类型,单位:公里/小时
public static final String LIMITED_SPEED = "LIMITED_SPEED";
//当前自车所在Link,对应的值为int类型,从0开始
public static final String CUR_SEG_NUM = "CUR_SEG_NUM";
//当前位置的前一个形状点号,对应的值为int类型,从0开始
public static final String CUR_POINT_NUM = "CUR_POINT_NUM";
//环岛出口序号,对应的值为int类型,从0开始.
//1.x版本:只有在icon为11和12时有效,其余为无效值0
//2.x版本:只有在icon为11、12、17、18时有效,其余为无效值0
public static final String ROUND_ABOUT_NUM = "ROUNG_ABOUT_NUM";
//路径总距离,对应的值为int类型,单位:米
public static final String ROUTE_ALL_DIS = "ROUTE_ALL_DIS";
//路径总时间,对应的值为int类型,单位:秒
public static final String ROUTE_ALL_TIME = "ROUTE_ALL_TIME";
//当前车速,对应的值为int类型,单位:公里/小时
public static final String CUR_SPEED = "CUR_SPEED";
//红绿灯个数,对应的值为int类型
public static final String TRAFFIC_LIGHT_NUM = "TRAFFIC_LIGHT_NUM";
//服务区个数,对应的值为int类型
public static final String SAPA_NUM = "SAPA_NUM";
//下一个服务区名称,对应的值为String类型
public static final String SAPA_NAME = "SAPA_NAME";
//当前道路类型,对应的值为int类型
//0:高速公路
//1:国道
//2:省道
//3:县道
//4:乡公路
//5:县乡村内部道路
//6:主要大街、城市快速道
//7:主要道路
//8:次要道路
//9:普通道路
//10:非导航道路
public static final String ROAD_TYPE = "ROAD_TYPE";
//是否到达目的地,对应的值为boolean类型
public static final String ARRIVE_STATUS = "ARRIVE_STATUS";
//导航转向图标,对应的值为int类型
public static final String ICON = "ICON";

导航转向图标

auto 1.x 版本使用以下对应关系

1.x 图标名称

图标示例

自车图标

1

左转图标

2

右转图标

3

左前方图标

4

右前方图标

5

左后方图标

6

右后方图标

7

左转掉头图标

8

直行图标

9

到达途经点图标

10

进入环岛图标

11

驶出环岛图标

12

到达服务区图标

13

到达收费站图标

14

到达目的地图标

15

进入隧道图标

16

auto 2.x 版本使用以下对应关系

+代表与1.x的变更差异

2.x 图标名称

图标

自车图标

1

左转图标

2

右转图标

3

左前方图标

4

右前方图标

5

左后方图标

6

右后方图标

7

左转掉头图标

8

直行图标

9

到达途经点图标

10

+进入环岛图标,右侧通行地区的逆时针环岛

11

+驶出环岛图标,右侧通行地区的逆时针环岛

12

到达服务区图标

13

到达收费站图标

14

到达目的地图标

15

进入隧道图标

16

+进入环岛图标,左侧通行地区的顺时针环岛

17

+驶出环岛图标,左侧通行地区的顺时针环岛

18

+右转掉头图标,左侧通行地区的掉头

19

+顺行图标

20

2.x 关于进出环岛 和 具体编号的对应关系:

编号值

说明

ICON = 11

进入环岛图标,右侧通行地区(例:大陆)的逆时针环岛

ICON = 12

驶出环岛图标,右侧通行地区(例:大陆)的逆时针环岛

ICON = 17

进入环岛图标,左侧通行地区(例:港澳台)的顺时针环岛

ICON = 18

驶出环岛图标,左侧通行地区(例:港澳台)的顺时针环岛

ROUND_ABOUT_NUM = 1

环岛第一出口

ROUND_ABOUT_NUM = 10

环岛第十出口

ICON=11 && ROUND_ABOUT_NUM = 1

右侧通行地区的逆时针进入环岛,第1出口驶出

ICON=12 && ROUND_ABOUT_NUM = 1

右侧通行地区的逆时针驶出环岛,第1出口驶出

ICON=17 && ROUND_ABOUT_NUM = 1

左侧通行地区的顺时针进入环岛,第1出口驶出

ICON=18 && ROUND_ABOUT_NUM = 1

左侧通行地区的顺时针驶出环岛,第1出口驶出

以下是右侧通行地区的逆时针进入环岛,第x出口驶出的图标:

以下是左侧通行地区的顺时针进入环岛,第x出口驶出的图标:

1.x 关于进出环岛 和 具体编号的对应关系:

由于1.x 环岛转向只有11,12 (进入环岛,驶出环岛的定义)所以如果需要判断是右侧逆时针环岛还是左侧顺时针。需要结合当前行政区域判断。也就是大陆地区为右侧逆时针,港澳台地区为左侧顺时针。行政区域信息参考接口: 5.3 当前行政区域信息

6.2 引导信息接收

说明:auto启动时,第三方请求最后一次引导信息的消息(一般情况下不需要,因为引导信息会通过10001接口主动回调)(一般情况下不需要,因为引导信息会通过10001接口主动回调)

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

参数说明:

Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
KEY_TYPE:10062

7. 重复播报

交互示例

1) Auto启动;

2) 车机系统向Auto发送【重复播报】的广播通知;

3) Auto接收到广播消息后,重复播报当前位置的导航引导语音。

具体接口协议:

说明:Auto接收到重复播报消息后,执行重复播报当前位置的引导语音。

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

参数说明:

Action:"AUTONAVI_STANDARD_BROADCAST_RECV"
KEY_TYPE:10003

示例代码:

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

8. 实时交通光柱图

说明:导航状态下,auto将路况柱状图信息透出给第三方展现。

版本信息:目前只支持前装2.1以及之后的版本。

参数说明:

Action:"AUTONAVI_STANDARD_BROADCAST_SEND"
KEY_TYPE:13011
EXTRA_TMC_SEGMENT:(String)路况柱状图分段 结果json串
//路况柱状图字段说明:
tmc_segment_enabled //路况柱状图是否显示 true/false 为false则不显示信息
tmc_segment_size   //路况柱状图分成几段
total_distance      // 总路程,单位米
residual_distance    //剩余总路程,单位米
finish_distance  //行驶过的里程,单位米
tmc_info     //柱状图信息
tmc_status   //每段柱状图信息  -1 无效,  0 无交通流(蓝色),  1 畅通(绿色),  2 缓行(黄色),  3 拥堵(红色),  4 严重拥堵(深红色),  10 行驶过的路段(灰色)
tmc_segment_number  //路况柱状图每段的编号,编号越小越靠近起点
tmc_segment_distance // 路况柱状图每段的路程距离,单位米,所有段加起来的距离等于剩余总路程距离(每段柱状图的百分比为tmc_segment_distance除以residual_distance的值)
tmc_segment_percent //每段路况柱状图占总路程的百分比
{
" tmc_segment_enabled ": true,
" tmc_segment_size": 2,
" total_distance ": 400,
"residual_distance": 212,
"finish_distance": 188,
"tmc_info": [
{
"tmc_segment_number": "1",
"tmc_status": "0",
"tmc_segment_distance": "100",
"tmc_segment_percent": "20",
},
{
"tmc_segment_number": "2",
"tmc_status": "2",
" tmc_segment_percent ": "80",
}
]
}

9. 车道信息

说明:导航/巡航状态下,auto将车道线信息传递给第三方

版本信息:目前只支持前装2.1以及以上版本

参数说明:

Action:"AUTONAVI_STANDARD_BROADCAST_SEND"
KEY_TYPE:13012
EXTRA_DRIVE_WAY:(String) 车道线 结果json串
//车道线字段说明:
drive_way_enabled  //车道线是否有效  true/false 为false则不显示车道线信息
drive_way_size  //车道数
drive_way_info  //车道信息
drive_way_number  // 车道编号(从左到右)
drive_way_lane_Back_icon  //值 对应相应车道图标
{
"drive_way_enabled": "true",
"drive_way_size": 2,
"drive_way_info": [
{
"drive_way_number": "1",
"drive_way_lane_Back_icon": "11",
},
{
"drive_way_number": "2",
"drive_way_lane_Back_icon": "1",
}
]
}
示例中心 功能
在线体验
常见问题