交通态势查询 最后更新时间: 2025年08月22日
产品介绍
交通态势查询 API 是一套以 HTTP 形式提供的接口,用于查询指定线路、圆形区域、矩形区域内的交通态势情况,可以根据用户输入的内容返回希望查询的交通态势情况。
交通态势查询接口属于高级服务接口,如需申请,可进行商务咨询
适用场景
该服务适用于实时交通信息查询、交通数据分析以及智能交通系统等场景。
交通态势查询API支持的城市如下:杭州、西宁、南京、昆明、武汉、上海、珠海、沈阳、深圳、大连、宁波、西安、青岛、佛山、厦门、福州、合肥、长沙、温州、台州、常州、天津、东莞、成都、苏州、石家庄、长春、太原、济南、乌鲁木齐、绍兴、重庆、泉州、惠州、中山、无锡、广州、嘉兴、北京、金华。
使用说明
为了正常调用 Web 服务 API ,请先注册成为高德开放平台开发者,并申请 Web 服务的 key ,点击具体操作 。
指定线路交通态势查询
指定线路交通态势查询 API 服务地址
URL
请求方式
https://restapi.amap.com/v3/traffic/status/road?parameters
GET
请求参数
名称
含义
规则说明
是否必填
缺省值
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 |
|
指定道路等级,下面各值代表的含义: |
是 |
|
name |
|
道路名称 |
是 |
|
city |
|
由于开发者可能对城市称呼和高德的称呼存在差异(例如开发者称呼为深圳,但高德仅识别深圳市)。 |
city 和 adcode 必填一个 |
|
adcode |
|
由于开发者可能对城市称呼和高德的称呼存在差异(例如开发者称呼为深圳,但高德仅识别深圳市)。 |
city 和 adcode 必填一个 |
返回结果参数说明
关键字搜索的响应结果的格式由请求参数 output 指定。
名称
含义
说明
extensions 何值时值显示
status
返回结果状态值
值为 0 或 1,0表示失败;1表示成功
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
请求参数
名称
含义
规则说明
是否必填
缺省值
level
道路等级
指定道路等级,下面各值代表的含义: 1:高速(京藏高速) 2:城市快速路、国道(西三环、103 国道) 3:高速辅路(G6 辅路) 4:主要道路(长安街、三环辅路) 5:一般道路(彩和坊路) 6:无名道路 注:以上值是包含关系,如 5 除自身道路以外还包含 1,2,3,4 的道路
是
无
location
中心点坐标
经度在前,纬度在后。经度和纬度用","分割。经纬度小数点后不得超过6位。
是
无
radius
半径
单位:米,最大取值 4999。 取值不支持小数。
否
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 |
|
指定道路等级,下面各值代表的含义: |
是 |
|
location |
|
中心点坐标,经度在前,纬度在后。经度和纬度用","分割。经纬度小数点后不得超过6位 |
是 |
返回结果参数说明
关键字搜索的响应结果的格式由请求参数 output 指定。
名称
含义
说明
extensions何值时值显示
status
返回结果状态值
值为 0 或 1,0 表示失败;1 表示成功
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
请求参数
名称
含义
规则说明
是否必填
缺省值
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 |
|
指定道路等级,下面各值代表的含义: |
是 |
|
rectangle |
|
希望查询矩形坐标,左下右上顶点坐标对。矩形对角线不能超过 10 公里两个坐标对之间用";"间隔。 xy 之间用","间隔最后格式为 x1,y1;x2,y2 |
是 |
返回结果参数说明
关键字搜索的响应结果的格式由请求参数 output 指定。
名称
含义
说明
extensions何值时值显示
status
返回结果状态值
值为 0 或 1,0 表示失败;1 表示成功
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