Traffic Information

Traffic Flow

The following figure shows a sample traffic visualization.

Figure 1. Traffic information with color coded lines

Traffic flow lines are color coded as follows:

Traffic Information Example on GitHub

You can find an example that demonstrates this feature at https://github.com/heremaps/.

Controlling Traffic Display

You can further control traffic display by calling Map.getMapTrafficLayer() and using the MapTrafficLayer object.

With MapTrafficLayer you can individually disable Traffic Flow, Traffic Incidents, or On-Route Traffic as well as filter traffic that is displayed according to the minimal severity level.

For example, you can set the map to only display traffic flow lines that are "very high" (red) or "blocking" (black) by performing the following:

MapTrafficLayer traffic = map.getMapTrafficLayer();
// set the minimum displayed traffic level
traffic.setDisplayFilter(TrafficEvent.Severity.VERY_HIGH);

Controlling Traffic Updates

By default traffic events are automatically loaded inside the viewport when traffic is enabled. You can also explicitly fetch traffic around a given set of geocoordinates by using TrafficUpdater.request(GeoCoordinate, int, Listener).

To completely customize the traffic-updating implementation in your app, first turn off automatic traffic updates via the TrafficUpdater.disableAutoUpdate() method, then use the above mentioned method to fetch traffic only when it is required.

Selecting Traffic Objects and Events

Traffic events are selectable through map gestures and OnGestureListener.onMapObjectsSelected(List<ViewObject>). A user selectable TrafficEventObject contains live traffic event information and is presented on the map in different forms. The following figures illustrate three examples:

Figure 2. TrafficEventObject example: Roadwork	Figure 3. TrafficEventObject example: Accident	Figure 4. TrafficEventObject example: Road Closed

To acquire information about a tapped TrafficEventObject (see MapObjects), use onMapObjectsSelected(List<ViewObject>) as in the following:

private MapGesture.OnGestureListener listener = new MapGesture.OnGestureListener() {
  ...
  @Override
  public boolean onMapObjectsSelected(List<ViewObject> objects) {
    for (ViewObject obj : objects) {
      if (obj.getBaseType() == ViewObject.Type.PROXY_OBJECT) {
        MapProxyObject proxyObj = (MapProxyObject) obj;
        if (proxyObj.getType() == MapProxyObject.Type.TRAFFIC_EVENT) {
          TrafficEventObject trafficEventObj =
                 (TrafficEventObject) proxyObj;
          TrafficEvent trafficEvent =
                  trafficEventObj.getTrafficEvent();
          Toast.makeText(getApplicationContext(), trafficEvent.getEventText(),
                  Toast.LENGTH_LONG).show();
        }
      }
    }

  return true;
};