开发 Web服务 API 开发指南 基础 API 文档

交通态势 最后更新时间: 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


返回顶部 示例中心 常见问题 智能客服 公众号
二维码