全部服务产品
开发者频道
服务升级
登录
道路路况查询
下载开发文档
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计算规则

返回参数
参数名称参数含义类型备注
status状态码int本次API访问状态,如果成功返回0,如果失败返回其他数字。
message响应信息string对status的中文描述
description路况语义化描述string如:'东四北大街:双向行驶缓慢;南向北,北新桥地铁站附近严重拥堵。'
evaluation路况整体评估
status路况整体评价 string支持以下值:
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分钟前拥堵加重
示例代码
填写您的AK

输入AK可生成包含IP/SN校验方式的代码

<?php
// 此处填写你在控制台-应用管理-创建应用后获取的AK
$ak = '您的AK';
// 发起一个http get请求,并返回请求的结果
// $url字段为请求的地址
// $param字段为请求的参数
function request_get($url = '', $param = array()) {
if (empty($url) || empty($param)) {
return false;
}
$getUrl = $url . "?" . http_build_query($param);
$curl = curl_init(); // 初始化curl
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); // 跳过证书检查
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2); // 从证书中检查SSL加密算法是否存在
curl_setopt($curl, CURLOPT_URL, $getUrl); // 抓取指定网页
curl_setopt($curl, CURLOPT_TIMEOUT, 1000); // 设置超时时间1秒
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); // curl不直接输出到屏幕
curl_setopt($curl, CURLOPT_HEADER, 0); // 设置header
$data = curl_exec($curl); // 运行curl
if (!$data) {
print("an error occured in function request_get(): " . curl_error($curl) . "\n");
}
curl_close($curl);
return $data;
}
// 请求地址
$url = 'https://api.map.baidu.com/traffic/v1/road';
// 构造请求参数
$param['road_name'] = '东二环';
$param['city'] = '北京市';
$param['ak'] = $ak;
$res = request_get($url, $param);
// 将原始返回的结果打印出来
print("请求的原始返回结果为:\n");
print($res . "\n");
?>
{
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: "北五环"
}]
}
在线运行
参数备注必选
road_name
东二环
city
北京市

上一篇

使用准备

下一篇

矩形区域实时路况查询

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