浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
服务介绍
服务文档
使用指南
更新日志
实时路况查询服务
实时路况查询服务(又名Traffic API)是一类Web API接口服务,开发者可利用该服务查询指定道路或区域的实时拥堵情况和拥堵趋势,可应用于智能音箱、智能车载设备、交通出行类应用中,实现诸如:"信息路堵不堵?"、"五道口堵不堵?"这类用户询问路况场景

注:实时路况查询API于2018年8月31日上线,在此之前注册的AK默认无使用权限。若在此之前注册的AK需使用该服务,请进入API控制台为AK勾选“实时路况查询API”即可正常使用。
产品优势
1. 路况分钟级更新(更新频率1分钟),确保用户获得的是最新的实时路况

2. 既支持对路况进行整体评价,也支持对具体拥堵路段的详细评价,使得用户在了解道路整体拥堵情况同时,也清晰了解具体拥堵路段的位置和拥堵程度

3. 描述路段拥堵趋势(较10分钟前拥堵加重、持平或缓解),辅助用户判断接下来一段时间的拥堵情况

4. 路网覆盖率高,支持全部百度地图道路路况
功能介绍
道路实时路况查询
查询具体道路的实时拥堵评价和拥堵路段、拥堵距离、拥堵趋势等信息

traffic%2F%E7%A4%BA%E6%84%8F%E5%9B%BE.png

矩形区域实时路况查询
查询指定矩形地理范围的实时拥堵情况和各拥堵路段信息

bound.png

多边形区域实时路况查询
查询指定多边形地理范围的实时拥堵情况和各拥堵路段信息

polygon.png

周边实时路况查询
查询某中心点周边半径范围内的实时拥堵情况和各拥堵路段信息

around.png

接口功能介绍
道路路况查询
http://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 道路的整体拥堵评价,较status更为细致,分为:畅通、较为畅通、缓行、轻微拥堵、拥堵、严重拥堵
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: "北五环"
	}]
}


矩形区域路况查询
http://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计算规则
返回结果参数
多边形区域路况查询
http://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计算规则
返回结果参数
周边路况查询
http://api.map.baidu.com/traffic/v1/around?ak=你的AK&center=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": "SAME", 
                    "section_desc": "北向南,从开拓路5到京新高速", 
                    "congection_trend": null
                }
            ], 
            "road_name": "京包高速"
        }, 
        {
            "congestion_sections": [
                {
                    "congestion_distance": 1610, 
                    "speed": 7.79, 
                    "status": 3, 
                    "congestion_trend": "SAME", 
                    "section_desc": "北向南,京新上地桥", 
                    "congection_trend": null
                }
            ], 
            "road_name": "京新上地桥"
        }, 
        {
            "congestion_sections": [
                {
                    "congestion_distance": 1870, 
                    "speed": 8.45, 
                    "status": 3, 
                    "congestion_trend": "SAME", 
                    "section_desc": "北向南,从京包高速到耳通百安", 
                    "congection_trend": null
                }
            ], 
            "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": "WORSE", 
                    "section_desc": "西向东,上地三街附近", 
                    "congection_trend": null
                }
            ], 
            "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

产品发布
发布实时路况查询服务V1.0,支持"道路实时路况查询",可根据道路名称查询道路实时拥堵评价和拥堵趋势。
产品发布
发布实时路况查询服务V1.1,新增矩形、多边形、周边区域路况查询API,支持查询一定范围内的整体路况评价和拥堵路段信息。
  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消