ak

用户的AK，授权使用

string

是

开发者访问密钥

road_name

道路名称

string

是

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

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

city

城市名称

string

是

支持

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

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

sn

否

无

否

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

status

状态码

int

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

message

响应信息

string

对status的中文描述

description

路况语义化描述

string

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

evaluation

路况整体评估

路况整体评价

int

支持以下值：

0：未知路况

1：畅通

2：缓行

3：拥堵

4：严重拥堵

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

string

如："双向拥堵"或"东向西拥堵，西向东畅通"等。

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

road_traffic

路况详细信息

array

道路名称

string

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

拥堵路段详情

array

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

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

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

section_desc

路段拥堵语义化描述

string

如：南向北，北新桥地铁站附近严重拥堵

status

路段拥堵评价

int

支持以下值：

0：未知路况

1：畅通

2：缓行

3：拥堵

4：严重拥堵

speed

平均通行速度

double

当前路段的平均通行速度

单位：千米/小时

congestion_distance

拥堵距离

int

单位：米

congestion_trend

较10分钟前拥堵趋势

string

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

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

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

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