HERE Android SDK Developer's Guide

Map Rendering Order

The HERE SDK renders map elements in a pre-defined order through a set of overlays, so that when an overlay is rendered, elements that should appear in the foreground are not obscured by background items. As a developer, you cannot modify this rendering order or overlay grouping, but you can assign new map objects and raster tiles to a specific map overlay.

The following is a reference of the map overlays that you can set to an object or raster tile, as defined in the MapOverlayType enum. This reference also includes a listing of the map elements that are rendered on each overlay. You can use this reference to ensure that your object and tiles are rendered correctly and unobscured.

MapOverlayType Represents
BACKGROUND_REPLACEMENT Objects on this overlay replace the background. The elements that are rendered on this overlay by default include:
  • the background
  • simple map terrains
  • a high-level abstract view of the world map
BACKGROUND_OVERLAY Objects on this overlay are directly placed over (on top of) the background map. No other elements are rendered on this overlay by default.
AREA_OVERLAY Objects on this overlay contain area information. The elements that are rendered on this overlay by default include:
  • deserts
  • glaciers
  • woodlands
  • parks
  • national parks
  • urban built-up areas
  • industrial zones
  • parks
  • beaches
  • runways
  • bodies of water
  • outlines of large areas
  • outlines of buildings
ROAD_OVERLAY Objects on this overlay contain information about the road network. The elements that are rendered on this overlay by default include:
  • ferry paths
  • railroads
  • streets
  • country boundaries
  • street-level imagery coverage
  • transit paths
  • traffic flow
  • traffic incidents
TRANSIT_STOP_OVERLAY Objects on this overlay contain information about transit stops. The elements that are rendered on this overlay by default include:
  • extruded buildings
  • 3D landmarks
  • points of interest (POIs)
  • transit accesses
  • transit stops
  • city centers
  • user transit routes
POI_OVERLAY Objects on this overlay contain information that are related to points of interest. The elements that are rendered on this overlay by default include:
  • certain transit paths
  • neighborhood labels
  • park information
  • highway labels
  • safety spots
  • 3D venue objects
FOREGROUND_OVERLAY Objects on this overlay are placed on top of other objects. The elements that are rendered on this overlay by default include:
  • labels for bodies of water
  • labels for islands
  • labels for mountains
  • labels for national parks
  • labels for desert
  • labels for glaciers
  • labels for woodlands
  • labels for beaches
  • labels for industrial areas
  • labels for buildings
  • labels for addresses
  • labels and icons for venue POIs
  • arrow indicating user location