浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

WEB 服务API

百度地图Web服务API为开发者提供http/https接口,即开发者通过http/https形式发起检索请求,获取返回json或xml格式的检索数据。用户可以基于此开发JavaScript、C#、C++、Java等语言的地图应用。

服务介绍
服务文档
使用指南
更新日志
实时路况查询服务
实时路况查询服务(又名Traffic API)是一类Web API接口服务,开发者可利用该服务查询指定道路或区域的实时拥堵情况和拥堵趋势,可应用于智能音箱、智能车载设备、交通出行类应用中,实现诸如:"信息路堵不堵?"、"五道口堵不堵?"这类用户询问路况场景。
产品优势
1. 路况分钟级更新(更新频率1分钟),确保用户获得的是最新的实时路况

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

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

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

traffic%2F%E7%A4%BA%E6%84%8F%E5%9B%BE.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: "北五环"
	}]
}


使用方法
编码说明

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

产品发布
发布实时路况查询服务V1.0,支持"道路实时路况查询",可根据道路名称查询道路实时拥堵评价和拥堵趋势。