产品介绍
交通态势查询 API 是一套以 HTTP 形式提供的接口，用于查询指定线路、圆形区域、矩形区域内的交通态势情况，可以根据用户输入的内容返回希望查询的交通态势情况。
提示交通态势查询接口属于高级服务接口，如需申请，可进行 商务咨询
适用场景
该服务适用于实时交通信息查询、交通数据分析以及智能交通系统等场景。
使用说明
拼接 HTTP 请求 URL，第一步申请的 Key 需作为必填参数一同发送
接收 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 |
