导航引导扩展信息 | 小客车标准导航 | 百度地图开放平台文档中心

所有文档

小客车标准导航

服务概览

快速开始

使用准备

接口文档

服务功能

行前算路行中刷新行中偏航行中切换路线路线信息查询

进阶能力

途经点智能排序未来出行时间历史ETA 建议出发时间导航引导扩展信息扩展数据下发行中导航存储session

相关资料

更新日志常见问题资源下载使用指南

更新时间: 2026/11/02 10:46

小客车标准导航 - 导航引导扩展信息

接口说明

用于控制是否返回路口放大图、linkid、诱导语音、车信、红绿灯等导航引导扩展数据，多个值之间用英文逗号分隔。

使用说明

该功能为高级子功能，需要开通高级权限后方可使用。
如果您已开通了该功能，返回结果中将按传入的扩展项下发对应数据。

API服务地址

https://api.map.baidu.com/api_navigate/v1/route_plan?origin=40.01116,116.339303&destination=39.936404,116.452562&extensions=guidance,plink,speed_limit,lamp&ak=您的AK
//GET请求

该参数同样适用于行中刷新（route_refresh）、行中偏航（yaw）、行中切换路线（route_switch），用法与上例相同，将接口路径替换为对应接口即可。

请求参数

参数名称	参数含义	字段类型	必选	备注
参数名称	参数含义	字段类型	必选	备注
extensions	扩展功能选项用于控制是否返回路口放大图、linkid、诱导信息等扩展功能。 guidance：导航引导信息，包含路口放大图、诱导语音、车信等数据 plink: 路线的linkid序列 speed_limit：link的限速数据 lamp：路线上的红绿灯数据示例：guidance,plink,speed_limit,lamp	string	否	注：该功能为高级子功能，需通过工单联系工作人员开通
gdver	诱导版本号用于控制返回的诱导内容。可指定固定值：20201201	string	否	备注：部分诱导信息可能和端上的支持策略有关，为避免后续升级后导致低版本端上的诱导播报有问题，通过版本控制。
verbal_mode	导航诱导语音播报的模式 simple：简洁模式 [默认值，只包括机动点、建筑物播报] simple_v2：简洁模式 [和app上简洁播报策略一致，包含机动点、电子眼等播报，但是播报次数较少] standard：标准模式	string	否
img_color_schema	导航路口放大图的模式（白天 or 黑夜） 1：白天 [默认值] 2：黑夜如果白天和黑夜都需要，可以填写 1,2	string	否

返回参数

返回参数				含义	类型	备注
返回参数	返回参数2	返回参数3	返回参数4	含义	类型	备注
routes				路线集合	array
	linkids			路线的linkid序列	string	传入 extensions=plink 时下发
	lamps			路线上的红绿灯数据	array	传入 extensions=lamp 时下发参考下文中的 “红绿灯lamps结构”
	steps			路线分段数据	array
		guidance		路线上的导航引导数据	object	传入 extensions=guidance 时下发
			crossing_views	路线上的导航路口放大图	array	参考下文中的 “路口放大图crossing_views 结构”
			interval_camera	路线上的区间测速电子眼数据	array	参考下文中的 “区间测速电子眼interval_camera结构”
			verbal_instructions	路线上的引导语音播报数据	array	参考下文中的 “导航引导语音verbal_instructions结构”
			visual_instructions	路线上的可视化的引导数据	array	参考下文中的 “导航可视化引导visual_instructions结构” 其中包含车信、转向、高快速面板、收费站数据，参考下文对应结构

路口放大图crossing_views 结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
distance_to_origin					放大图位置距离路线规划起点距离	object	单位: 米
position					放大图位置坐标	object
background_url					白天背景图url	int	途经点序号为从0开始的整数，用于标识step所属的途经点路段。如：若该step属于起点至第一个途经点的路段，则其leg_index为0
night_back_url					夜晚背景图URL	string
arrow_url					叠加箭头图片url （如存在，则直接叠加在背景图之上）	string
picture_type					放大图类型	string	real_img：实景图 mode_img：模式图 pano_img：街景图 vector_img：矢量图
linkid					路口放大图进入linkid （如存在，则直接叠加在背景图之上）	int
action_linkid					建议展示位置的 linkid	int
action_point					建议展示位置的坐标	string
action_distance_to_gdpt					建议展示位置到诱导点的距离	int	单位：米

区间测速电子眼interval_camera结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
in						object	对应app上的功能如下：
	linkid				区间进入电子眼的linkid	int
	position				区间进入电子眼的坐标	string
out						object
	linkid				区间退出电子眼的linkid	int
	position				区间退出电子眼的坐标	string
speed_limit					区间限速值（km/h）	int

导航引导语音verbal_instructions结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
distance_to_origin					语音诱导点到路线起点的距离	int	单位: 米
linkid					语音诱导点对应的linkid	int
position					诱导点坐标	string
details						array
	kind				语音播报类型	int	0：未知 [默认] 1000：转向 1001：目的地附近 1002：到达目的地 2000：顺行/直行播报 3000：建筑物相关播报，如隧道、收费站、服务区等 4000：电子眼 4001：公交车道电子眼（需要车机根据时间段择机播报） 4003：区间测速电子眼起点播报 4004：区间测速电子眼中间段播报。超速和未超速播报不同的内容，speak_text 以"\|\|"分为两部分，第一部分为未超速的播报文本，第二部分为超速的播报文本。 4006：区间测速离开前播报（需要客户端根据实时车速替换文本<u_speed>） 4007：区间测速电子眼终点播报（需要客户端根据实时车速替换文本<u_speed>）
	string				播报内容	string
	tip_voice_type				语音提示类型	int	0：无 1：机动点提示音 2：安全类提示音（如进入小路提醒减速）
	distance_to_gdpt				建议播报位置点距离诱导点的距离	int	单位：米
	linkid				建议播报位置点对应linkid	int
	speak_position				建议播报的位置点	string
	voice_level				语音播报等级	int	数值越大，其优先级越高
	can_delay				标识播报是否可以被延迟播放	int	0:不可以 1:可以
	associated_ele_pos				语音播报关联要素的位置	int	对于电子眼，即摄像头的位置
	associated_ele_linkid				语音播报关联要素的linkid	int	对于电子眼，即摄像头所在位置的linkid
	ae_distance_to_gdpt				语音播报关联要素到诱导点的距离	int
	speed_limit				限速值	int	测速摄像头会返回限速值
	validity_period				时间段在该时间段内社会车不可以进入公交车道	array

导航可视化引导visual_instructions结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
distance_to_origin					该导点到起点的距离	int	单位: 米
linkid					该导航点对应的linkid	int
position					该导点坐标	string
	lane_info				车道	array	参考下文的车道 lane_info 结构
	turn_description				转向	array	参考下文的转向 turn_description 结构
	highway_info				高速通道面板	array	参考下文的高速通道面板 highway_info 结构
	tollgate_info				收费站	array	参考下文的收费站 tollgate_info 结构

车信lane_info结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
distance_to_gdpt					建议展示位置点 (display_point)距离诱导点的距离	int	相对位置示例：200
linkid					建议展示位置点对应linkid	int	示例：1598523247
hide_distance_to_gdpt					隐藏位置点离诱导点的距离	int	相对位置
hide_linkid					隐藏位置点对应的linkid	int
lanes					从右到左各个车道的车信信息（数组）最多九个车道	array
	direction_highlight				数组，多个转向类型	array
		direction			车道类型	array	空车道：0 直行：1 右转：2 调头：3 左转：4 公交：5；时间段内社会车辆可以进入该车道。可变车道：6：表示车道的导向方向随需要可变 HOV车道：7：指专供乘载多人（2人以上）汽车所行驶的车道。潮汐车道：8：车辆行驶方向可随交通管理需要进行变化的车道。示例：1 （表示直行）
		highlight			是否高亮	bool	true: 高亮 false：不高亮
	validity_period				特殊车道有个时间段，时间段的含义：表示社会车可进入该车道的时间特殊车道包括：公交车道、可变车道、潮汐车道、HOV车道。其中，可变车道由于没有可靠的数据源，暂不返回该值。如果特殊车道未返回该值或者是空值，表示全天禁止社会车进入该车道。	object
		front			直行时间段未返回或者空值，表示社会车全天禁止进入该车道直行	array	格式说明： • 有效期字段示例: "0,1200"，单位：秒。逗号分隔，第一个值是起始时间，第二个值是终止时间。 • 以算路时刻为基准时间。 • 返回特殊车道时间段与基准时间的时间间隔。如：特殊车道时间段为9点到10点，如果算路时刻为8点，那么返回的有效期就是 3600,7200 • 只返回当天基准时间之后和第二天的所有时间段示例："0,1200" 表示：距离算路时刻 0到1200秒
		left			左转时间段未返回或者空值，表示社会车全天禁止进入该车道左转	array
		right			右转时间段未返回或者空值，表示社会车全天禁止进入该车道右转	array
		uturn			调头时间段未返回或者空值，表示社会车全天禁止进入该车道调头	array

转向turn_description结构

参数名称

字段含义

字段类型

说明

turn_kind

转向类型

int

用户自行绘制

注：最多返回四个途经点的转向信息，第五个途经点开始不再返回

turn_road_name

转向后的道路名称

string

上地九街

高快速面板highway_info结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
kind					类型	int	0：高速；1：快速示例：0
entry_to_origin_dist					高速入口到路线起点的距离	int	快速路不提供入口位置，用户自定义快速面板的展示时机示例：1200
entry_linkid					高速进入linkid	int	link作为锚，结合距离判断路线一致性示例：1611638157
exit_to_origin_dist					高速/快速出口到路线起点的距离	int	示例：10000
exit_linkid					高速/快速出口linkid	int
exit_num					高速/快速出口的编号	string	手机上显示为 "22 出口" 示例：22
exit_direction					高速出口的方向	string	手机上显示为 "驶往百沙路,百善,小汤山方向" 示例：百沙路,百善,小汤山
exit_road_name					高速/快速出口驶出后进入的道路名称	string	示例：G6 辅路
service_area_list					服务区列表（数组）	array
	uid				服务区唯一id	string
	name				服务区名称	string
	distance_to_origin				服务区到路线起点的距离	int
	linkid				服务区linkid	int	进入服务区前的主干link
	position				服务区坐标	string

收费站tollgate_info结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
name					收费站名称	string	示例：清河收费站

红绿灯lamps结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
linkid					进入红绿灯路口的linkid	int
out_linkid					退出红绿灯路口的linkid	int
pos					红绿灯位置	string
key					用于查询红绿灯数据的key	string	可使用该key查询红绿灯倒计时数据，参考：红绿灯倒计时查询