小客车标准导航

所有文档

服务概览

快速开始

使用准备

接口文档

服务功能

小客车标准导航

相关资料

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

更新时间: 2026/03/31 20:13

小客车标准导航

下载开发文档

API服务地址

行前算路

https://api.map.baidu.com/api_navigate/v1/route_plan?parameters
//GET请求

行中刷新

https://api.map.baidu.com/api_navigate/v1/route_refresh?parameters
//GET请求

行中偏航

https://api.map.baidu.com/api_navigate/v1/yaw?parameters
//GET请求

行中切换路线

https://api.map.baidu.com/api_navigate/v1/route_switch?parameters
//GET请求

注意：parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

请求参数

参数名		参数含义	必选	类型	规则说明
参数名	参数名1	参数含义	必选	类型	规则说明
ak		AK	是	string	用户的访问权限，AK申请
origin		起点坐标	是	string	纬度在前，经度在后，经度和纬度用","分割，经纬度小数点后不得超过6位。
destination		终点坐标	是	string	纬度在前，经度在后，经度和纬度用","分割，经纬度小数点后不得超过6位。
origin_uid		起点 POI 的 UID	否	string	在已知起点POI 的 uid 情况下，请尽量填写uid，将提升路线规划的准确性
origin_uid		起点 POI 的 UID	否	string	在已知起点POI 的 uid 情况下，请尽量填写uid，将提升路线规划的准确性备注：我们针对海量POI建设有导航引导点，如果填写了该参数，将引导到更合理的位置，路线也将更加合理。
destination_uid		终点 POI 的 UID	否	string	在已知终点POI 的 uid 情况下，请尽量填写uid，将提升路线规划的准确性备注：我们针对海量POI建设有导航引导点，如果填写了该参数，将引导到更合理的位置，路线也将更加合理。
origin_road_type		起点道路类型	否	int	0 普通道路 [默认，绑路策略不参考此入参] 1 高架上； 2 高架下； 3 主路； 4 辅路（高速和匝道切换其实相当于主辅路切换）；备注：如果同时传入前序轨迹点和origin_road_type；绑路会以origin_road_type为准
dest_road_type		终点道路类型	否	int	0:普通道路 [默认，绑路策略不参考此入参] 1:高架； 2:高速； 3:隧道； 4:匝道
origin_bind_strategy		起点绑路策略	否	int	0：绑路策略不参考此入参 [默认值] 1：起点不绑封闭道路
dest_bind_strategy		终点绑路策略	否	int	0：绑路策略不参考此入参 [默认值] 1：终点不绑封闭道路
specify_linkid		指定起点绑路的linkid	否	int	指定当前位置所在的linkid；如果linkid在百度路网中可以找到；绑路直接使用该link 数据规格：specify_linkid = 原始linkid * 10 + 方向符号方向符号的计算方法：单向通行link值为0；双向顺行值为0；双向逆行值为1 备注：如果指定linkid，如果百度能找到这个link，会直接使用这
waypoints		途径点坐标	否	string	最多支持18个以内的有序途径点。多个途径点坐标按顺序以英文竖线符号分隔，示例： 40.465,116.314\|40.232,116.352\|40.121,116.453
intelligent_plan		途径点智能排序	否	int	0：不开启智能规划 [默认值] 1：开启智能规划；配合waypoints使用，将多个途径点合理排序，智能规划注：该功能为高级子功能，需通过工单联系工作人员开通
coord_type		传入参数的坐标类型	否	string	bd09ll：百度经纬度坐标 [默认值] bd09mc：百度墨卡托坐标 gcj02：国测局加密坐标） wgs84：gps设备获取的坐标
ret_coordtype		返回结果坐标类型	否	string	bd09ll：百度经纬度坐标 [默认值] gcj02：国测局加密坐标
tactics		算路策略	否	int	0：综合时间、距离、拥堵等因素返回一条最优路线 [默认值] 2：距离最短（只返回一条路线，不考虑限行和路况，距离最短且稳定，可用于估价场景） 3：不走高速 4：高速优先 5：躲避拥堵 6：少收费 7: 躲避拥堵 & 高速优先 8: 躲避拥堵 & 不走高速 9: 躲避拥堵 & 少收费 10: 躲避拥堵 & 不走高速 & 少收费 11: 不走高速 & 少收费 12: 距离优先 13：时间优先 14：时间最短（只返回一条路线，不考虑实时路况，性能高较稳定，可用于估价场景）
special		是否避开轮渡	否	int	0：不生效 [默认值] 1：避开轮渡；有轮渡的情况尽量避开；有轮渡无法避开的情况, 才出轮渡;
cartype		车辆类型	否	int	0：普通汽车 [默认值] 1：纯电动汽车 2：插电混动车备注：用于区分车辆是普通燃油车或纯电动汽车。由于部分城市对燃油车和电动车限行规则有差异，该字段用于结合plate_number车牌号来规避限行。例如：纯电动汽车在北京本地无尾号限行，而燃油车需遵守尾号限行。
plate_number		车牌号	否	string	用于规避车牌号限行路段。示例：京A00022 备注： 1. 若有规避限行区域的可选路线，则返回规避后的路线，不会返回限行路线 2. 若无规避限行的可选路线（如：起终点在限行区域内，或所有符合偏好的路线都无法规避限行区域），则返回限行路线中最优路线，并在返回字段 restriction 中提示用户路段被限行
alternatives		是否返回备选路线	否	int	0：返回一条推荐路线 [默认值] 1：返回1-3条路线供选择
departure_time		未来出行时间	否	int	设置出发时间（支持未来7天）UNIX时间戳取值范围：当前时间之后7天*24小时内任意时刻（超出时间范围将提示参数错误）若设置该参数，则路线规划服务将依据设定时间预测路况和限行规则，并据此计算路线和耗时注：该功能为高级子功能，需通过工单联系工作人员开通
ext_departure_time		历史ETA	否	string	历史出发时间，UNIX时间戳。该字段将影响ext_duration字段的返回，用于返回路线在指定出发时间的耗时。支持输入过去7天内一个或多个出发时间戳（不超过12个），多个时间戳之间用","英文半角逗号隔开。示例： 1）ext_departure_time=1526527619 2）ext_departure_time=1526527619,1526525384,1526523654 注：该功能为高级子功能，需通过工单联系工作人员开通目前出发时间仅影响ext_duration字段，还不会影响路线计算和选择。即仍按照现在的路况计算并推荐路线，但将增加返回该路线在历史时间点的耗时。
expect_arrival_time		期望到达时间	否	int	该字段将影响suggest_departure_time字段的返回；用于返回建议出发时间。取值范围：当前时间之后15分钟的任意时刻（小于这个时间则不做处理）若设置此参数，则路线规划服务将依据设定时间计算路线和耗时，并给出建议出发时间。若算出的suggest_departure_time小于当前时间，则设置suggest_departure_time为-1 注：该功能为高级子功能，需通过工单联系工作人员开通
gps_direction		车头方向	否	int	取值范围：0-359 车头方向为与正北方向顺时针夹角，用于辅助判断起点所在正逆向车道，提升起点绑路的准确度。配合speed使用，当speed>=2米/秒时生效。备注：gps_direction并不代表需填写从gps获取的方向，可以填入校正后的方向。请填写尽量准确的方向，其准确性很大程度决定了计算的精度。
radius		定位精度	否	float	取值范围[0,2000]
speed		车辆的行驶速度	否	float	小数点后不得超过2位，单位：米/秒
location_data		前序轨迹点	否	string	可传入最多25个点，可用于提升绑路准确性。连续两点间的距离>2m，点越多绑路越准；前向轨迹点最后一个点和起点距离应小于<200m。点的顺序由远到近，即序列的最后一个点为当前点。一组轨迹点包含以下信息： • 经度 (坐标类型由coord_type参数指定) • 纬度 (坐标类型由coord_type参数指定) • 绑路后的经度（坐标类型由coord_type参数指定）默认值填写0 • 绑路后的纬度（坐标类型由coord_type参数指定）默认值填写0 • 海拔高度 (字段类型：int, 参考范围 0-5000) 默认值填写0 • 速度 (字段类型：int, 参考范围 0-56 米/秒) • 方向 (字段类型：int, 参考范围 0-359) • 定位精度半径(字段类型：int, 参考范围 0-2000 米) 默认值填写10 • 定位类型(字段类型：int, 0 无效 1 gps 2 wifi) 默认填写0 • 室内外(字段类型：int, 0 无效 1室内 2 室外) 默认值填写0 • 卫星个数（字段类型：int）默认值填写0 • 时间戳（字段类型：int，单位：秒）示例： 117.148152,39.16029,117.148141,39.16010,82,10,270,46,1,2,4,1595591245; 117.148121,39.160283,117.148111,39.160283,82,10,270,46,1,2,4,1595591246; 117.148053,39.16029,117.148053,39.16029,82,10,270,46,1,2,4,1595591247; 117.147959,39.160293,117.147944,39.160288,82,10,270,46,1,2,4,1595591248; 117.147927,39.160283,117.147915,39.160271,82,10,270,46,1,2,4,1595591249; 117.14786,39.160283,117.14775,39.160277,82,10,270,46,1,2,4,1595591250; 117.147779,39.160279,117.147765,39.160268,82,10,270,46,1,2,4,1595591251; 117.147739,39.160293,117.147749,39.160263,82,10,270,46,1,2,4,1595591252; 117.147662,39.160262,117.147652,39.160272,82,10,270,46,1,2,4,1595591353; 说明：（1）起点静止算路：location_data期望传入上次熄火前的定位点序列。（因为车辆刚启动时可能定位漂移比较严重）（2）行中的话，建议刷新路况和偏航请求都传入轨迹点；因为这两个请求都可能算新路线。
sn		用户的权限签名	否	string	当AK设置为SN校验时，该参数必填SN计算方法
timestamp		时间戳，与SN配合使用	否	int	SN存在时必填
extensions		扩展功能选项	否	string	用于控制是否返回路口放大图、linkid、诱导信息等扩展功能。 guidance：导航引导信息，包含路口放大图、诱导语音、车信等数据 plink: 路线的linkid序列 speed_limit：link的线限速数据 lamp：路线上的红绿灯数据示例：guidance,plink,speed_limit,lamp 注：该功能为高级子功能，需通过工单联系工作人员开通
ext_info		扩展功能选项	否	uint64	用于控制扩展数据的下发，如果需要多种数据，可以使用下列几个值做或操作。 0x01：指定不制作诱导（可提高算路性能） 0x04：路线上的服务区列表 0x08：路线上的电子眼列表 0x10：路线上的动态事件列表 0x40：路线上link的基本属性数据（长度、ETA、方向） 0x80：step上每段路况对应的形状点序列（非高级子功能）注：该功能为高级子功能，需通过工单联系工作人员开通
walkinfo		返回起点和终点步行导航路线	否	int32	例如：终点的孤岛上时，车无法过去，可以给出步行导航路线(包含轮渡) 0：不返回起点和终点的步行导航路线 1：返回起点和终点的步行导航路线
gdver		诱导版本号	否	string	用于控制返回的诱导内容。可指定固定值：20201201 备注：部分诱导信息可能和端上的支持策略有关，为避免后续升级后导致低版本端上的诱导播报有问题，通过版本控制。
verbal_mode		导航诱导语音播报的模式	否	string	simple：简洁模式 [默认值，只包括机动点、建筑物播报] simple_v2：简洁模式 [和app上简洁播报策略一致，包含机动点、电子眼等播报，但是播报次数较少] standard：标准模式
img_color_schema		导航路口放大图的模式（白天 or 黑夜）	否	string	1：白天 [默认值] 2：黑夜如果白天和黑夜都需要，可以填写 1,2
state			否	int	如果算完路后，还需要调用其他API做行中导航。需指定该值为0。指定该值后，服务端会保存和维系整个导航过程中的session状态。注：该功能为高级子功能，需通过工单联系工作人员开通
output		返回结果格式类型	否	string	可选值：json
callback		回调函数	否	string	callback 值是用户定义的函数名称，此参数只在 output 参数设置为 JSON 时有效。

返回参数

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
status					状态码	int	0：成功 1：服务内部错误（用户可以重试一次） 2：参数错误 9001：服务错误（用户不需重试）其他错误码参考：https://lbsyun.baidu.com/faq/api?title=webapi/appendix
message					状态值的说明	string
result						object
	restriction				限行结果提示	string	1. 若无限行路线，则返回空 2. 若无法规避限行，则返回限行提示信息
	yellow_tip				全局小黄条（如：终点在限行区域）	array	参考下文中的 "小黄条 yellow_tip结构"
	total				返回的路线数量	int
	start_walk				起点步导路线	array
		distance			路线距离	int
		pts			坐标点序列；多个坐标之间用分号分隔	string
		route_md5			与routes数组中的route_md5匹配	string
	end_walk				终点步导路线	array
		distance			路线距离	int
		route_md5			与routes数组中的route_md5匹配	string
	routes				路线集合	array
		origin			路线的起点	object
		destination			路线的终点	object
		route_id			路线唯一标识	string
		route_md5			路线md5	string
		distance			路线距离	int	单位：米
		duration			路线耗时	int	单位：秒
		traffic_light			路线上的红绿灯数量	int
		taxi_fee			出租车费用	int	单位：元
		toll			过路费	int	单位：元此高速费为预估价格，与实际高速收费并不完全一致
		toll_distance			收费路段里程	int	单位：米
		tag			路线标签	string	例如：“红绿灯少”、“道路多”、“方案三”
		score			路线评分	float	分值越大，路线相对越优。
		yellow_tip			路线上的小黄条（路线限行提醒）	array	参考下文中的 "小黄条 yellow_tip结构"
		steps			路线分段数据	array	考下文中的 “路线分段 step结构”
		suggest_departure_time			建议出发时间	array	单位：秒只有传入合法的 expect_arrival_time 才会下发该字段注：该功能为高级子功能，需通过工单联系工作人员开通
		ext_duration			历史ETA，多个值用英文半角逗号','分隔	array	单位：秒只有传入合法的 ext_departure_time 才会下发该字段注：该功能为高级子功能，需通过工单联系工作人员开通
		linkids			路线的linkid序列	string	只有传入 extensions=plink 才会下发该数据注：该功能为高级子功能，需通过工单联系工作人员开通
		lamps			路线上的红绿灯数据	array	只有传入 extensions=lamp 才会下发该数据参考下文中的 "红绿灯 lamps结构" 注：该功能为高级子功能，需通过工单联系工作人员开通
		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结构” 注：该功能为高级子功能，需通过工单联系工作人员开通

路线分段step结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
start_location					step的起点坐标	object
end_location					step的终点坐标	object
leg_index					途径点序号	int	途径点序号为从0开始的整数，用于标识step所属的途径点路段。如：若该step属于起点至第一个途径中的路段，则其leg_index为0
distance					step的距离信息	int	单位：米
duration					step的耗时	int	单位：秒
road_name					道路名称	string	如“信息路“ 若道路未命名或百度地图未采集到该道路名称，则返回"无名路"
instruction					step转向描述	string
road_type					道路类型	int	枚举值：返回0-9之间的值 0：高速路 1：城市高速路 2：国道 3：省道 4：县道 5：乡镇村道 6：其他道路 7：九级路 8：航线(轮渡) 9：行人道路
path					step的坐标点序列	string	多个坐标点之间用';'分隔，单个坐标的经纬度之间用','分隔
traffic_condition					step的路况详情	array
	status				路况指数	int	0：无路况 1：畅通 2：缓行 3：拥堵 4：非常拥堵
	geo_cnt				从当前坐标点开始，path中路况相同的坐标点个数	int
	distance				距离，从当前坐标点开始path 中路况相同的距离	float	单位：米注：单条线路中所有distance的和会与route的distance字段存在差异，不是完全一致
adcodes					step途径的城市编码	string	若途经多个城市，则adcode以英文半角逗号相隔如：110000,120000
link_num					step包含link个数	int	可以和linkids配合使用，确认当前step包含的linkid序列
direction					进入道路的角度	int	枚举值，返回值在0-11之间的一个值，共12个枚举值，以30度递进，即每个值代表角度范围为30度；其中返回"0"代表345度到15度，以此类推，返回"11"代表315度到345度"；分别代表的含义是：0-[345°-15°]；1-[15°-45°]；2-[45°-75°]；3-[75°-105°]；4-[105°-135°]；5-[135°-165°]；6-[165°-195°]；7-[195°-225°]；8-[225°-255°]；9-[255°-285°]；10-[285°-315°]；11-[315°-345°] 注：角度为与正北方向顺时针夹角
toll					step的过路费	int	单位：元因一个收费路段可能覆盖多个step，部分情况下费用无法按step准确拆分，故分段step收费可能存在不准确情况
toll_distance					step的收费路段里程	int	单位：米
toll_gate_name					收费站名称	string	只有在进收费站和出收费站时才有
toll_gate_location					收费站位置	object	只有在进收费站和出收费站时才有
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					收费站名称	stirng	示例：清河收费站

小黄条yellow_tip结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
yellow_tip					小黄条	array	• 【黄条】算路页展示的黄条会将路线上和全局的小黄条列表按照 priority 排序，选出一个优先级最高的黄条的title来展示。 • 【小度条】算路页展示的小度条，在客户端上会轮播切换展示，轮播每个group的 tag_info。
	type				0：黄条（风险警示，与用户是否可以顺利出行有关） 1：路线印象（消除顾虑/告知优势/惊喜点信息感知，针对路线本身质量的解释） 11：小度条（用于强调路线优势或中性内容）	int32	数组中，各个类型，最多只有一个。示例：
	group				分组（同类型的做一个分组）	array
		tag			同一类型的黄条聚合后展示的标签	string
		tag_info			同一类型的黄条聚合后展示的内容	string
		tips				array
			tip_id		唯一标识ID	int32	可支持的类型列表见附录示例：74（表示：窄路无法避开）
			priority		优先级	int32	对于type=0的小黄条，priority值越小优先级越高。对于type=11的小度条，priority值越大优先级越高.
			back_color		背景颜色	int32	0：黄色（默认） 1：白色 2：红色 4：绿色 5：蓝色
			title		单个黄条标题	string	示例：“胡韦线道路狭窄，请注意行车安全”
			first_line		第一行文案	string
			second_line		对应手图第二行文案	array（数组成员是string类型）
			event_id		黄条关联的事件id	int64	黄条对应的事件；跟event_list中的事件id可以对应
			traffic_limit_info_id		黄条关联的事件id	array（数组成员是string类型）

红绿灯lamps结构

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

服务区列表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	该字段一定会下发示例：95
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 中间车道l；3 右侧车道示例：3	int32

link道路属性link_attr结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
speed_limit					每个link的线限速	string	用 "\|"分隔，数量和linkid数量一致。
len					每个link的长度	string	用 "\|"分隔，数量和linkid数量一致。
eta					每个link的ETA	string	用 "\|"分隔，数量和linkid数量一致。
navi_dir					每个link的方向	string	用 "\|"分隔，数量和linkid数量一致。 0表示单向通行或者双向顺行，1表示双向逆行

使用准备

更新日志

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