小客车巡航API

所有文档

服务概览

快速开始

使用准备

接口文档

服务功能

小客车巡航API

相关资料

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

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

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

请求参数

参数名		参数含义	类型	规则说明	必选
参数名	参数名1	参数含义	类型	规则说明	必选
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	行中请求，必须传入	否

返回参数

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
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结构

参数名称					字段含义	字段类型	说明
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	说明
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结构

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

电子眼列表camera_list结构

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

红绿灯lamps结构

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

使用准备

更新日志

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

导航可视化引导visual_instructions结构