小客车巡航API

所有文档

服务概览

快速开始

使用准备

接口文档

服务功能

小客车巡航API

相关资料

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

小客车巡航API

下载开发文档

API服务地址

行前探路

https://api.map.baidu.com/api_cruise/v1/detection?parameters
//GET请求

行中刷新

https://api.map.baidu.com/api_cruise/v1/refresh?parameters
//GET请求

行中偏航

https://api.map.baidu.com/api_cruise/v1/detection?parameters
//GET请求

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

请求参数

参数名	参数含义	类型	规则说明	必选
ak	用户的访问权限，AK申请	string		是
origin	起点坐标	string	纬度在前，经度在后，经度和纬度用","分割，经纬度小数点后不得超过6位	是
gps_direction	车头方向	int	取值范围：0-359 车头方向为与正北方向顺时针夹角，用于辅助判断起点所在正逆向车道，提升起点绑路的准确度。配合speed使用，当speed>=2米/秒时生效。	否
radius	定位精度	float	取值范围[0,2000]	否
speed	车辆的行驶速度	float	小数点后不得超过2位，单位：米/秒	否
point_list	轨迹点序列	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，单位：秒）示例：116.2933926662019%2C40.05835245777301%2C0%2C0%2C0%2C10%2C270%2C10%2C1%2C2%2C4%2C1739958189%3B116.2931775955409%2C40.05831344147389%2C0%2C0%2C0%2C10%2C270%2C10%2C1%2C2%2C4%2C1739958190%3B116.29293056152558%2C40.05825828232061%2C0%2C0%2C0%2C10%2C270%2C10%2C1%2C2%2C4%2C1739958191%3B116.29268352751026%2C40.05821002612613%2C0%2C0%2C0%2C10%2C270%2C10%2C1%2C2%2C4%2C1739958192%3B116.29247242571535%2C40.05817212440589%2C0%2C0%2C0%2C10%2C270%2C10%2C1%2C2%2C4%2C1739958193%3B116.29227479850309%2C40.0581411256737%2C0%2C0%2C0%2C10%2C270%2C10%2C1%2C2%2C4%2C17	否
coord_type	传入参数的坐标类型	string	bd09ll：百度经纬度坐标 [默认值] bd09mc：百度墨卡托坐标 gcj02：国测局加密坐标）、 wgs84：gps设备获取的坐标默认值：bd09ll	否
ret_coordtype	返回数据的坐标类型	string	bd09ll：百度经纬度坐标 [默认值] gcj02：国测局加密坐标默认值：bd09ll	否
ext_info	指定需要下发的数据	uint64	可选值（如果需要多种数据，用位或关系赋值）： 0x01：指定存储session（如果不指定，行中请求将会退化为行前逻辑） 0x02：指定下发红绿灯数据 0x04：指定下发电子眼 0x08：指定下发动态事件（暂未上线） 0x10：指定下发诱导车信默认值：0	否
specify_linkid	指定起点绑路的linkid	int	指定当前位置所在的linkid；如果linkid在百度路网中可以找到；绑路直接使用该link 数据规格：specify_linkid = 原始linkid * 10 + 方向符号方向符号的计算方法：单向通行link值为0；双向顺行值为0；双向逆行值为1	否
route_id	行中请求，需要传入当前路线的route_id	string	行中请求，必须传入	否

返回参数

参数名称			字段含义	字段类型	说明
status			状态码	int	0：成功 1：服务内部错误（用户可以重试一次） 2：参数错误 9001：服务错误（用户不需重试）其他错误码参考：https://lbsyun.baidu.com/faq/api?title=webapi/appendix
message			状态值的说明	string
result				object
	total		返回的路线数量	int
	routes		路线集合	array
		route_id	路线唯一标识	string
		distance	路线距离	int	探测到的路线总长度，单位：米
		steps	路线分段数据	array	参考下文中的 “路线分段 step结构”
		linkids	路线的linkid序列	string
		lamps	路线上的红绿灯数据	array	参考下文中的 "红绿灯 lamps结构"
		camera_list	路线上的电子眼列表	array	参考下文中的 "电子眼列表 camera_list结构"
		new_link_attr	相对于sdpro的增量link	array	参考下文中的 "增量link new_link_attr结构" 每个新增link的属性（对于linkid没有发生变化，仅下发有变更的属性新增 link的判断条件：（1）起终点位置变化超过2米（默认阈值）；用户可以传入offset_threshold参数自行调控。（2）linkid在特斯拉数据版本中找不到。（3）kind=10或者11；form包含22或者70 的link。（4）DIR发生变化。

路线分段step结构

参数名称		字段含义	字段类型	说明
distance		step的距离信息	int	单位：米
duration		step的耗时	int	单位：秒
traffic_condition		step的路况详情	array
	status	路况指数	int	0：无路况 1：畅通 2：缓行 3：拥堵 4：非常拥堵
	geo_cnt	从当前坐标点开始，path中路况相同的坐标点个数	int
	distance	距离，从当前坐标点开始path 中路况相同的距离	float	单位：米注：单条线路中所有distance的和会与route的distance字段存在差异，不是完全一致
link_num		step包含link个数	int	可以和linkids配合使用，确认当前step包含的linkid序列
guidance		路线上的导航引导数据	object	可以和linkids配合使用，确认当前step包含的linkid序列
	visual_instructions	路线上的可视化的引导数据	array	参考下文中的 “导航可视化引导 visual_instructions 结构”

导航可视化引导visual_instructions结构

参数名称		字段含义	字段类型	说明
distance_to_origin		诱导点到路线起点的距离	int	单位：米
linkid		诱导点对应的linkid	int
position		诱导点坐标	string
	lane_info	车信	array	参考下文中的 “车信 lane_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

电子眼列表camera_list结构

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

红绿灯lamps结构

参数名称	字段含义	字段类型	说明
linkid	进入红绿灯路口的linkid	int
out_linkid	退出红绿灯路口的linkid	int
pos	红绿灯位置	string
key	用于查询红绿灯数据的key	string	参考：https://lbsyun.baidu.com/faq/api?title=webapi/countlight/base

使用准备

更新日志

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

导航可视化引导visual_instructions结构