SDK for Android Developer's Guide

Map Schemes

SDK for Android provides a variety of map skins for your application to choose from, these skins are otherwise known as map schemes.

Map.Scheme defines visualization types that the HERE map service supports. There is a variety of map schemes available that can be used based on the specific use case:

Explore - Normal, Terrain, Pedestrian
Overlays - Grey, Transit, Reduced, Traffic
Navigation - Car Navigation, Car Navigation with Traffic, Maneuver

You can set a desired scheme by making a call to Map.setMapScheme(String) method.

Examples of Map Scheme

All available schemes are defined as constant strings in the Map.Scheme class. The following are examples of string values that you can use to set the map scheme in your application:

Note: Your application also needs to switch to one of the following schemes if you enable traffic information with Map.setTrafficInfoVisible(true). These map schemes are otherwise identical to their non-traffic counterparts.

Scheme.HYBRID_TRAFFIC_DAY
Scheme.HYBRID_TRAFFIC_NIGHT
Scheme.NORMAL_TRAFFIC_DAY
Scheme.NORMAL_TRAFFIC_NIGHT

Note: In addition to the preceding schemes Scheme.SATELLITE_NIGHT is also available. It is similar to Scheme.SATELLITE_DAY but the color of the sky is different when the map is tilted.

Navigation Schemes

HERE SDK also offers the following schemes to be used with navigation:

Scheme.CARNAV_DAY
Scheme.CARNAV_NIGHT
Scheme.CARNAV_HYBRID_DAY
Scheme.CARNAV_HYBRID_NIGHT
Scheme.CARNAV_TRAFFIC_DAY
Scheme.CARNAV_TRAFFIC_NIGHT
Scheme.CARNAV_TRAFFIC_HYBRID_DAY
Scheme.CARNAV_TRAFFIC_HYBRID_NIGHT
Scheme.CARNAV_DAY_GREY
Scheme.CARNAV_NIGHT_GREY
Scheme.PEDESTRIAN_DAY
Scheme.PEDESTRIAN_NIGHT
Scheme.PEDESTRIAN_DAY_HYBRID
Scheme.PEDESTRIAN_NIGHT_HYBRID
Scheme.TRUCKNAV_DAY
Scheme.TRUCKNAV_NIGHT
Scheme.TRUCKNAV_HYBRID_DAY
Scheme.TRUCKNAV_HYBRID_NIGHT

If you are using a pedestrian navigation scheme, it is recommended that you also enable the pedestrian features using the Map class. See Maps for more details.

Note: HERE SDK does not automatically switch map schemes during navigation mode. Before starting car or pedestrian navigation be sure to save the current map scheme and switch to the appropriate navigation map scheme. When navigation has completed, your application code should switch back to the previously saved scheme.

For more information on how to perform navigation operations see Turn-by-Turn Navigation for Walking and Driving.

Map Schemes Example on GitHub

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

Setting a Map Scheme

The following example demonstrates how to retrieve available map schemes and change the current map scheme:

// Array containing string values of all available map schemes
List<String> schemes = map.getMapSchemes();
// Assume to select the 2nd map scheme in the available list
map.setMapScheme(schemes.get(1));

Listening to MapScheme Change Events

Applications can listen to map scheme change events via Map.OnSchemeChangedListener:

map.addSchemeChangedListener(new OnSchemeChangedListener() {
  @Override
  public void onMapSchemeChanged(String mapScheme) {
    // react to map scheme change here
  }
});

For information on the fleet map scheme see Mobile Asset Management.