9 Using the Maps app

9.1 About the Maps app

The Maps App is introduced in release 2.29 and serves as a replacement of the GIS App offering a more intuitive and user-friendly interface.

With the Maps app you can overlay multiple layers and choose among different base maps. You can create thematic maps of areas and points, view facilities based on classifications, and visualize catchment areas for each facility. You can add labels to areas and points, and search and filter using various criteria. You can move points and set locations on the fly. Maps can be saved as favorites and shared with other users and groups.


To use predefined legends in the Maps app, you need to create them first in the Maintenance app.

  • The layer panel on the left side of the workspace shows an overview of the layers for the current map:

    • As layers are added, using the (+) Add layer button, they are arranged and managed in this panel.

    • The basemap is always shown in the panel. The default basemap is OSM Light and is selected by default. OpenStreetMap Detailed, Google Streets and Google Hybrid are also available. You can use these maps as background maps and layers. Switch between them by selecting the desired image.

    • The small arrow button to the right of the layer panel, at the top, allows the panel to be hidden or shown.

  • The Favorites button near the top left allows you to save and open maps:

    • New

      will clear any existing map layers to create a new thematic map.

    • Open

      will display a Favorites dialog to select an existing thematic map. Favorites can also be renamed, shared and deleted through the Favorites dialog. The title of the current favorite is displayed in the header bar above the Favorites button.

    • Save

      will save any changes to the current favorite.

    • Save as

      will save the current thematic map as a new favorite.

    • Write interpretation

      will open a dialog where an interpretation for the current favorite can be written.

    • Get link

      will provide a direct link and API link to the current favorite.

  • The + and - buttons on the map allow you to zoom in and out of the map respectively. The mouse scroll wheel can also be used for altering the zoom.

  • Zoom to content (bounded magnifying glass symbol) automatically adjusts the zoom level and map center position to put the data on your map in focus.

  • Search (magnifying glass symbol) allows searching for and jumping to a location on the map.

  • The ruler button allows you to find the distance between two locations on the map.

  • To view information for an event, simply click the event.

  • Right-click on the map to display the longitude and latitude of that location.

  • The home icon on the top right of the workspace will take you back to the DHIS2 dashboard.

  • The About button will display system version information.


Basemap layers are represented by layer cards in the layer panel such as:

Along the top of the basemap card from left to right are:

  • The title of the selected basemap

  • An eye symbol for toggling the visibility of the layer

  • An arrow symbol to collapse and expand the basemap card

In the middle of the basemap card is the list of available basemaps. The current basemap is highlighted.

Along the bottom of the basemap card is:

  • A slider for modifying the layer transparency