导航|地址|刷新
交通态势查询-高级 API 文档-开发指南-Web服务 API | 高德地图AP…












控制台

去认证企业


登录注册









退出


我的消息

云图市场

应用管理

GeoHUB




产品介绍

产品介绍高德开放平台产品介绍 查看全部文档

搜索定位


鸿蒙星河版定位SDK HOT鸿蒙星河版定位SDK

搜索 HOT位置、周边、行政区、ID等查询接口 API JS Android iOS

定位 HOT基于LBS的定位服务 API Android iOS

地理/逆地理编码 位置名称与经纬度之间转换服务 API JS Android iOS

地理围栏 虚拟空间围栏服务 API Android iOS

天气查询 查询目标区域当前/未来天气

智能硬件定位 通过基站、Wifi获取位置信息




路线导航


鸿蒙星河版导航SDK NEW鸿蒙星河版导航SDK

导航 HOT轻松地在APP中加入导航能力 Android iOS

路线规划 HOT提供步行、驾车等规划能力 API JS Android iOS

猎鹰服务 提供专业轨迹管理服务 API Android iOS

货车路径规划 专业的货车路径规划服务 API Android iOS

智能调度引擎 智能外勤调度，提升效益

物流服务 提供智慧物流API服务接口

公交信息查询 查询公交信息

交通路况查询 查询交通态势情况

高级路径规划 高级路径规划等能力




地图产品


鸿蒙星河版地图SDK HOT鸿蒙星河版-轻量地图SDK

动态地图 HOT动态地图展示、配置 API JS Android iOS HarmonyOS

3D地图 HOT3D动态地图展示、配置

地铁图 简单易用的移动端地铁线路图开发接口 JS Android iOS

静态地图 灵活地将高德地图迁入应用网页

3D地形图 卫星地形图还原真实地形地貌




高级地图工具


世界地图 NEW

自定义地图

地图数据可视化 (LOCA)

地图数据中心 (GeoHUB)

坐标拾取器

高德地图URI Web

高德地图URI APP

三维模型转换

微信小程序插件

地图Flutter插件

地图名片




高德地图小程序


地图小程序

客户管理

员工管理

送货提效

地图小程序API




空间智能开放平台


空间智能开放平台 NEW用真实空间信息解答业务问题






解决方案

解决方案提供各行业LBS解决方案


空间智能 NEW提供LBS领域的Agent解决方案

智能手表 NEW提供智能守护与运动出行解决方案

智能眼镜 NEW智能眼镜实时导航及智慧出行解决方案

世界地图 NEW面向开发者提供全球范围内LBS服务

智能两轮车 NEW合规精确的两轮车场景导航

手机银行 NEW提供手机银行APP地图应用





网格化营销 NEW提供银行网格化营销场景应用

智慧交通 优化交通资源配置，赋能智慧交通系统

出行 提供网约车等出行场景解决方案

O2O 到店、到家等多种O2O业务解决方案

上门服务调度 提供上门业务调度解决方案





三农场景可视化 NEW提供乡村振兴三农场景应用

社交 社交应用位置服务解决方案

运动 运动类应用解决方案

智能硬件 智能硬件LBS解决方案

零售铺货 零售快消行业，渠道铺货解决方案





智慧物流 针对物流行业提供解决方案

电商 电商物流行业解决方案

地址服务 综合地址服务，满足客户全景化需求

企业智图 一张图轻松管理企业数据

智能派单 一站式精准智能派单解决方案






文档与支持

文档与支持高德开放平台开发文档与服务支持 查看全部文档

API


Web基础服务API

Web高级服务API

物流服务API

猎鹰服务 API




JS API


JS API

数据可视化JS API

地图组件

URI API

地铁图 JS API




Android 平台


Android 地图SDK

Android 轻量版地图SDK

Android 定位SDK

Android 导航SDK

Android 猎鹰SDK




iOS 平台


iOS 地图SDK

iOS 轻量版地图SDK

iOS 定位SDK

iOS 导航SDK

iOS 猎鹰SDK




鸿蒙星河版平台


鸿蒙星河版地图SDK HOT

鸿蒙星河版定位SDK HOT

鸿蒙星河版导航SDK NEW




大模型开发工具


SKILL专区 NEW

MCP Server NEW

高德开放平台 CLI NEW




服务与支持


常见问题

创建工单

示例中心

合规中心

技术服务许可查询






定价

定价开放平台产品定价 产品定价

产品定价


产品定价

技术服务许可

GeoHUB自定义地图

GeoHUB数据中心




产品升级


高级能力

企业智图SaaS

云图市场






为什么选择高德




















历史记录

热门推荐
Android定位Android定位问题相关

浏览器定位JS API提供Geolocation定位插件

逆地理编码经纬度转换为详细结构化的地址

自定义地图7大类44种地图元素可定制

认证开发商商业授权相关问题














Web服务 API


概述

创建应用和 Key

入门指南

开发指南
基础 API 文档
地理/逆地理编码

路径规划

路径规划 2.0

行政区域查询

交通事件

IP定位

静态地图

坐标转换

轨迹纠偏


高级 API 文档
搜索POI

搜索POI 2.0

输入提示

天气查询

高级IP定位

智能硬件定位

交通态势查询

公交信息查询

高级路径规划


GeoHUB API文档
三方数据空间检索


实用工具
错误码说明

流量限制说明

天气对照表



常见问题

更新日志

相关下载






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


交通态势查询最后更新时间: 2026年02月02日


产品介绍

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

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


适用场景

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

提示
交通态势查询API支持的城市如下：杭州、西宁、南京、昆明、武汉、上海、珠海、沈阳、深圳、大连、宁波、西安、青岛、佛山、厦门、福州、合肥、长沙、温州、台州、常州、天津、东莞、成都、苏州、石家庄、长春、太原、济南、乌鲁木齐、绍兴、重庆、泉州、惠州、中山、无锡、广州、嘉兴、北京、金华。


使用说明





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 3 4 5 6	指定道路等级，下面各值代表的含义： 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	半径	单位：米，最大取值 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	1 2 3 4 5 6	指定道路等级，下面各值代表的含义： 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 …(内容过长已截断)

------
导航页 打开网址