com.here.sdk.mapview.MapFeatures

public final class MapFeatures extends Object

Holds constants for map features, to be used with MapScene.enableFeatures(java.util.Map<java.lang.String, java.lang.String>) and MapScene.disableFeatures(java.util.List<java.lang.String>).

See MapFeatureModes for constants representing feature modes.

Note: On Android devices using PowerVR Rogue GPUs, Adreno 730-740 GPUs, or ARM Mali GPU drivers version 32-38, map rendering automatically adjusts or disables certain features to improve stability. Enabling affected features may increase memory usage and lead to application freezes or map view instability. See the notes per map feature.

On impacted GPUs, roads in MapScheme.HYBRID_DAY, MapScheme.HYBRID_NIGHT, MapScheme.LITE_HYBRID_DAY, MapScheme.LITE_HYBRID_NIGHT, MapScheme.LOGISTICS_HYBRID_DAY and MapScheme.LOGISTICS_HYBRID_NIGHT may appear darkened at road junctions due to overlapping rendering.

Field Summary

Fields

Modifier and Type

Field

Description

static final String

AMBIENT_OCCLUSION

Ambient occlusion effect for 3D geometries (extruded buildings and landmarks).

static final String

BUILDING_FOOTPRINTS

The 2D footprint of buildings.

static final String

CONGESTION_ZONES

City areas designated as congestion zones (or congestion charge zones), which impose fees on entering such areas.

static final String

CONTOURS

Show or hide contour lines on the map to represent elevation changes.

static final String

ENVIRONMENTAL_ZONES

City areas designated as environmental zones, which empose limitations on the type of vehicles that are allowed to enter such areas.

static final String

EXTRUDED_BUILDINGS

Simple 3D representation of buildings.

static final String

LANDMARKS

Displays 3D landmarks on the map.

static final String

LOW_SPEED_ZONES

City areas designated as low speed zones.

static final String

PUBLIC_TRANSIT

Toggles the display of public transit lines for systems like subway, tram, train, monorail, and ferry, based on the selected mode.

static final String

ROAD_EXIT_LABELS

Show or hide road exit labels, if available.

static final String

SAFETY_CAMERAS

Safety and speed cameras.

static final String

SHADOWS

Shadows for all building types (extruded buildings and landmarks).

static final String

TERRAIN

Show elevation topography.

static final String

TRAFFIC_FLOW

Traffic flow speed.

static final String

TRAFFIC_INCIDENTS

Traffic incidents.

static final String

TRAFFIC_LIGHTS

Traffic lights.

static final String

TRUCK_PREFERRED_ROADS

Show or hide truck preferred road

static final String

VEHICLE_RESTRICTIONS

Vehicle restrictions.
Constructor Summary

Constructors

Constructor

Description

MapFeatures()
Method Summary

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details
- EXTRUDED_BUILDINGS
  
  public static final String EXTRUDED_BUILDINGS
  
  Simple 3D representation of buildings.
  Supports only one mode: MapFeatureModes.EXTRUDED_BUILDINGS_ALL.
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY, MapScheme.ROAD_NETWORK_NIGHT and all hybrid schemes: MapScheme.HYBRID_DAY MapScheme.HYBRID_NIGHT, MapScheme.LITE_HYBRID_DAY MapScheme.LITE_HYBRID_NIGHT, MapScheme.LOGISTICS_HYBRID_DAY and MapScheme.LOGISTICS_HYBRID_NIGHT.
  By default, extruded buildings are enabled on all compatible map schemes.
  See Also:
  
  Constant Field Values
- BUILDING_FOOTPRINTS
  
  public static final String BUILDING_FOOTPRINTS
  
  The 2D footprint of buildings.
  Supports only one mode: MapFeatureModes.BUILDING_FOOTPRINTS_ALL.
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY, MapScheme.ROAD_NETWORK_NIGHT and all hybrid schemes: MapScheme.HYBRID_DAY MapScheme.HYBRID_NIGHT, MapScheme.LITE_HYBRID_DAY MapScheme.LITE_HYBRID_NIGHT, MapScheme.LOGISTICS_HYBRID_DAY and MapScheme.LOGISTICS_HYBRID_NIGHT.
  By default, building footprints are enabled on all compatible map schemes.
  See Also:
  
  Constant Field Values
- TRAFFIC_FLOW
  
  public static final String TRAFFIC_FLOW
  Traffic flow speed. An online connection is required for the traffic flow to be shown.
  If the offline-mode is enabled for offline maps usage, the live traffic flow can still be shown in offline mode by enabling pass-through feature for traffic flow on sdk.core.engine.SDKNativeEngine. See sdk.core.engine.SDKNativeEngine.pass_through_features for details.
  Supported modes:
  
  MapFeatureModes.TRAFFIC_FLOW_JAPAN_WITHOUT_FREE_FLOW,
  
  MapFeatureModes.TRAFFIC_FLOW_WITH_FREE_FLOW,
  
  MapFeatureModes.TRAFFIC_FLOW_WITHOUT_FREE_FLOW.
  
  Default mode is MapFeatureModes.TRAFFIC_FLOW_WITH_FREE_FLOW.
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY and MapScheme.ROAD_NETWORK_NIGHT. By default, this map feature is not enabled.
  See Also:
  
  Constant Field Values
- TRAFFIC_INCIDENTS
  
  public static final String TRAFFIC_INCIDENTS
  
  Traffic incidents. An online connection is required for the traffic incidents to be shown.
  If the offline-mode is enabled for offline maps usage, the live traffic incidents can still be shown in offline mode by enabling pass-through feature for traffic incidents on sdk.core.engine.SDKNativeEngine. See sdk.core.engine.SDKNativeEngine.pass_through_features for details.
  Supports only one mode: MapFeatureModes.TRAFFIC_INCIDENTS_ALL.
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY and MapScheme.ROAD_NETWORK_NIGHT. By default, this map feature is not enabled.
  See Also:
  
  Constant Field Values
- TRAFFIC_LIGHTS
  
  public static final String TRAFFIC_LIGHTS
  
  Traffic lights.
  Supports only one mode: MapFeatureModes.TRAFFIC_LIGHTS_ALL
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY and MapScheme.ROAD_NETWORK_NIGHT.
  By default, traffic lights are enabled on all compatible map schemes.
  See Also:
  
  Constant Field Values
- VEHICLE_RESTRICTIONS
  
  public static final String VEHICLE_RESTRICTIONS
  
  Vehicle restrictions. Requires map version 25 as minimum. If old map data is stored on disk, it might require updating using MapUpdater.
  Supported modes: MapFeatureModes.VEHICLE_RESTRICTIONS_ACTIVE, MapFeatureModes.VEHICLE_RESTRICTIONS_ACTIVE_AND_INACTIVE and MapFeatureModes.VEHICLE_RESTRICTIONS_ACTIVE_AND_INACTIVE_DIFFERENTIATED.
  Default mode when enabled is MapFeatureModes.VEHICLE_RESTRICTIONS_ACTIVE_AND_INACTIVE.
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY and MapScheme.ROAD_NETWORK_NIGHT. By default, this map feature is not enabled.
  See Also:
  
  Constant Field Values
- SAFETY_CAMERAS
  
  public static final String SAFETY_CAMERAS
  
  Safety and speed cameras.
  Supports only one mode: MapFeatureModes.SAFETY_CAMERAS_ALL.
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY and MapScheme.ROAD_NETWORK_NIGHT. By default, this map feature is not enabled.
  See Also:
  
  Constant Field Values
- LANDMARKS
  
  public static final String LANDMARKS
  
  Displays 3D landmarks on the map.
  Please note: Enabling 3D landmarks with 3D terrain may result in instances where landmarks sink into or float above the terrain.
  Supported modes: MapFeatureModes.LANDMARKS_TEXTURED, MapFeatureModes.LANDMARKS_GRAYSCALE and MapFeatureModes.LANDMARKS_TEXTURELESS.
  Default mode is MapFeatureModes.LANDMARKS_GRAYSCALE.
  By default, 3D landmarks are enabled on all compatible map schemes.
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY, MapScheme.ROAD_NETWORK_NIGHT and all hybrid schemes: MapScheme.HYBRID_DAY MapScheme.HYBRID_NIGHT, MapScheme.LITE_HYBRID_DAY MapScheme.LITE_HYBRID_NIGHT, MapScheme.LOGISTICS_HYBRID_DAY and MapScheme.LOGISTICS_HYBRID_NIGHT.
  See Also:
  
  Constant Field Values
- ENVIRONMENTAL_ZONES
  
  public static final String ENVIRONMENTAL_ZONES
  
  City areas designated as environmental zones, which empose limitations on the type of vehicles that are allowed to enter such areas.
  Supports only one mode: MapFeatureModes.ENVIRONMENTAL_ZONES_ALL.
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY and MapScheme.ROAD_NETWORK_NIGHT. By default, this map feature is not enabled. Note: On PowerVR Rogue, Adreno 730-740, or ARM Mali GPUs (driver version 32-38), environmental zones may appear visibly darkened due to overlapping rendering.
  See Also:
  
  Constant Field Values
- CONGESTION_ZONES
  
  public static final String CONGESTION_ZONES
  
  City areas designated as congestion zones (or congestion charge zones), which impose fees on entering such areas.
  Supports only one mode: MapFeatureModes.CONGESTION_ZONES_ALL.
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY and MapScheme.ROAD_NETWORK_NIGHT. By default, this map feature is not enabled. Note: On PowerVR Rogue, Adreno 730-740, or ARM Mali GPUs (driver version 32-38), congestion zones may appear visibly darkened due to overlapping rendering.
  See Also:
  
  Constant Field Values
- LOW_SPEED_ZONES
  
  public static final String LOW_SPEED_ZONES
  
  City areas designated as low speed zones. Only available when Japan map is used.
  Supports only one mode: MapFeatureModes.LOW_SPEED_ZONES_ALL.
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY and MapScheme.ROAD_NETWORK_NIGHT. By default, this map feature is not enabled. Note: On PowerVR Rogue, Adreno 730-740, or ARM Mali GPUs (driver version 32-38), low speed zones may appear visibly darkened due to overlapping rendering.
  See Also:
  
  Constant Field Values
- TERRAIN
  
  public static final String TERRAIN
  
  Show elevation topography.
  Supported modes: MapFeatureModes.TERRAIN_HILLSHADE, MapFeatureModes.TERRAIN_3D.
  MapFeatureModes.TERRAIN_HILLSHADE is only supported for schemes MapScheme.NORMAL_DAY, MapScheme.NORMAL_NIGHT, MapScheme.LITE_DAY, MapScheme.LITE_NIGHT, MapScheme.LOGISTICS_DAY and MapScheme.LOGISTICS_NIGHT, MapScheme.TOPO_DAY and MapScheme.TOPO_NIGHT.
  Default mode is MapFeatureModes.TERRAIN_HILLSHADE for the supporting schemes.
  By default, terrain is disabled, except for MapScheme.TOPO_DAY and MapScheme.TOPO_NIGHT.
  Note that this feature has performance implications, with extra data use and impact on frame rate. If performance is a concern, this feature can be disabled from the application side when loading the map scene.
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY and MapScheme.ROAD_NETWORK_NIGHT.
  Note: On PowerVR Rogue GPUs, when MapFeatureModes.TERRAIN_3D is requested, it is automatically switched to MapFeatureModes.TERRAIN_HILLSHADE.
  Note: This is a beta release of this feature and may contain bugs or exhibit unexpected behaviour. Related APIs are subject to change without a deprecation process.
  See Also:
  
  Constant Field Values
- PUBLIC_TRANSIT
  
  public static final String PUBLIC_TRANSIT
  
  Toggles the display of public transit lines for systems like subway, tram, train, monorail, and ferry, based on the selected mode.
  Supported modes: MapFeatureModes.PUBLIC_TRANSIT_ALL, MapFeatureModes.PUBLIC_TRANSIT_ASIA.
  MapFeatureModes.PUBLIC_TRANSIT_ASIA is supported only when credentials enabled for the enriched Japan map are used.
  Public transit is disabled by default for all map schemes when using Rest-of-World map data. When using enriched Japan map data, public transit is enabled by default with MapFeatureModes.PUBLIC_TRANSIT_ASIA on normal, lite and topo schemes (including their hybrid variants) and disabled by default on logistics schemes.
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY and MapScheme.ROAD_NETWORK_NIGHT.
  Note: This is a beta release of this feature and may contain bugs or exhibit unexpected behaviour. Related APIs are subject to change without a deprecation process.
  See Also:
  
  Constant Field Values
- ROAD_EXIT_LABELS
  
  public static final String ROAD_EXIT_LABELS
  
  Show or hide road exit labels, if available.
  Supported modes: MapFeatureModes.ROAD_EXIT_LABELS_NUMBERS_ONLY, MapFeatureModes.ROAD_EXIT_LABELS_ALL
  Default mode is MapFeatureModes.ROAD_EXIT_LABELS_NUMBERS_ONLY.
  Road exit labels are enabled by default with MapFeatureModes.ROAD_EXIT_LABELS_NUMBERS_ONLY on normal, lite and topo schemes and with MapFeatureModes.ROAD_EXIT_LABELS_ALL on logistics schemes. Note that topo schemes are only available in the HERE SDK Navigate variant.
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY and MapScheme.ROAD_NETWORK_NIGHT.
  See Also:
  
  Constant Field Values
- SHADOWS
  
  public static final String SHADOWS
  
  Shadows for all building types (extruded buildings and landmarks).
  Supports only one mode: MapFeatureModes.SHADOWS_ALL.
  A ShadowQuality must be set on the MapContext through a MapView or the feature has no effect.
  Shadows have a performance impact and should be considered only for devices with sufficient performance.
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY, MapScheme.ROAD_NETWORK_NIGHT and all hybrid schemes: MapScheme.HYBRID_DAY MapScheme.HYBRID_NIGHT, MapScheme.LITE_HYBRID_DAY MapScheme.LITE_HYBRID_NIGHT, MapScheme.LOGISTICS_HYBRID_DAY and MapScheme.LOGISTICS_HYBRID_NIGHT.
  Note: On PowerVR Rogue, Adreno 730-740, or ARM Mali GPUs (driver version 32-38), this feature cannot be enabled and requests to enable it are ignored.
  Note: This is a beta release of this feature and may contain bugs or exhibit unexpected behaviour. Related APIs are subject to change without a deprecation process. By default, this map feature is not enabled.
  See Also:
  
  Constant Field Values
- AMBIENT_OCCLUSION
  
  public static final String AMBIENT_OCCLUSION
  
  Ambient occlusion effect for 3D geometries (extruded buildings and landmarks).
  Supports only one mode: MapFeatureModes.AMBIENT_OCCLUSION_ALL.
  This visual effect has a performance impact and should be considered only for devices with sufficient performance.
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY, MapScheme.ROAD_NETWORK_NIGHT and all hybrid schemes: MapScheme.HYBRID_DAY MapScheme.HYBRID_NIGHT, MapScheme.LITE_HYBRID_DAY MapScheme.LITE_HYBRID_NIGHT, MapScheme.LOGISTICS_HYBRID_DAY and MapScheme.LOGISTICS_HYBRID_NIGHT.
  Note: On PowerVR Rogue, Adreno 730-740, or ARM Mali GPUs (driver version 32-38), this feature cannot be enabled and requests to enable it are ignored.
  Note: This is a beta release of this feature and may contain bugs or exhibit unexpected behaviour. Related APIs are subject to change without a deprecation process. By default, this map feature is not enabled.
  See Also:
  
  Constant Field Values
- CONTOURS
  
  public static final String CONTOURS
  
  Show or hide contour lines on the map to represent elevation changes.
  Supports only one mode: MapFeatureModes.CONTOURS_ALL
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY, MapScheme.ROAD_NETWORK_NIGHT and all hybrid schemes: MapScheme.HYBRID_DAY MapScheme.HYBRID_NIGHT, MapScheme.LITE_HYBRID_DAY MapScheme.LITE_HYBRID_NIGHT, MapScheme.LOGISTICS_HYBRID_DAY and MapScheme.LOGISTICS_HYBRID_NIGHT.
  Contours are enabled by default on topo schemes and disabled by default on other schemes.
  See Also:
  
  Constant Field Values
- TRUCK_PREFERRED_ROADS
  
  public static final String TRUCK_PREFERRED_ROADS
  
  Show or hide truck preferred road
  Supported modes: MapFeatureModes.TRUCK_PREFERRED_ROADS_ALL
  Not supported for MapScheme.SATELLITE, MapScheme.ROAD_NETWORK_DAY and MapScheme.ROAD_NETWORK_NIGHT. By default, this map feature is not enabled.
  See Also:
  
  Constant Field Values
Constructor Details
- MapFeatures
  
  public MapFeatures()

Class MapFeatures

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Details

EXTRUDED_BUILDINGS

BUILDING_FOOTPRINTS

TRAFFIC_FLOW

TRAFFIC_INCIDENTS

TRAFFIC_LIGHTS

VEHICLE_RESTRICTIONS

SAFETY_CAMERAS

LANDMARKS

ENVIRONMENTAL_ZONES

CONGESTION_ZONES

LOW_SPEED_ZONES

TERRAIN

PUBLIC_TRANSIT

ROAD_EXIT_LABELS

SHADOWS

AMBIENT_OCCLUSION

CONTOURS

TRUCK_PREFERRED_ROADS

Constructor Details

MapFeatures