背景与目标
在交通日益复杂的城市环境中，获取实时的路况信息对于优化出行路线至关重要。本方案基于 Java 语言，通过调用百度地图开放平台的 Traffic API，实现对长沙市热门道路及景点周边的实时拥堵情况检索。
接口概览
百度地图提供了两类主要的实时路况查询服务：
- 道路实时路况：针对特定道路名称（如'五一大道'）进行查询。
- 周边实时路况：基于中心点坐标和半径，查询周围路网状况。
请求参数说明
以道路查询为例，核心参数包括开发者密钥（ak）、道路名称（road_name）及城市标识（city）。周边查询则需额外提供经纬度坐标（center）和搜索半径（radius）。返回数据统一包含状态码、整体路况评估及详细路段信息。
数据模型封装
为了便于处理返回的 JSON 数据，我们使用 Java 对象进行映射。这里采用 Lombok 简化代码，定义了一系列 DTO 类来对应 API 响应结构。
// 公共基础类
@NoArgsConstructor @AllArgsConstructor @Setter @Getter @ToString
public class BdCommonDTO implements Serializable {
private int status;
private String message;
}
主响应对象继承自公共类，并包含路况描述、整体评估及具体路段列表。
@NoArgsConstructor @AllArgsConstructor @Setter @Getter @ToString(callSuper=true)
public class BdTrafficDTO extends BdCommonDTO implements Serializable{
private String description;
private BdTrafficEvaluation evaluation;
@SerializedName("road_traffic")
private List<BdRoadTrafficDetail> roadTraffic;
}
细分对象分别对应整体评价（畅通、缓行等）和具体路段详情（拥堵距离、趋势等）。这种分层设计使得后续的数据解析和业务逻辑处理更加清晰。
集成与调用
项目中使用 UniHttp 框架简化 HTTP 请求。首先声明接口，指定路径和参数注解。注意，若 AK 未开启 SN 校验，需在注解中设置 。
