扩展数据下发 | 小客车标准导航 | 百度地图开放平台文档中心

所有文档

小客车标准导航

服务概览

快速开始

使用准备

接口文档

服务功能

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

进阶能力

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

相关资料

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

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

小客车标准导航 - 扩展数据下发

接口说明

用于控制服务区、电子眼、动态事件、link道路属性、沿途搜等扩展数据的下发，需要多种数据时可将多个值做或运算后传入。
例如：ext_info=92（0x04 | 0x08 | 0x10 | 0x40）表示同时返回服务区列表、电子眼列表、动态事件列表和link道路属性。

使用说明

该功能为高级子功能，需要开通高级权限后方可使用。
如果您已开通了该功能，返回结果的每条路线中将按传入的值下发对应数据。使用沿途搜数据（0x200）时，需同时传入 store_session=1，并通过 word 指定沿途搜关键词。

API服务地址

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

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

请求参数

参数名称	参数含义	字段类型	必选	备注
参数名称	参数含义	字段类型	必选	备注
ext_info	扩展功能选项用于控制扩展数据的下发，如果需要多种数据，可以使用下列几个值做或操作。 0x01：指定不制作诱导（可提高算路性能） 0x04：路线上的服务区列表 0x08：路线上的电子眼列表 0x10：路线上的动态事件列表 0x40：路线上link的基本属性数据（长度、ETA、方向等信息） 0x100：裁剪部分路线，提升算路性能 0x200：沿途搜数据（如果需要用沿途搜数据，同时要传入store_session=1）	uint64	否	注：该功能为高级子功能，需通过工单联系工作人员开通
store_session	是否存储session 0：不存储session [默认值] 1：存储session	int	否	注：该功能为高级子功能，需通过工单联系工作人员开通
word	如果使用沿途搜，传入沿途搜的关键词	string	否

返回参数

返回参数		含义	类型	备注
返回参数	返回参数2	含义	类型	备注
routes		路线集合	array
	service_list	路线上的服务区列表	array	ext_info & 0x04 > 0 时下发参考下文中的 “服务区列表service_list结构”
	camera_list	路线上的电子眼列表	array	ext_info & 0x08 > 0 时下发参考下文中的 “电子眼列表camera_list结构”
	event_list	路线上的动态事件列表	array	ext_info & 0x10 > 0 时下发参考下文中的 “动态事件列表event_list结构”
	link_attr	路线上link的基本道路属性	object	ext_info & 0x40 > 0 时下发参考下文中的 “link道路属性link_attr结构”
	search_by_route	沿途搜的数据	object	ext_info & 0x200 > 0 时下发参考下文中的 “沿途搜search_by_route结构”

服务区列表service_list结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
uid					服务区唯一id	string
linkid					服务区所在的linkid	int
position					服务区所在的坐标	string
name					服务区名称	string	示例：嘉兴服务区
status					状态	int	0：未调查；1：开启；2：关闭
usage_rate					服务区心跳信息	string	示例：10分钟内有人来过
sub_type					服务区子类型	int	0x001加油、0x002充电、0x004加气、0x008停车、0x010汽修、0x020餐饮、0x040厕所、0x080超市、0x100休闲（按位或）
charge_info					充电站信息	array
	uid				uid	string	示例："6c31101ae82317b4601c6705"
	brand_name				品牌名称	string	品牌类型包括这几种：国家电网，小鹏，理想，特来电，星星充电。其他的都展示“其他品牌” 示例：国家电网
	total_num				所有充电桩数量	int	示例：2
	fast_total_num				所有快充数量	int	示例：2
	slow_total_num				所有慢充数量	int	示例：0
catering_info					餐饮信息	object
	count				餐饮数量	int	这个服务区所有的餐饮品牌个数
	brand_ids				餐饮品牌列表	array	元素是string类型，每个元素代表一个品牌 (目前最多只吐出三个)

电子眼列表camera_list结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
type					电子眼类型	int
speed_limit					限速值（单位 km/h）	int
priority					优先级	int	数值越小优先级越高
position					坐标点（经度,纬度）	string
linkid					坐电子眼所在的linkid	int

动态事件列表event_list结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
jam_info					拥堵事件	array
	link_start				拥堵起始link索引示例：19	int	该字段一定会下发
	link_count				拥堵link数量示例：9	int
	description				拥堵事件描述示例：天府大道北段拥堵	string
	duration				拥堵通行时间，单位秒示例：438	int
	length				拥堵长度，单位米示例：1127	int
	has_jamed_time				已经拥堵的时长，单位秒	int	有数据则下发，没有数据则不下发该字段示例：4680
	ext_info				拥堵路段的其他信息融合了一些拥堵关联的事件	object	只有行中刷新路况、偏航算路才可能下发该字段。
		events			与拥堵关联的事件	array	有数据则下发，没有数据则不下发该字段
			type		事件类型	int	该字段一定会下发 6：普通拥堵 7：事故 8：施工 9：管制 10：出口排队 11：入口排队 12：收费站排队 13：检查站排队示例：事件类型
			position		事件所在的坐标	string	该字段一定会下发示例：104.06662,30.63304
			link_idx		事件在路线上的link索引	int	该字段一定会下发示例：94
			content		事件描述文本	string	有数据则下发，没有数据则不下发该字段示例：事故
			sub_content		子事件描述文本	string	有数据则下发，没有数据则不下发该字段示例：追尾
		light_info			与拥堵路段关联的等灯数据	array	有数据则下发，没有数据则不下发该字段
			light_queue_length		一次红绿灯周期能走多少米	int	app上使用 ( 用户当前位置与红绿灯的距离 / light_queue_length ) 可以计算得到需要等几轮红绿灯。示例：241
			link_idx		红绿灯link在路线上的索引	int	该字段一定会下发示例：95
			link_offset		红绿灯与link起点的距离	int	该字段一定会下发示例：34
incident					用户上报事件列表	array
	id				事件id 该字段一定会下发（后续如有需求，我们也可以提供单独的事件查询接口，使用该id号来查询事件更加详细的内容）示例：1779699783457280	int64
	type				事件类型该字段一定会下发具体类型参考：下文附录中的“用户上报事件类型表” 示例：110	int
	link_idx				事件在路线上的link索引该字段一定会下发示例：63	int
	position				事件在地图上展示用的坐标该字段一定会下发（注意：这个坐标是客户端事件气泡展示的位置坐标，并不一定是事件的精确位置，也不一定在 link 上）示例：104.06698,30.62282	string
	digest				事件的简要说明有数据则下发，没有数据则不下发该字段示例：施工	string
	description				事件描述有数据则下发，没有数据则不下发该字段示例：道路施工,堵1.2公里	string
	lane_num_info				事件占用的车道数有数据则下发，没有数据则不下发该字段占用的车道数： -1表示全部车道；第31位表示应急车道；其他位表示：从左到右占用的车道数 (如：2表示占用了从左往右数第2个车道；3表示占用了从左往右数第1和第2个车道) 示例：2	int32
	lane_num_type				事件占用的车道类型有数据则下发，没有数据则不下发该字段 1 左侧车道； 2 中间车道；3 右侧车道示例：3	int32
	road_name				道路名称示例：西二环	string
	severity				事件严重程度 1：一般；2：重要；3：轻微；4：严重示例：1	string
	traffic				对道路通行能力的影响 0：影响未知；1：无影响；2：通行能力下降；3：完全阻断；4：交通阻断（禁左、禁右、禁掉头）示例：0	int

link道路属性link_attr结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
src_linkid					原始linkid	string	用 "\|"分隔，数量和linkid数量一致。备注：待上线
speed_limit					每个link的限速	string	用 "\|"分隔，数量和linkid数量一致。
len					每个link的长度	string	用 "\|"分隔，数量和linkid数量一致。
eta					每个link的ETA	string	用 "\|"分隔，数量和linkid数量一致。
navi_dir					每个link的方向	string	用 "\|"分隔，数量和linkid数量一致。 0表示单向通行或者双向顺行，1表示双向逆行
road_name_idx					每个link对应的道路名称索引	string	用 "\|"分隔，数量和linkid数量一致。备注：待上线
points_idx					形状点索引	string	link的坐标点索引，{step_idx},{起点idx},{终点idx}
road_level					道路等级	string	用 "\|"分隔，数量和linkid数量一致。
attr					道路属性	string	用 "\|"分隔，数量和linkid数量一致。
empirical_speed					经验限速	string	用 "\|"分隔，数量和linkid数量一致。
traffic_light					是否有红绿灯	string	用 "\|"分隔，数量和linkid数量一致。
adcode					行政区编码	string	用 "\|"分隔，数量和linkid数量一致。两个数字，第一个是link左侧的编码，第二个是link右侧的编码
base_link_direc					link的通行方向	string	用 "\|"分隔，数量和linkid数量一致。
lane_num					车道数	string	用 "\|"分隔，数量和linkid数量一致。
overhead					是否高架	string	用 "\|"分隔，数量和linkid数量一致。
parallel_type					是否有平行路（平行路包括高架、主辅路）	string	用 "\|"分隔，数量和linkid数量一致。
end_cross					是否路口	string	用 "\|"分隔，数量和linkid数量一致。
road_en_ex					主辅路出入口	string	用 "\|"分隔，数量和linkid数量一致。 0：非主辅路出入口；1：主路出口；2：主路入口
camera_idx					电子眼列表	string	用 "\|"分隔，数量和linkid数量一致。多个电子眼之间用英文逗号分隔
structure					天桥地道属性	string	用 "\|"分隔，数量和linkid数量一致。

注：api_navigate/v1/route_query 接口目前没有 empirical_speed、base_link_direc、parallel_type、structure 这几个字段。

沿途搜search_by_route结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
data_src					数据来源	int	1：导航自建数据 2：周边搜数据（如果路线session查询失败或者沿途搜查询失败，会兜底走周边搜） 3：沿途搜数据
data						array
	name				名称	string	如果关键词为“天气”，返回途经市的名称
	uid				poi的uid	string	如果关键词为：途经路、途经市、天气，不返回这个数据
	position				坐标，先经度后纬度	string	poi的坐标点
	dist2cur				距当前位置的行驶距离	int
	dura2cur				距当前位置的行驶时间	int	如果关键词为“途经路”，不返回这个数据
	cost_dist				绕路距离	int	示例：331 对于以下关键词不会返回该数据：服务区（服务区是在路线上的，可以认为绕路代价是0）、途经市、途经路、天气。
	cost_time				绕路时间（秒）	int	示例：105
	charge_info				充电站数据	object	驾车沿途搜，如果关键词是“充电”、“充电站”、“充电桩”会返回这部分数据
		brand_name			充电站品牌	string
		charge_fee			充电单价	double
		service_area			是否服务区内	int	1：表示在服务区内
	service_info				服务区数据	object	驾车沿途搜，如果关键词是“服务区”会返回这部分数据
		usage_rate			服务区使用情况	string	示例：6天内有人去过
		catering			服务区的餐饮信息（餐饮品牌）	object
			brands		餐饮品牌	string
		gas_station_info			服务区的加油站信息	array
			uid		加油站uid	string
			name		加油站名称	string
			status		状态	int	1：表示状态正常
			oil		油品信息	array
				name	油品名称	string	如：92#、95#
				price	油价	int32
		charge_station_info			服务区的充电站信息	array
			uid		充电站uid	string
			name		充电站名称	string
			charge_fee		电价	double
	weather_info				天气数据	object	驾车沿途搜，如果关键词是“天气”会返回这部分数据
		weather			天气	string	示例：雷阵雨
		weather_type			天气类型	int
	via_road_info				途经路数据	object	驾车沿途搜，如果关键词是“途经路”会返回这部分数据
		max_lane_num			最大车道数	int
		min_lane_num			最小车道数	int
		max_speed_limit			最大限速	int
		min_speed_limit			最小限速	int

附录：用户上报事件类型表

类型	枚举值	备注
类型	枚举值	备注
拥堵事件	101	路况事件
交通事故	102
交通管制	103
封路	104
故障车	105
警察	106
危险	107
施工	110
预上线	111
交通阻断	112
融雪	113
道路结霜	114
冻雨	115
能见度	116
干燥	117
路面湿滑	118
冰雪（结冰+积雪混合）	119
雪水（积雪+积水混合）	120
路面有露水	121
疫情检查站	129
异常事件	132
大雾	401	恶劣天气
结冰	403
积雪	404
积水	405
冰雹	409
山体崩塌	501	自然灾害
山体滑坡	502
泥石流	504
路面塌陷/沉降或开裂	505
大型活动	600	大型活动
大型赛事	601
大型会议	602
大型考试	603
大型展会	604
外事活动	605
货车多	2201
行人多	2202
停车多	2203
摆摊多	2204
非机动车多	2205
盘山路	2206
违章高发	3105
极速行驶	2102
畅快行驶	2103
速度平稳	2104
低速行驶	2105
缓慢挪动	2110
走走停停	2111
龟速行驶	2112
车流量大	2120
车流量中	2121
车流量小	2122
绿波路段	2220
通行困难	2222
封路	2223
限行	2224
内部大门	2225
封闭大门	2226
路障	3103
救护车	4102
小路	4301
限宽	4302
道路疑似阻断	4304
分时段限行 - 禁止右转	4305
分时段限行 - 禁止直行	4306
分时段限行 - 禁止左转	4309
分时段限行 - 禁止掉头	4310
小路颠簸	4321
小路未铺设	4322
小路未安装路灯	4323
禁止直行	5000
禁止左转	5001
禁止右转	5002
禁止掉头	5003
禁止通行	5004
非机动车道	5005
紧闭大门	5006
窄路	5007
颠簸	5008
跨多车道	5009
疑似阻断	5010
无路灯	5011
异常大门	5012

如您需要使用扩展数据下发，请点击工单联系工作人员开通。

导航引导扩展信息

行中导航

本篇文章对您是否有帮助？