开发 Web服务 API 开发指南 高级 API 文档 交通态势查询

交通态势查询 最后更新时间: 2024年07月18日

产品介绍

交通态势查询 API 是一套以 HTTP 形式提供的接口,用于查询指定线路、圆形区域、矩形区域内的交通态势情况,可以根据用户输入的内容返回希望查询的交通态势情况。

提示

交通态势查询接口属于高级服务接口,如需申请,可进行 商务咨询

适用场景

该服务适用于实时交通信息查询、交通数据分析以及智能交通系统等场景。

使用说明

1
第一步
申请 【Web服务API】密钥(Key)
2
第二步
拼接 HTTP 请求 URL,第一步申请的 Key 需作为必填参数一同发送
3
第三步
接收 HTTP 请求返回的数据(JSON 或 XML 格式),解析数据
如无特殊声明,接口的输入参数和输出数据编码全部统一为 UTF-8
成为开发者并创建 Key 

为了正常调用 Web 服务 API ,请先注册成为高德开放平台开发者,并申请 Web 服务的 key ,点击具体操作

指定线路交通态势查询

指定线路交通态势查询 API 服务地址

URL

请求方式

https://restapi.amap.com/v3/traffic/status/road?parameters 

GET

parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

请求参数

名称

含义

规则说明

是否必填

缺省值

key

用户唯一标识 

用户在高德地图官网 申请 Web 服务 API 类型 Key

sig

签名

选择数字签名认证的付费用户必填,数字签名获取和使用方法

level 

道路等级 

指定道路等级,下面各值代表的含义:  1:高速(京藏高速)  2:城市快速路、国道(西三环、103 国道)  3:高速辅路(G6 辅路)  4:主要道路(长安街、三环辅路)  5:一般道路(彩和坊路)  6:无名道路  注:以上值是包含关系,如 5 除自身道路以外还包含 1,2,3,4 的道路 

name 

街道名 

道路名称

city

城市名

由于开发者可能对城市称呼和高德的称呼存在差异(例如开发者称呼为深圳,但高德仅识别深圳市)。  故强烈建议使用 adcode,不使用 city 字段 

city 和 adcode 必填一个

adcode

城市编码 

由于开发者可能对城市称呼和高德的称呼存在差异(例如开发者称呼为深圳,但高德仅识别深圳市)。  故强烈建议使用 adcode,不使用 city 字段 

adcode 信息可参考 城市编码表 获取

city 和 adcode 必填一个

output 

返回数据格式类型 

可选:JSON、XML

JSON

extensions

控制返回内容

可选:base,all

base:返回基本信息

all:返回基本+详细信息

base 

服务示例

https://restapi.amap.com/v3/traffic/status/road?name=北环大道&adcode=440300&key=<用户的key>

参数

备注

必选

level

指定道路等级,下面各值代表的含义:
1:高速(京藏高速)
2:城市快速路、国道(西三环、103 国道)
3:高速辅路(G6 辅路)
4:主要道路(长安街、三环辅路)
5:一般道路(彩和坊路)
6:无名道路
注:以上值是包含关系,如 5 除自身道路以外还包含 1,2,3,4 的道路

name

道路名称

city

由于开发者可能对城市称呼和高德的称呼存在差异(例如开发者称呼为深圳,但高德仅识别深圳市)。
故强烈建议使用 adcode,不使用 city 字段 

city 和 adcode 必填一个

adcode

由于开发者可能对城市称呼和高德的称呼存在差异(例如开发者称呼为深圳,但高德仅识别深圳市)。
故强烈建议使用 adcode,不使用 city 字段 
adcode信息可参考城市编码表获取

city 和 adcode 必填一个

返回结果参数说明

关键字搜索的响应结果的格式由请求参数 output 指定。

名称

含义

说明

extensions 何值时值显示

status

返回结果状态值

值为 0 或 1,0表示失败;1表示成功

base/all

info 

返回状态说明

访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见 错误码说明

base/all 

infocode

返回状态说明

返回状态说明,10000 代表正确,详情参阅 info 状态表

base/all 

trafficinfo

交通态势信息

base/all  

description

路况综述

base/all  

evaluation

路况评价

base/all  

expedite

畅通所占百分比

base/all  

congested

缓行所占百分比

base/all

blocked

拥堵所占百分比

base/all

unknown

未知路段所占百分比

base/all

status

路况

0:未知;1:畅通;2:缓行;3:拥堵

base/all

description

道路描述

base/all  

roads

此为road列表,其中包含道路信息

all

name

道路名称

all

status

路况

0:未知;1:畅通;2:缓行;3:拥堵

all 

direction

方向描述

all 

angle

车行角度,判断道路正反向使用。

以正东方向为 0 度,顺时针方向为正,取值范围:[0,360]

all 

lcodes

负值表示反方向

all 

speed

平均速度

单位:km/hr,四舍五入取整

all 

polyline

道路坐标集,坐标集合

经度和纬度使用","分隔,坐标之间使用";"分隔。例如:x1,y1;x2,y2

all 

圆形区域内交通态势查询

圆形区域内交通态势查询 API 服务地址

URL

请求方式

https://restapi.amap.com/v3/traffic/status/circle?parameters

GET

parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

请求参数

名称

含义

规则说明

是否必填

缺省值

key

用户唯一标识 

用户在高德地图官网 申请 Web 服务 API 类型 Key

sig

签名

选择数字签名认证的付费用户必填,数字签名获取和使用方法

level 

道路等级 

指定道路等级,下面各值代表的含义:  1:高速(京藏高速)  2:城市快速路、国道(西三环、103 国道)  3:高速辅路(G6 辅路)  4:主要道路(长安街、三环辅路)  5:一般道路(彩和坊路)  6:无名道路  注:以上值是包含关系,如 5 除自身道路以外还包含 1,2,3,4 的道路 

location 

中心点坐标 

经度在前,纬度在后。经度和纬度用","分割。经纬度小数点后不得超过6位。 

radius

半径

单位:米,最大取值 5000 米。 

1000

output 

返回数据格式类型 

可选:JSON、XML

JSON

extensions

控制返回内容

可选:base,all

base:返回基本信息

all:返回基本+详细信息

否 

base 

服务示例

https://restapi.amap.com/v3/traffic/status/circle?location=116.3057764,39.98641364&radius=1500&output=xml&extensions=all&key=<用户的key>

参数

备注

必选

level

指定道路等级,下面各值代表的含义:
1:高速(京藏高速)
2:城市快速路、国道(西三环、103 国道)
3:高速辅路(G6 辅路)
4:主要道路(长安街、三环辅路)
5:一般道路(彩和坊路)
6:无名道路
注:以上值是包含关系,如 5 除自身道路以外还包含 1,2,3,4 的道路

location

中心点坐标,经度在前,纬度在后。经度和纬度用","分割。经纬度小数点后不得超过6位

返回结果参数说明

关键字搜索的响应结果的格式由请求参数 output 指定。

名称

含义

说明

extensions何值时值显示

status

返回结果状态值

值为 0 或 1,0 表示失败;1 表示成功

base/all

info 

返回状态说明

访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见 错误码说明

base/all 

infocode

返回状态说明

返回状态说明,10000 代表正确,详情参阅 info 状态表

base/all 

trafficinfo

交通态势信息

base/all  

description

路况综述

base/all  

evaluation

路况评价

base/all  

expedite

畅通所占百分比

base/all  

congested

缓行所占百分比

base/all

blocked

拥堵所占百分比

base/all

unknown

未知路段所占百分比

base/all

status

路况

0:未知;1:畅通;2:缓行;3:拥堵

base/all

description

道路描述

base/all  

roads

此为 road 列表,其中包含道路信息

all

name

道路名称

all

status

路况

0:未知;1:畅通;2:缓行;3:拥堵

all 

direction

方向描述

all 

angle

车行角度,判断道路正反向使用。

以正东方向为 0 度,顺时针方向为正,取值范围:[0,360]

all 

lcodes

负值表示反方向

all 

speed

平均速度

单位:km/hr,四舍五入取整

all 

polyline

道路坐标集,坐标集合

经度和纬度使用","分隔,坐标之间使用";"分隔。例如:x1,y1;x2,y2

all 

矩形区域内交通态势查询

矩形区域内交通态势查询 API 服务地址

URL

请求方式

https://restapi.amap.com/v3/traffic/status/rectangle?parameters 

GET

parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

请求参数

名称

含义

规则说明

是否必填

缺省值

key

用户唯一标识 

用户在高德地图官网 申请 Web 服务 API 类型 Key

sig

签名

选择数字签名认证的付费用户必填,数字签名获取和使用方法

level 

道路等级 

指定道路等级,下面各值代表的含义:  1:高速(京藏高速)  2:城市快速路、国道(西三环、103 国道)  3:高速辅路(G6 辅路)  4:主要道路(长安街、三环辅路)  5:一般道路(彩和坊路)  6:无名道路  注:以上值是包含关系,如5除自身道路以外还包含 1,2,3,4 的道路 

rectangle 

希望查询矩形坐标

左下右上顶点坐标对。矩形对角线不能超过 10 公里两个坐标对之间用”;”间隔。  xy 之间用”,”间隔最后格式为 x1,y1;x2,y2

output 

可选:JSON、XML

JSON

extensions

控制返回内容

可选:base,all

base:返回基本信息

all:返回基本+详细信息

否 

base 

服务示例

https://restapi.amap.com/v3/traffic/status/rectangle?rectangle=116.351147,39.966309;116.357134,39.968727&output=xml&extensions=all&key=<用户的key>

参数

备注

必选

level

指定道路等级,下面各值代表的含义:
1:高速(京藏高速)
2:城市快速路、国道(西三环、103 国道) 3:高速辅路(G6 辅路)
4:主要道路(长安街、三环辅路)
5:一般道路(彩和坊路)
6:无名道路
注:以上值是包含关系,如 5 除自身道路以外还包含 1,2,3,4 的道路

rectangle

希望查询矩形坐标,左下右上顶点坐标对。矩形对角线不能超过 10 公里两个坐标对之间用”;”间隔。 xy 之间用”,”间隔最后格式为 x1,y1;x2,y2

返回结果参数说明

关键字搜索的响应结果的格式由请求参数 output 指定。

名称

含义

说明

extensions何值时值显示

status

返回结果状态值

值为 0 或 1,0 表示失败;1 表示成功

base/all

info 

返回状态说明

访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见 错误码说明

base/all 

infocode

返回状态说明

返回状态说明,10000 代表正确,详情参阅 info 状态表

base/all 

trafficinfo

交通态势信息

base/all  

description

路况综述

base/all  

evaluation

路况评价

base/all  

expedite

畅通所占百分比

base/all  

congested

缓行所占百分比

base/all

blocked

拥堵所占百分比

base/all

unknown

未知路段所占百分比

base/all

status

路况

0:未知;1:畅通;2:缓行;3:拥堵

base/all

description

道路描述

base/all  

roads

此为 road 列表,其中包含道路信息

all

name

道路名称

all

status

路况

0:未知;1:畅通;2:缓行;3:拥堵

all 

direction

方向描述

all 

angle

车行角度,判断道路正反向使用。

以正东方向为 0 度,顺时针方向为正,取值范围:[0,360]

all 

lcodes

负值表示反方向

all 

speed

平均速度

单位:km/hr,四舍五入取整

all 

polyline

道路坐标集,坐标集合

经度和纬度使用","分隔,坐标之间使用";"分隔。例如:x1,y1;x2,y2

all 

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