注：实时路况查询API于2018年8月31日上线，在此之前注册的AK默认无使用权限。若在此之前注册的AK需使用该服务，请进入API控制台为AK勾选“实时路况查询API”即可正常使用。
2. 既支持对路况进行整体评价，也支持对具体拥堵路段的详细评价，使得用户在了解道路整体拥堵情况同时，也清晰了解具体拥堵路段的位置和拥堵程度
3. 描述路段拥堵趋势（较10分钟前拥堵加重、持平或缓解），辅助用户判断接下来一段时间的拥堵情况
4. 路网覆盖率高，支持全部百度地图道路路况
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计算规则 |
| 参数名称 | 参数含义 | 类型 | 备注 | |||
|---|---|---|---|---|---|---|
| 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 | 若道路上有拥堵路段，则返回该字段。 若无拥堵路段，则不返回该字段 注意：拥堵路段是依据拥堵情况、车流量、拥堵距离等因素综合计算得到，并不完全参考拥堵情况 | |||
| |
section_desc |
路段拥堵语义化描述 | string | 如：南向北，北新桥地铁站附近严重拥堵 | ||
| status | 路段拥堵评价 | int | 支持以下值： 0：未知路况 1：畅通 2：缓行 3：拥堵 4：严重拥堵 | |||
| speed | 平均通行速度 | double | 当前路段的平均通行速度 单位：千米/小时 | |||
| congestion_distance | 拥堵距离 | int | 单位：米 | |||
| congestion_trend |
较10分钟前拥堵趋势 |
string |
相较10分钟前拥堵变化情况，支持以下值： 持平：与10分钟前变化不大 缓解：较10分钟前拥堵有所缓解 加重：较10分钟前拥堵加重 | |||
{
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: "北五环"
}]
}
https://api.map.baidu.com/traffic/v1/bound?ak=你的AK&bounds=39.912078,116.464303;39.918276,116.475442&coord_type_input=gcj02&coord_type_output=gcj02//GET请求
| 参数名称 | 参数含义 | 类型 | 是否必填 | 备注 |
|---|---|---|---|---|
| ak | 用户的AK，授权使用 |
string |
是 | 开发者访问密钥 |
| bounds | 矩形区域, 左下角和右上角的经纬度坐标点 | string | 是 | 坐标点顺序为"左下;右上"，坐标对间使用;号分隔，格式为：纬度,经度;纬度,经度。对角线距离不超过2公里。
示例： 39.912078,116.464303;39.918276,116.475442 |
| road_grade | 道路等级 | int | 否 | 用户可进行道路等级筛选，支持选择多个道路等级。道路等级之间使用英文“,”分隔。
默认值：road_grade=0 道路等级对应表如下： 0：全部驾车道路 1：高速路 2：环路及快速路 3：主干路 4：次干路 5：支干路 示例： 查询全部驾车道路路况：road_grade:0 查询高速道路路况：road_grade:1 查询高速路、环路及快速路、主干路的路况：road_grade=1,2,3 |
| coord_type_input | 请求参数 bounds的坐标类型 | string |
否 | 默认值：bd09ll
取值范围： bd09ll：百度经纬度坐标 gcj02：国测局加密坐标 wgs84：gps 坐标 |
| coord_type_output | 返回结果的坐标类型 | string |
否 | 默认值：bd09ll
该字段用于控制返回结果中坐标的类型。可选值为： bd09ll：百度经纬度坐标 gcj02：国测局加密坐标 |
| sn | 否 | 无 | 否 | 若用户所用AK的校验方式为SN校验时该参数必须。SN计算规则 |
https://api.map.baidu.com/traffic/v1/polygon?ak=你的AK&vertexes=39.910528,116.472926;39.918276,116.475442;39.916671,116.459056;39.912078,116.464303&coord_type_input=gcj02&coord_type_output=gcj02//GET请求
| 参数名称 | 参数含义 | 类型 | 是否必填 | 备注 |
|---|---|---|---|---|
| ak | 用户的AK，授权使用 |
string |
是 | 开发者访问密钥 |
| vertexes | 多边形边界点 | string | 是 | 多边形顶点，规则： 经纬度顺序为：纬度,经度； 顶点顺序需按逆时针排列。
多边形外接矩形对角线距离不超过2公里。 示例： vertexes=39.910528,116.472926;39.918276,116.475442;39.916671,116.459056;39.912078,116.464303 |
| road_grade | 道路等级 | int | 否 | 用户可进行道路等级筛选，支持选择多个道路等级。道路等级之间使用英文“,”分隔。
默认值：road_grade=0 道路等级对应表如下： 0：全部驾车道路 1：高速路 2：环路及快速路 3：主干路 4：次干路 5：支干路 示例： 查询全部驾车道路路况：road_grade:0 查询高速道路路况：road_grade:1 查询高速路、环路及快速路、主干路的路况：road_grade=1,2,3 |
| coord_type_input | 请求参数 bounds的坐标类型 | string |
否 | 默认值：bd09ll
取值范围： bd09ll：百度经纬度坐标 gcj02：国测局加密坐标 wgs84：gps 坐标 |
| coord_type_output | 返回结果的坐标类型 | string |
否 | 默认值：bd09ll
该字段用于控制返回结果中坐标的类型。可选值为： bd09ll：百度经纬度坐标 gcj02：国测局加密坐标 |
| sn | 否 | 无 | 否 | 若用户所用AK的校验方式为SN校验时该参数必须。SN计算规则 |
https://api.map.baidu.com/traffic/v1/around?ak=你的AK¢er=39.912078,116.464303&radius=200&coord_type_input=gcj02&coord_type_output=gcj02//GET请求
| 参数名称 | 参数含义 | 类型 | 是否必填 | 备注 |
|---|---|---|---|---|
| ak | 用户的AK，授权使用 |
string |
是 | 开发者访问密钥 |
| center | 中心点坐标 | string | 是 | 示例：center=39.912078,116.464303 |
| radius | 查询半径 | int | 是 | 单位：米，取值范围[1,1000]
示例： radius=200 |
| road_grade | 道路等级 | int | 否 | 用户可进行道路等级筛选，支持选择多个道路等级。道路等级之间使用英文“,”分隔。
默认值：road_grade=0 道路等级对应表如下： 0：全部驾车道路 1：高速路 2：环路及快速路 3：主干路 4：次干路 5：支干路 示例： 查询全部驾车道路路况：road_grade:0 查询高速道路路况：road_grade:1 查询高速路、环路及快速路、主干路的路况：road_grade=1,2,3 |
| coord_type_input | 请求参数 bounds的坐标类型 | string |
否 | 默认值：bd09ll
取值范围： bd09ll：百度经纬度坐标 gcj02：国测局加密坐标 wgs84：gps 坐标 |
| coord_type_output | 返回结果的坐标类型 | string |
否 | 默认值：bd09ll
该字段用于控制返回结果中坐标的类型。可选值为： bd09ll：百度经纬度坐标 gcj02：国测局加密坐标 |
| sn | 否 | 无 | 否 | 若用户所用AK的校验方式为SN校验时该参数必须。SN计算规则 |
| 参数名称 | 参数含义 | 类型 | 备注 | |||
|---|---|---|---|---|---|---|
| status | 状态码 | int | 本次API访问状态，如果成功返回0，如果失败返回其他数字。 | |||
| message | 响应信息 | string | 对status的中文描述 | |||
| description | 路况语义化描述 | string | 组成规则：整体拥堵情况概述+拥堵路段。示例："该区域整体拥堵。京包高速：北向南,从开拓路5到京新高速拥堵。京新上地桥：北向南,京新上地桥拥堵。京新高速：北向南,从京包高速到耳通百安拥堵。小营西路：西向东,上地三街附近拥堵。" | |||
| evaluation | 路况整体评估 | |
| |||
| |
status | 路况整体评价 | int | 支持以下值： 0：未知路况 1：畅通 2：缓行 3：拥堵 4：严重拥堵 | ||
| status_desc | 路况整体评价的语义化描述 | string | 道路的整体拥堵评价，较status更为细致，分为：畅通、较为畅通、缓行、轻微拥堵、拥堵、严重拥堵 | |||
| road_traffic | 路况详细信息 | array | | |||
| |
road_name |
道路名称 | string | 如："信息路"、"北五环" | ||
| congestion_sections |
拥堵路段详情 | array | 若道路上有拥堵路段，则返回该字段。 若无拥堵路段，则不返回该字段 注意：拥堵路段是依据拥堵情况、车流量、拥堵距离等因素综合计算得到，并不完全参考拥堵情况 | |||
| |
section_desc |
路段拥堵语义化描述 | string | 如：南向北，北新桥地铁站附近严重拥堵 | ||
| status | 路段拥堵评价 | int | 支持以下值： 0：未知路况 1：畅通 2：缓行 3：拥堵 4：严重拥堵 | |||
| speed | 平均通行速度 | double | 当前路段的平均通行速度 单位：千米/小时 | |||
| congestion_distance | 拥堵距离 | int | 单位：米 | |||
| congestion_trend |
较10分钟前拥堵趋势 |
string |
相较10分钟前拥堵变化情况，支持以下值： 持平：与10分钟前变化不大 缓解：较10分钟前拥堵有所缓解 加重：较10分钟前拥堵加重 | |||
{
"status": 0,
"message": "成功",
"description": "该区域整体拥堵。京包高速：北向南,从开拓路5到京新高速拥堵。京新上地桥：北向南,京新上地桥拥堵。京新高速：北向南,从京包高速到耳通百安拥堵。小营西路：西向东,上地三街附近拥堵。",
"evaluation": {
"status": 3,
"status_desc": "拥堵"
},
"road_traffic": [
{
"road_name": "UNKNOW"
},
{
"road_name": "上地三街"
},
{
"road_name": "上地三街辅路"
},
{
"road_name": "上地东路"
},
{
"road_name": "上地五街"
},
{
"road_name": "上地六街"
},
{
"road_name": "上地四街"
},
{
"congestion_sections": [
{
"congestion_distance": 1870,
"speed": 8.45,
"status": 3,
"congestion_trend": "持平",
"section_desc": "北向南,从开拓路5到京新高速",
}
],
"road_name": "京包高速"
},
{
"congestion_sections": [
{
"congestion_distance": 1610,
"speed": 7.79,
"status": 3,
"congestion_trend": "持平",
"section_desc": "北向南,京新上地桥",
}
],
"road_name": "京新上地桥"
},
{
"congestion_sections": [
{
"congestion_distance": 1870,
"speed": 8.45,
"status": 3,
"congestion_trend": "持平",
"section_desc": "北向南,从京包高速到耳通百安",
}
],
"road_name": "京新高速"
},
{
"road_name": "信息路"
},
{
"road_name": "创业路"
},
{
"road_name": "安宁庄西一条"
},
{
"road_name": "安宁庄西三条"
},
{
"road_name": "安宁庄西二条"
},
{
"road_name": "安宁庄路"
},
{
"congestion_sections": [
{
"congestion_distance": 760,
"speed": 6.39,
"status": 3,
"congestion_trend": "加重",
"section_desc": "西向东,上地三街附近",
}
],
"road_name": "小营西路"
},
{
"road_name": "小营西路辅路"
},
{
"road_name": "开拓路"
}
]
}
API请求中需要用到中文或一些特殊字符的参数，如query、region等，为了避免提交到后台乱码，需要对这几个参数值进行编码处理，转换成UTF-8字符的二字符十六进制值，凡是不在下表中的字符都需要进行编码。
| 字符集合 | 字符 |
| URL非保留字 |
a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~ |
| URL保留字 |
! * ' ( ) ; : @ & = + $ , / ? % # [ ] |
如果中文参数中使用URL保留字字符的字面意思，例如：region关键字取值为"?北京"，检索关键字包含一个问号，此问号也必须进行编码。
附注：
javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
php中可以使用函数urlencode对特殊字符进行编码。
WGS84：为一种大地坐标系，也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
GCJ02：是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
BD09：为百度坐标系，在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托米制坐标。
地点输入提示服务默认输入输出坐标类型为百度坐标（bd09ll），同时可通过参数（"coord_type","ret_coordtype"）控制输入输出坐标类型。输入坐标支持以上三种坐标系，输出坐标支持-国测局坐标（GCJ02）和百度坐标（BD09）。
注意：不同类型坐标如需转换，请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法，以免影响坐标转换精度。
服务相关配额及并发请求限制请访问开发者权益页面查看。
2018年8月31日
V1.0
2019年3月28日
V1.1