AI 地图
产品服务
解决方案
文档与支持
定价
更新时间: 2026/05/09 15:45
道路实时路况查询
下载开发文档
接口说明

根据道路名称和城市查询指定道路的实时路况信息。返回该道路的整体通行状态评估、语义化路况描述、拥堵路段详情(包括拥堵距离、平均车速、拥堵趋势等)以及link级别的细粒度路况数据。支持全国城市范围内除多方向立交桥和多方向道路以外的各类道路查询,适用于按道路名称精确获取路况的场景。

API服务地址

https://api.map.baidu.com/traffic/v1/road?road_name=东二环&city=北京市&ak=您的AK
//GET请求

请求参数
参数名称参数含义类型必填备注

ak

用户的AK,授权使用

string

开发者访问密钥

road_name

道路名称

string

如:"北五环"、"信息路"。

目前支持除多方向立交桥和多方向道路以外的各类道路名称(注:多方向是指道路方向多于2个方向,如:南向北、北向南、西向东、东向西,称为4方向)

city

城市名称

string

支持

1. 全国城市名称,如:"北京市"、"上海市"等

2. 百度地图行政区划adcode,仅支持城市级别(adcode映射表),如"110000"

sn

若用户所用AK的校验方式为SN校验时该参数必须。SN计算规则

string

coord_type_output

返回结果的坐标类型

string

可选值:gcj02(国测局坐标)、bd09ll(百度经纬度坐标)。默认为bd09ll

返回参数
参数名称参数含义类型备注

status

状态码

int

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

message

响应信息

string

对status的中文描述

description

路况语义化描述

string

如:'东四北大街:双向行驶缓慢;南向北,北新桥地铁站附近严重拥堵。'

evaluation

路况整体评估

status

路况整体评价

int

支持以下值:

0:未知路况

1:畅通

2:缓行

3:拥堵

4:严重拥堵

status_desc

路况整体评价的语义化描述

string

如:"双向拥堵"或"东向西拥堵,西向东畅通"等。

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

road_traffic

路况详细信息

array

road_name

道路名称

string

如:’信息路‘、’北五环‘

congestion_sections

拥堵路段详情

array

若道路上有拥堵路段,则返回该字段。

若无拥堵路段,则不返回该字段

注意:拥堵路段是依据拥堵情况、车流量、拥堵距离等因素综合计算得到,并不完全参考拥堵情况

road_type

道路类型

int

路段类型标识,示例值:2。

section_desc

路段拥堵语义化描述

string

如:南向北,北新桥地铁站附近严重拥堵

status

路段拥堵评价

int

支持以下值:

0:未知路况

1:畅通

2:缓行

3:拥堵

4:严重拥堵

speed

平均通行速度

double

当前路段的平均通行速度

单位:千米/小时

congestion_distance

拥堵距离

int

单位:米

congestion_trend

较10分钟前拥堵趋势

string

相较10分钟前拥堵变化情况,支持以下值:

持平:与10分钟前变化不大

缓解:较10分钟前拥堵有所缓解

加重:较10分钟前拥堵加重

以下为高级权限,可联系商务咨询

traffic_detail

路段级路况详情

array

道路下每个link的细粒度路况信息。

status

路段拥堵状态

int

支持:1畅通,2缓行,3拥堵,4严重拥堵。

link_id

路段link唯一标识ID

int

可用于与link级别路况接口或内部link数据进行关联。

path

路段坐标串

string

格式:"经度,纬度;经度,纬度"。坐标类型由coord_type_output决定(gcj02或bd09ll)。

speed

路段平均通行速度

double

单位:千米/小时,对应当前link的实时速度。

上一篇

使用准备

下一篇

矩形区域实时路况查询
本篇文章对您是否有帮助?