1.导航中诱导信息广播

1.1功能简介

当bdmap在导航中时会对外广播下述诱导信息。

1.2实现形式

BroadCast

1.3协议​
1.3.1 透传项目表（以下所有数据在透传时都不带单位，对应的具体单位参考括弧内标注）

导航播报透传项	action	method
转向信息，图片名称（名称与转向标对照参考1.3.2）	com.baidu.map.auto.NOTIFY.ACTION_NAVI_INDUCUD	TURN_ICONINFO
当前道路名	com.baidu.map.auto.NOTIFY.ACTION_NAVI_INDUCUD	CUR_ROAD_NAME
总的剩余距离（单位：米）	com.baidu.map.auto.NOTIFY.ACTION_NAVI_INDUCUD	LEFT_DISTANCE
总的剩余时间（单位：秒）	com.baidu.map.auto.NOTIFY.ACTION_NAVI_INDUCUD	LEFT_TIME
下条道路名	com.baidu.map.auto.NOTIFY.ACTION_NAVI_INDUCUD	NEXT_ROAD_NAME
全程距离（单位：米）	com.baidu.map.auto.NOTIFY.ACTION_NAVI_INDUCUD	ALL_DISTANCE
全程时间（单位：秒）	com.baidu.map.auto.NOTIFY.ACTION_NAVI_INDUCUD	ALL_TIME
当前速度（单位：公里/小时）	com.baidu.map.auto.NOTIFY.ACTION_NAVI_INDUCUD	CUR_SPEED
到下一路口转向标的距离（单位：米）	com.baidu.map.auto.NOTIFY.ACTION_NAVI_INDUCUD	NEXT_TURN_ICON_DISTANCE

1.3.2 转向标图名对照表

名称	描述	图片
turn_back	掉头
turn_front	直行
turn_right_front	右前方转弯
turn_right	右转
turn_right_back	右后方转弯
turn_left_back	左后方转弯
turn_left	左转
turn_left_front	左前方转弯
turn_ring	环岛
turn_left_side	普通/JCT/SAPA二分歧 靠左
turn_right_side	普通/JCT/SAPA二分歧 靠右
turn_left_side_main	左侧走本线
turn_branch_left_straight	靠最左走本线
turn_right_side_main	右侧走本线
turn_branch_right_straight	靠最右走本线
turn_branch_center	中间走本线
turn_left_side_ic	IC二分歧左侧走IC
turn_right_side_ic	IC二分歧右侧走IC
turn_branch_left	普通三分歧/JCT/SAPA 靠最左
turn_branch_right	普通三分歧/JCT/SAPA 靠最右
turn_dest	目的地
turn_via_1	途径点
turn_inferry	进入、脱出渡口
turn_tollgate	收费站
turn_left_side_main	IC二分歧左侧直行走IC
turn_right_side_main	IC二分歧右侧直行走IC
turn_branch_left_straight	普通/JCT/SAPA三分歧左侧 直行
turn_branch_center	普通/JCT/SAPA三分歧中央 直行
turn_branch_right_straight	普通/JCT/SAPA三分歧右侧 直行 八方向靠最右侧直行
turn_branch_left	IC三分歧左侧走IC
turn_branch_right	IC三分歧右侧走IC
turn_left_side_main	八方向靠左直行
turn_right_side_main	八方向靠右直行
turn_left	八方向左转+随后靠左
turn_right	八方向右转+随后靠左
turn_lf_2branch_left	八方向左前方靠左侧
turn_lf_2branch_right	八方向左前方靠右侧
turn_rf_2branch_left	八方向右前方靠左侧
turn_rf_2branch_right	八方向右前方靠右侧
turn_back	八方向掉头
turn_ring_front	环岛向前
turn_ring_left	环岛向左
turn_ring_leftback	环岛向左后
turn_ring_leftfront	环岛向左前
turn_ring_right	环岛向右
turn_ring_rightback	环岛向右后
turn_ring_rightfront	环岛向右前
turn_ring_turnback	环岛向后

1.4版本

官网版本2.0及以上可用

2.导航中最近一次诱导信息（部分）透传

2.1功能简介

该接口可允许第三方获取bdmap在导航中最近一次的部分诱导信息。

2.2实现形式

AIDL、Service

2.3协议

参数名称	参数描述	格式/示例	是否必选
method	指定调用方式	remainLeftDistance：剩余多少路程 remainLeftTime：剩余多少时间  aheadRoadName：前方那条路	是
param	调用方法传参	null	是

2.4版本

官网版本2.0及以上可用

3.导航中下一路口距离透传

3.1功能简介

该接口可允许第三方获取bdmap在导航中到下一路口距离的诱导信息。

3.2实现形式

AIDL、Service

3.3协议

参数名称	参数描述	格式/示例	是否必选
method	指定调用方式	nextTurnDistance：下一路口距离	是
param	调用方法传参	null	是

3.4版本

官网版本2.0及以上可用

4.地图是否正在导航状态透传

4.1功能简介

该接口可允许第三方获取bdmap当前是否处在导航的状态。

4.2实现形式

AIDL、Service

4.3协议

参数名称	参数描述	格式/示例	是否必选
method	指定调用方式	isNavigating	是
param	调用方法传参	null	是

4.4版本

官网版本2.0及以上可用

5.获取导航目的地名称

5.1功能简介

该接口可允许第三方获取bdmap在导航中的目的地POI名称。

5.2实现形式

AIDL、Service

5.3协议

参数名称	参数描述	格式/示例	是否必选
method	指定调用方式	getNaviDesName	是
param	调用方法传参	null	是

5.4版本

官网版本2.0及以上可用

6.获取导航目的地坐标

6.1功能简介

该接口可允许第三方获取bdmap在导航中的目的地POI坐标。

6.2实现形式

AIDL、Service

6.3协议

参数名称	参数描述	格式/示例	是否必选
method	指定调用方式	getNaviDesCoordinate	是
param	调用方法传参	null	是

6.4版本

官网版本2.0及以上可用

7.获取当前行政区域

7.1功能简介

该接口可允许第三方获取bdmap当前所在的行政区域（包括：国家、省、市、区）。

7.2实现形式

AIDL、Service

7.3协议

参数名称	参数描述	格式/示例	是否必选
method	指定调用方式	getDistrictInfo	是
param	调用方法传参	null	是

7.4版本

官网版本2.0及以上可用

8.获取当前位置信息

8.1功能简介

该接口可允许第三方获取bdmap当前定位的位置信息（包括：国家、省、市、区、街道），同时根据所传参数决定是否附带图区归位功能。

8.2实现形式

AIDL、Service

8.3协议

参数名称	参数描述	格式/示例	是否必选
method	指定调用方式	getCurrentPosition	是
param	调用方法传参	onForceLocation:boolean 百度地图在前台并且在首页图区； true:图区回到当前位置 false:图区不需要回到当前位置	是

8.4版本

官网版本2.2及以上可用

9.获取家/公司有没有地址信息

9.1功能简介

该接口可允许第三方获取bdmap有没有设置过家/公司地址信息的状态

9.2实现形式

AIDL、Service

9.3协议

参数名称	参数描述	格式/示例	是否必选
method	指定调用方式	obtainCompany：是否设置公司 obtainHome：是否设置家	是
param	调用方法传参	null	是

9.4版本

官网版本2.0及以上可用

10.导航开始广播

10.1功能简介

当bdmap导航开始时会对外广播这一消息。

10.2实现形式

BroadCast

10.3协议

导航动作	action	method
开始导航	com.baidu.map.auto.NOTIFY.ACTION_NAVI_STATUE	NAVI_START

10.4版本

官网版本2.0及以上可用

11.导航结束广播

11.1功能简介

当bdmap结束导航时会对外广播这一消息。

11.2实现形式

BroadCast

11.3协议

导航动作	action	method
结束导航	com.baidu.map.auto.NOTIFY.ACTION_NAVI_STATUE	NAVI_END

11.4版本

官网版本2.0及以上可用

12.启动后软件版本信息广播

12.1功能简介

当bdmap每次启动的时候会对外广播地图版本信息。

12.2实现形式

BroadCast

12.3协议

地图信息	action	method
地图每次进程新启动时	com.baidu.map.auto.NOTIFY.ACTION_MAP_INFO	map_version

12.4版本

官网版本2.0及以上可用

13.地图是否在前台

13.1功能简介

该接口可允许第三方获取当bdmap当前状态是否在前台运行。

13.2实现形式

AIDL、Service

13.3协议

参数名称	参数描述	格式/示例	是否必选
method	指定调用方式	isForeground	是
param	调用方法传参	isForeground：boolean true：前台 false：不在前台	是

13.4版本

官网版本2.2及以上可用

14.地图进入前台时广播

14.1功能简介

当bdmap进入系统前台时会对外广播这一消息。

14.2实现形式

BroadCast

14.3协议

地图信息	action	method
进入前台通知	com.baidu.map.auto.NOTIFY.ACTION_MAP_INFO	map_foreground

14.4版本

官网版本2.2及以上可用

15.地图进入后台时广播

15.1功能简介

当bdmap进入系统后台时会对外广播这一消息。

15.2实现形式

BroadCast

15.3协议

地图信息	action	method
进入后台通知	com.baidu.map.auto.NOTIFY.ACTION_MAP_INFO	map_backgound

15.4版本

官网版本2.2及以上可用

16.地图进入路线规划页广播

16.1功能简介

当bdmap进入具体的路线规划页时会对外广播这一消息。

16.2实现形式

BroadCast

16.3协议

导航动作	action	method
进入路线规划页通知	com.baidu.map.auto.NOTIFY.ACTION_ROUTE_INFO	ROUTE_START

16.4版本

官网版本2.2及以上可用

17.地图退出路线规划页广播

17.1功能简介

当bdmap退出路线规划页时会对外广播这一消息。

17.2实现形式

BroadCast

17.3协议

导航动作	action	method
开始导航	com.baidu.map.auto.NOTIFY.ACTION_ROUTE_INFO	ROUTE_END

17.4版本

官网版本2.2及以上可用

18.路线规划页完成条数透传

18.1功能简介

当bdmap在路线规划页算路完成式会透传规划出了几条路线这一信息。

18.2实现形式

BroadCast

18.3协议

导航信息	action	method
路线规划页算路条数	com.baidu.map.auto.NOTIFY.ACTION_ROUTE_INFO	ROUTE_COUNT

具体接收到判断条数的字符串将是如下样式： route_count:1，（冒号后数字也可能是2或者3）

18.4版本

官网版本2.2及以上可用