交通态势 最后更新时间: 2021年08月11日
产品介绍
说明:交通态势接口计划于2020年12月31日下线,目前不再对新用户开放。如需合作请通过工单进行商务咨询。
交通态势是一类简单的HTTP接口,提供根据用户输入的内容能够返回希望查询的交通态势情况。
目前支持城市:北京,上海,广州,深圳,宁波,武汉,重庆,成都,沈阳,南京,杭州,长春,常州,大连,东莞,福州,青岛,石家庄,天津,太原,西安,无锡,厦门,珠海,长沙,苏州,金华,佛山,济南,泉州,嘉兴,西宁,惠州,温州,中山,合肥,乌鲁木齐,台州,绍兴,昆明。
使用API前您需先申请Key,若无高德地图API账号需要先申请账号。
适用场景
希望能够确定矩形、圆形或某条道路的交通态势情况,路况信息2分钟更新一次。
使用限制
服务调用量的限制请点击这里查阅。
使用说明
第一步,申请”Web服务API接口”密钥(Key);
第二步,拼接HTTP请求URL,第一步申请的Key需作为必填参数一同发送;
第三步,接收HTTP请求返回的数据(JSON或XML格式),解析数据。
如无特殊声明,接口的输入参数和输出数据编码全部统一为UTF-8。
矩形区域交通态势
矩形区域交通态势查询服务地址:
URL | http://restapi.amap.com/v3/traffic/status/rectangle?parameters |
请求方式 | GET |
parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。
- 请求参数
参数名 | 含义 | 规则说明 | 是否必填 | 缺省值 |
---|---|---|---|---|
key | 请求服务权限标识 | 用户在高德地图官网申请Web服务API类型KEY | 必填 | 无 |
level | 道路等级 | 指定道路等级,下面各值代表的含义: 1:高速(京藏高速) 2:城市快速路、国道(西三环、103国道) 3:高速辅路(G6辅路) 4:主要道路(长安街、三环辅路路) 5:一般道路(彩和坊路) 6:无名道路
| 可选 | 5 |
extensions | 返回结果控制 | 可选值:base,all | 可选 | base |
sig | 数字签名 | 数字签名认证用户必填 | 可选 | 无 |
output | 返回数据格式类型 | 可选值:JSON,XML | 可选 | JSON |
callback | 回调函数 | callback值是用户定义的函数名称,此参数只在output=JSON时有效 | 可选 | 无 |
rectangle | 代表此为矩形区域查询 | 左下右上顶点坐标对。矩形对角线不能超过10公里 两个坐标对之间用”;”间隔 xy之间用”,”间隔 最后格式为 | 必填 | 无 |
- 返回结果参数说明
输入提示的响应结果的格式由请求参数output指定。
名称 | 含义 | 规则说明 | ||
---|---|---|---|---|
status | 结果状态值,值为0或1 | 0:请求失败;1:请求成功 | ||
info | 请求状态 | OK代表成功 | ||
infocode | 请求状态编码 | 10000代表成功,其余请参见错误编码 | ||
trafficinfo | 交通态势信息 | |||
description | 路况综述 | |||
evaluation | 路况评价 | |||
expedite | 畅通所占百分比 | |||
congested | 缓行所占百分比 | |||
blocked | 拥堵所占百分比 | |||
unknown | 未知路段所占百分比 | |||
status | 路况 | 0:未知 1:畅通 2:缓行 3:拥堵 4:严重拥堵 | ||
description | 道路描述 | |||
roads | 此为road列表 其中包含道路信息 | 当extensions=all时返回 | ||
name | 道路名称 | |||
status | 路况 | 0:未知 1:畅通 2:缓行 3:拥堵 4:严重拥堵 | ||
direction | 方向描述 | |||
angle | 车行角度,判断道路正反向使用。 | 以正东方向为0度,逆时针方向为正, 取值范围:[0,360] | ||
speed | 速度 | 单位:千米/小时 | ||
lcodes | 即locationcode的集合,是道路中某一段的id,一条路包括多个locationcode。 | angle在[0-180]之间取正值,[181-359]之间取负值。 | ||
polyline | 道路坐标集,坐标集合 | 经度和纬度使用","分隔 坐标之间使用";"分隔。 例如:x1,y1;x2,y2 |
- 服务示例
http://restapi.amap.com/v3/traffic/status/rectangle?rectangle=116.351147,39.966309;116.357134,39.968727&key=<用户的key>
参数 | 值 | 备注 | 必选 |
---|---|---|---|
rectangle | 矩形的左下和右上点坐标 | 是 |
圆形区域交通态势
圆形区域交通态势查询服务地址:
URL | http://restapi.amap.com/v3/traffic/status/circle?parameters |
请求方式 | GET |
parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。
- 请求参数
参数名 | 含义 | 规则说明 | 是否必填 | 缺省值 |
---|---|---|---|---|
key | 请求服务权限标识 | 用户在高德地图官网申请Web服务API类型KEY | 必填 | 无 |
level | 道路等级 | 指定道路等级,下面各值代表的含义: 1:高速(京藏高速) 2:城市快速路、国道(西三环、103国道) 3:高速辅路(G6辅路) 4:主要道路(长安街、三环辅路路) 5:一般道路(彩和坊路) 6:无名道路 | 可选 | 5 |
extensions | 返回结果控制 | 可选值:base,all | 可选 | base |
sig | 数字签名 | 数字签名认证用户必填 | 可选 | 无 |
output | 返回数据格式类型 | 可选值:JSON,XML | 可选 | JSON |
callback | 回调函数 | callback值是用户定义的函数名称,此参数只在output=JSON时有效 | 可选 | 无 |
location | 中心点坐标 | 经度在前,纬度在后。经度和纬度用","分割。 经纬度小数点后不得超过6位。 | 必填 | 无 |
radius | 半径 | 单位:米,最大取值5000米。 | 可选 | 1000 |
- 返回结果参数说明
周边搜索搜索的响应结果的格式由请求参数output指定,返回结果见矩形区域交通态势
- 服务示例
http://restapi.amap.com/v3/traffic/status/circle?location=116.3057764,39.98641364&radius=1500&key=<用户的key>
参数 | 值 | 备注 | 必选 |
---|---|---|---|
location | 中心点坐标 | 是 | |
radius | 半径 | 否 |
指定线路交通态势
指定线路交通态势查询服务地址:
URL | http://restapi.amap.com/v3/traffic/status/road?parameters |
请求方式 | GET |
parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。
- 请求参数
参数名 | 含义 | 规则说明 | 是否必填 | 缺省值 |
---|---|---|---|---|
key | 请求服务权限标识 | 用户在高德地图官网申请Web服务API类型KEY | 必填 | 无 |
level | 道路等级 | 指定道路等级,下面各值代表的含义: 1:高速(京藏高速) 2:城市快速路、国道(西三环、103国道) 3:高速辅路(G6辅路) 4:主要道路(长安街、三环辅路路) 5:一般道路(彩和坊路) 6:无名道路 | 可选 | 5 |
extensions | 返回结果控制 | 可选值:base,all | 可选 | base |
sig | 数字签名 | 数字签名认证用户必填 | 可选 | 无 |
output | 返回数据格式类型 | 可选值:JSON,XML | 可选 | JSON |
callback | 回调函数 | callback值是用户定义的函数名称,此参数只在output=JSON时有效 | 可选 | 无 |
name | 道路名 | 必填 | 无 | |
city | 城市名 | 由于开发者可能对城市称呼和高德的称呼存在差异 (例如开发者称呼为深圳,但高德仅识别深圳市) 故强烈建议使用adcode,不使用city字段 另外此处的adcode仅识别市级的adcode | 非必填(city和adcode必填一个) | 无 |
adcode | 城市编码 | 由于开发者可能对城市称呼和高德的称呼存在差异 (例如开发者称呼为深圳,但高德仅识别深圳市) 故强烈建议使用adcode,不使用city字段 | 非必填(city和adcode必填一个) | 无 |
- 返回结果参数说明
周边搜索搜索的响应结果的格式由请求参数output指定,返回结果见矩形区域交通态势
- 服务示例
http://restapi.amap.com/v3/traffic/status/road?name=北环大道&adcode=440300&key=<用户的key>
参数 | 值 | 备注 | 必选 |
---|---|---|---|
name | 街道名称 | 是 | |
adcode | 城市的adcode | 否 |