高德地图开发Android 地图SDK开发指南获取地图数据—获取交通态势信息
map开发

高德地图开发Android 地图SDK开发指南获取地图数据—获取交通态势信息

获取交通态势信息 最后更新时间: 2021年01月22日

简介

交通态势信息是由当前时刻和未来某一时刻的交通状况信息构成，目前该功能仅对当前时刻对交通状况（路况）信息进行了透出。

第 1 步：构造 TrafficSearch 对象，并设置监听

Java 

TrafficSearch trafficSearch = new TrafficSearch(this);
trafficSearch.setTrafficSearchListener(this);//此处设置this，因为实现类继承了TrafficSearchListener，也可以构造内部类实现。

第 2 步：设置查询参数

通过如下方法设置查询参数：

Java 

RoadTrafficQuery(String name, String adCode, int level);

参数说明：

参数

说明

name

查询的道路名称

adCode

道路所在城市编码

level

道路等级 

1：高速（例如：京藏高速）；

2：城市快速路、国道(例如：三环路、103国道)；

3：高速辅路（例如：G6辅路）；

4：主要道路（例如：长安街、三环辅路路）；

5：一般道路（例如：彩和坊路）；

6：无名道路；

注：以上道路数值设置之后存在从大到小的包含关系，如道路等级5代表一般道路，设置后会包含高速、城市快速路、高速辅路、主要道路以及一般道路的交通态势查询。

调用如下方法发起交通态势信息请求：

Java 

 loadTrafficByRoadAsyn(RoadTrafficQuery roadTrafficQuery);

示例：

Java 

RoadTrafficQuery roadTrafficQuery = new RoadTrafficQuery("将台路", "110000", TrafficSearch.ROAD_LEVEL_NORMAL_WAY);
trafficSearch.loadTrafficByRoadAsyn(roadTrafficQuery);

第 3 步：解析返回结果

通过回调接口 onRoadTrafficSearched 解析返回的结果：

Java 

onRoadTrafficSearched(TrafficStatusResult roadTrafficResult, int errorCode);//此为TrafficSearch.OnTrafficSearchListener监听器中的回调方法

TrafficStatusResult 类提供三个方法，分别是：

Java 

String getDescription();//返回路况综合情况描述
TrafficStatusEvaluation getEvaluation();//包含对路况的评价，拥堵占比等
List<TrafficStatusInfo> getRoads();//道路列表，包含道路坐标点集以及各道路路况信息

以上接口详细信息可参考开发指南下方的参考手册内容。