小客车标准导航

所有文档

服务概览

快速开始

使用准备

接口文档

服务功能

小客车标准导航

相关资料

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

小客车标准导航

下载开发文档

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 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

请求参数

参数名	参数含义	必选	类型	规则说明
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 时有效。

返回参数

参数名称			字段含义	字段类型	说明
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结构

参数名称		字段含义	字段类型	说明
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 结构

参数名称	字段含义	字段类型	说明
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结构

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

导航引导语音verbal_instructions结构

参数名称		字段含义	字段类型	说明
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结构

参数名称		字段含义	字段类型	说明
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结构

参数名称			字段含义	字段类型	说明
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结构

参数名称		字段含义	字段类型	说明
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结构

参数名称					字段含义	字段类型	说明
name					收费站名称	stirng	示例：清河收费站

小黄条yellow_tip结构

参数名称				字段含义	字段类型	说明
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结构

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

服务区列表service_list结构

参数名称		字段含义	字段类型	说明
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结构

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

动态事件列表event_list结构

参数名称				字段含义	字段类型	说明
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结构

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

使用准备

更新日志

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