道路路况查询

GET

/traffic/v1/road

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://api.map.baidu.com/traffic/v1/road?road_name=东二环&city=北京市&ak=&sn='

响应示例

{
	status: 0,
	message: "成功",
	description: "北五环:自东向西较为畅通;自西向东畅通;东向西,佳全教会附近拥堵。",
	evaluation: {
		status: 1,
		status_desc: "自东向西较为畅通;自西向东畅通"
	},
	road_traffic: [{
		congestion_sections: [{
			congestion_distance: 780,
			speed: 13.45,
			status: 3,
			congestion_trend: "加重",
			section_desc: "东向西,佳全教会附近"
		}],
	road_name: "北五环"
	}]
}

请求参数

Query 参数

road_name

string

必需

道路名称；如："北五环"、"信息路"。目前支持除多方向立交桥和多方向道路以外的各类道路名称（注：多方向是指道路方向多于2个方向，如：南向北、北向南、西向东、东向西，称为4方向）

示例值:

东二环

city

string

必需

所在城市；支持 1. 全国城市名称，如："北京市"、"上海市"等 2. 百度地图行政区划adcode，仅支持城市级别（adcode映射表），如"110000"

示例值:

北京市

string

必需

开发者的访问密钥，必填项。v2之前该属性为key。申请秘钥

默认值:

string

可选

可选，若开发者所用AK的校验方式为SN校验时该参数必须。

默认值:

返回响应

🟢200成功

application/json

Body

status

integer

必需

状态码;本次API访问状态，如果成功返回0，如果失败返回其他数字。

message

string

必需

响应信息;对status的中文描述

description

string

必需

路况语义化描述;如："东四北大街：双向行驶缓慢；南向北，北新桥地铁站附近严重拥堵。"

evaluation

object

路况整体评估

必需

status

integer

必需

路况整体评价;道路的整体拥堵评价，较status更为细致，分为：畅通、较为畅通、缓行、轻微拥堵、拥堵、严重拥堵

status_desc

string

必需

路况整体评价的语义化描述;如："双向拥堵"或"东向西拥堵，西向东畅通"等。
注意：路况整体评价关注的是道路整体拥堵情况，对于距离较长如：高速路、城市环路、复杂立交桥等，由于道路距离过长路况差异较大，整体拥堵评价可能与用户在具体路段的感知存在差异。此外，目前尚不支持对复杂多方向道路如立交桥、复杂道路等进行详细的分方向播报

road_traffic

array [object {2}]

路况详细信息

必需

congestion_sections

array [object {5}]

可选

拥堵路段详情; 若道路上有拥堵路段，则返回该字段。
若无拥堵路段，则不返回该字段
注意：拥堵路段是依据拥堵情况、车流量、拥堵距离等因素综合计算得到，并不完全参考拥堵情况

road_name

string

可选

道路名称;如："信息路"、"北五环"

修改于 2022-08-22 02:55:54

更新日志

矩形区域路况查询