矩形区域动态事件检索 | 动态交通事件 | 百度地图开放平台文档中心

所有文档

动态交通事件

服务概览

接口文档

行政区划动态事件检索矩形区域动态事件检索路线动态事件检索

快速开始

使用准备

相关资料

更新日志附录

更新时间: 2026/11/09 21:20

矩形区域动态事件检索

接口说明

支持按矩形区域（bbox）检索动态交通事件，默认仅返回当前生效的事件。事件位置信息可按原始坐标或 linkid 输出。

请求地址

https://api.map.baidu.com/trafficincident/v1/bound?bbox=116.41,39.92;116.40,39.91&output_geo_type=1&ak=您的ak
//GET请求

请求参数

参数名称	参数含义	示例	类型	必选
参数名称	参数含义	示例	类型	必选
bbox	矩形检索区域，格式为“右上角经度,右上角纬度;左下角经度,左下角纬度”。矩形在经度、纬度方向的长度均需小于 2km	116.41,39.92;116.40,39.91	string	是
road_type	按道路类型筛选，取值范围 1~9（见附录道路类别）。如设置 3，则只返回道路类型 ≤ 3 的事件	3	int	否
coord_type	请求坐标的坐标系，可选值：bd09ll、gcj02ll，默认 bd09ll	bd09ll	string	否
effect_time	过滤在指定时间生效的事件，UNIX 时间戳（秒）。不传或传 0 时取当前时间	0	int	否
output_geo_type	控制 geo_info 中地理信息的输出类型。可选值： 1：输出原始经纬度坐标 3：输出 linkid 及其相关参数（offset、length、heading、kind）	1	string	是
vehicle_type	按事件影响的车辆类型筛选，多个类型用英文逗号分隔。取值：1 小客车、2 货车、3 摩托车、4 关联客车、5 关联货车、6 关联摩托车。不传或传空表示不按车型过滤，返回所有事件	1,2	string	否
ak	开发者密钥，用于服务鉴权与配额统计	您的ak	string	是

返回参数

返回参数					类型	备注
返回参数	返回参数1	返回参数2	返回参数3	返回参数4	类型	备注
status					int	状态码，0 表示成功，其他取值详见下方服务状态码
message					string	状态码对应的说明信息
total					int	满足查询条件的事件总数
size					int	本次返回的事件条数
events					array	事件列表，按事件更新时间排序
	id				int	事件唯一标识
	status				int	事件状态。6：正常发布；7：事件已下线
	type				int	事件类型编码，取值见附录“type 与 type_desc 对应关系”
	type_desc				string	事件类型描述，与 type 的对应关系见附录
	severity				string	事件严重程度。1：一般；2：重要；3：轻微；4：严重（3、4 目前仅路面事件使用）
	traffic				int	对道路通行能力的影响。0：影响未知；1：无影响；2：通行能力下降；3：完全阻断；4：交限阻断（禁左、禁右、禁调头）
	vehicle_type				string	事件影响的车辆类型列表，多个用英文逗号分隔。取值：1 小客车、2 货车、3 摩托车、4 关联客车、5 关联货车、6 关联摩托车。为空表示影响所有车辆类型
	start_time				string	事件开始生效时间
	offline_time				string	事件失效时间
	update_time				string	事件更新时间，可作为下一次增量查询的 update_time 入参
	title				string	事件标题
	content				string	事件内容
	geo_info				object	事件地理信息
		adcode			int	行政区划编码，取值可参考百度地图行政区划 adcode 映射表
		province			string	省份名称
		city			string	城市名称
		road_name			string	道路名称
		road_type			int	道路类型，见附录道路类别
		icon_location			string	事件显示坐标，格式为“经度,纬度”。坐标系为gcj02ll，不受请求参数 coord_type 影响
		geo_coordinates			object	地理坐标信息，由 output_geo_type 决定是否返回
			locations		array	位置引用列表，一个事件可能影响多段道路
				geo_type	int	几何类型。1：点；2：线
				coordinates	string	位置坐标串，格式为“经度,纬度;经度,纬度;…”。坐标系为gcj02ll，不受请求参数 coord_type 影响
				linkid	string	道路 link 标识。单向通行的 link 末尾补 0；双向通行的 link 拆分为两条，正向末尾补 0，逆向末尾补 1
				offset	int	事件起点距该 link 起点的长度，与 length 共同确定事件在 link 上的区间。由 output_geo_type 决定是否返回
				length	int	事件在该 link 上的影响长度。由 output_geo_type 决定是否返回
				heading	int	事件影响方向（相对 link 走向，起点→终点为“顺”）。1：双向；2：单向顺；3：单向逆。注意这是事件影响的方向而非道路通行方向，双向道路上的事件也可能只影响单向
				kind	int	该 link 的道路等级，取值同 road_type（见附录道路类别）

服务状态码

返回码	英文描述	定义
返回码	英文描述	定义
0	ok	正常
1	traffic-incident-service inner error / search events failed / search events success, but format failed	服务内部错误
2	[bbox] is required / [coord_type] is invalid, only suport gcj02ll \| bd09ll / [output_geo_type] is invalid / [road_type] is invalid / [vehicle_type] is invalid	参数非法：必填参数缺失或取值不合法，message 返回具体原因；英文描述为接口返回的原文，“suport”为接口原文拼写，请按原文匹配
5	param bbox is too big	检索范围过大：bbox 对角线长度超过 250km
1001	have no permission to access this data	无数据访问权限：检索结果中存在当前 ak 未获授权的行政区划数据，此时不返回任何事件
其他	鉴权服务返回的说明	鉴权失败（如 ak 无效、未开通该服务）时，原样返回鉴权服务的状态码与说明，例如 240“APP 服务被禁用”

动态交通事件服务是高级服务，如需使用请提交工单联系我们。

行政区划动态事件检索

路线动态事件检索

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