Skip to main content

Topography

Overview​

NOTE

The Topography plugin is a paid feature of the OsmAnd app.

Topography is an important feature of cartography that provides information to visually assess the terrain's relief. Topography information like Contour lines, Terrain (Hillshade and Slope) and 3D Relief helps to make a visual assessment of the lay of the land by seeing elevation, relief, extremes, steepness, or points of equal height.

Each feature provided by this plugin is an independent map layer that, when enabled, can be displayed above or below the main map source depending on the settings.

The Topography plugin provides access to the following map types:

  • Contour lines. This is a vector map represented in meters or feet. Contour lines show elevation levels and help visualize the terrain.
  • Hillshade. Types of map with shading of hills and slopes, which makes the relief more visible and helps to visually interpret the terrain.
  • Slope. Raster layer that provides information about the steepness of slopes, which can be important for route planning and safety.
  • 3D Relief. It is a vector map that provides a three-dimensional representation of the terrain, available only with OsmAnd Pro subscription.

Contour_lines_android Hillshade_android Slopes_android

A license for DEM data used by OsmAnd for terrain detection​

The altitude data on the map (between 70 degrees north latitude and 70 degrees south latitude) were obtained from measurements made as a part of the Shuttle Radar Topography Mission (SRTM). It utilized the Advanced Spaceborne Thermal Emission and Reflection Radiometer (ASTER), the primary imaging tool in NASA's Earth Observation System.
For complete information, see the License.

DEM (DSM) data
- ALOS DEM. The original data used for this product was supplied by JAXA’s AW3D.
- MERIT DEM.
- ArcticDEM: Porter, Claire; Morin, Paul; Howat, Ian; Noh, Myoung-Jon; Bates, Brian; Peterman, Kenneth; Keesey, Scott; Schlenk, Matthew; Gardiner, Judith; Tomko, Karen; Willis, Michael; Kelleher, Cole; Cloutier, Michael; Husby, Eric; Foga, Steven; Nakamura, Hitomi; Platson, Melisa; Wethington, Michael, Jr.; Williamson, Cathleen; Bauer, Gregory; Enos, Jeremy; Arnold, Galen; Kramer, William; Becker, Peter; Doshi, Abhijit; D’Souza, Cristelle; Cummens, Pat; Laurier, Fabien; Bojesen, Mikkel, 2018, β€œArcticDEM”, Harvard Dataverse, V1.
- Sonny's LiDAR Digital Terrain Models of Europe (DTM).

Setup​

To display Contour lines and Terrain (Hillshade, Slope) data on the map:

  1. Purchase: OsmAnd+, OsmAnd Maps+, or OsmAnd Pro purchase plan
  2. Enable Topography plugin in the Plugins section of the Main menu.
  3. Download: Contour lines, Hillshade, Slope, or Terrain map (3D) maps.
  4. Enable and adjust: Contour lines, Hillshade, or Slope for the map view.
  5. You can also watch Youtube Tutorial.

To display 3D Relief you need to purchase the OsmAnd Pro plan, wich includes Topography plugin.

Download Maps​

In order to start working with the plugin functionality, you need to download the maps you are interested in. Some maps, for example, Contour Lines mountain maps, may have a large size, more than 2 GB, and may not be supported on outdated devices.

For stable work and to save resources, you can download a map not of the entire country, but of its specific regions, if such regions are offered in the application. Information about the size of each map type is listed under their name.

3D Relief maps​

Menu β†’ Maps & Resources β†’ Regions

Contour lines download Android Contour lines download Android

You need to download Terrain map (3D) maps to display Hillshade / Slope / 3D Relief. After downloading maps, you can display Contour lines and/or Terrain using the Configure map section of the Main menu.

If the map displayed on the screen is not downloaded, then in Menu β†’ Configure map β†’ Topography section β†’ Terrain at the bottom of the list of features the section Download maps with suggested additional maps will be displayed.

Contour Lines (Meters or Feet)​

Contour lines download dialog Android

For Contour lines, you need to determine in which units (meters or feet) they will be displayed on the map and download the appropriate version of the map to your device.

The unit options are not interchangeable, so if you need to switch from meters to feet or the reverse, you need to delete the previous version of the Contour Lines map in order to download the other version.

Contour Lines​

Menu β†’ Configure map β†’ Topography β†’ Contour lines

Contour lines menu Android

Contour lines are a graphical representation of elevations on a map and are available as vector maps. They form lines corresponding to points with the same altitude, which form contours that allow you to determine in which direction and how much the surface slopes. Specific features:

  • When you use the Map rendering engine Version 2 (OpenGL), Contour lines are displayed in both 3D view and 3D relief mode.
  • When you use the Map rendering engine Version 1, if the map source is any tile map from the Internet, Contour line display is not supported.

Appearance settings:

  • Contour lines. Toggle on/off whether to display or hide Contour Lines on the map.
  • Displaying starts at zoom level. Minimum and maximum zoom level at which Contour lines are visible on the map.
  • Color scheme. Selection of the color by which Π‘ontour lines are displayed on the map.
  • Contour line width. Selection of width options for displaying Contour lines on the map.
  • Contour line density. Selection of options for the density of Contour lines displayed on the map: Low, Medium, High. At higher densities, the map is loaded more slowly.
  • Maps & Resources. Shows Contour line maps for the selected area nearby areas relative to the current map center to be downloaded.

Terrain​

Menu β†’ Configure map β†’ Topography β†’ Terrain

Terrain menu Android Terrain menu Android

The Terrain option enables and allows you to customize three features such as Hillshade, Slope, and Altitude.
Specific features:

  • Only one option can be enabled at the same time, either Hillshade, Slope, or Altitude.
  • If you do not see any changes after downloading and enabling the corresponding map, it is recommended to restart the application.

The Terrain menu includes color scheme selection with the option to modify it (for Pro subscribers), the ability to change the transparency of the layer on the map (visibility), and select the zoom level for its display, information about the size of cached data, and a list of maps needed to display the layer.

Hillshade, Slope and Altitude Layers​

HillshadeSlopeAltitude
HillshadeSlopeSlope

Hillshade is based on simulating surface lighting using terrain data. This method involves creating shadows and highlights based on the angle of the surface relative to the light source. As a result, you see natural hills, valleys, and other terrain details on the map.

Slope determines the surface slope angle based on the elevation data of points on the map. Slope angle calculations are performed considering changes in elevation and distances between points, and representing this change as a slope angle.

Altitude

Hillshade, Slope, and Altitude raster maps are created based on raster terrain data such as Digital Elevation Models (DEM).

Usage:

  • Navigation. Makes identifying steep slopes, downhill, or uphill easier, which can be important for safe navigation.
  • Plan routes. Helps to choose the most suitable routes, considering the terrain.
  • Terrain estimation. It's convenient for visualizing the landscape, especially if you're walking or biking.

Default Color Scheme​

HillshadeSlopeAltitude
HillshadeSlopeMenu

  • Hillshade uses dark shades to show slopes, peaks, and lowlands. Virtual Sun has a fixed azimuth (direction) of 315 degrees.

  • Slope uses color to visualize the steepness of the terrain. You can read more about it here. Each color corresponds to an angle of deviation from the horizontal. One of additional slope color scheme is Avalanche, available in Modify menu.

  • Altitude. Altitude map colors each pixel according to calculated map height using the gradient from a defined color scheme. Usually altitude schemes are very dependent on location. In mountain areas you would prefer to distribute colors to a wider altitude range and in flat areas, you would select a color scheme that has small range between min/max altitude.

Modify Color Scheme​

This is a Pro function and allows you to select from predefined list of color schemes. Also you can import other color schemes created on PC.

Visibility​

Visibility 31%Visibility 74%
Visibility Visibility

The Visibility function is used to adjust the transparency of the shadows for Hillshade and the colors used to represent the angle in the Slope parameter.

Zoom Levels​

Zoom

The Scale Levels function allows you to set the minimum and maximum values of map zoom levels, ranging from 4 to 19, at which the Hillshade or Slope map layers will be displayed.

Cache Size​

Cache size is an information section that shows the amount of memory on your device that is used for Terrain. Each time you view Hillshade or Slope information on a map, all of this data is temporarily stored in the cache for quick access and later use, avoiding additional load on your device's processor.

Clearing the cache is sometimes necessary to free up space on your device or to troubleshoot possible productivity issues. To clear the cache you need to go to the System Settings of the device, then the path can be as follows: Applications β†’ OsmAnd β†’ Storage β†’ Clear cache.

Rendering Engine (Android)​

Hillshade and Slope are displayed and adjusted in any selected Map rendering engine.

  • If you use the Map rendering engine Version 1, you need to use the normal downloading of Hillshade and Slope raster maps.
  • If you use the Map rendering engine Version 2 (OpenGL):
    • You can continue to use the normal Hillshade and Slope raster map download type, but you need to activate the OsmAnd development plugin and enable the Use raster SQLIte format for hillshade and slope setting.
    • Alternatively, you can use the Terrain Map (3D) download. This saves memory space on your device, and the Hillshade, Slope, and 3D Relief effects will be generated from them using your device.

Quick Actions​

QA for Terrain

You can use the Quick Action buttons on the map screen to switch the visibility of Contour Lines, Terrain layers, and Terrain color scheme. Depending on the layer selected in the Configure map menu, assigning a Terrain action to the button will display Hillshade, Slope, or Altitude.

The main settings for Show or Hide map types are in the Topography section of the Configure Map menu. In the Quick Action article, you can find a list of layers available for display. If you need quick access to this map configuration, use the Custom Button tool.

  • Go to Add action: Menu β†’ Configure screen β†’ Custom buttons β†’ Quick action β†’ Add action β†’ Configure map.
  • Add one or more QA buttons to change the visibility of particular topography layer.

3D Relief​

note

3D Relief is an OsmAnd Pro paid feature .

Menu β†’ Configure map β†’ Topography β†’ 3D Relief

3D Relief

The 3D Relief feature produces a raised relief and provides a three-dimensional representation of the landscape. 3D Relief works offline and can be used with OsmAnd vector maps or any raster maps as a Map Source or as an Underlay/Overlay.

Follow the steps below to display 3D Relief on the OsmAnd map:

Vector map layerRaster map layer
3D Relief3D Relief

Vertical Exaggeration​

Menu β†’ Configure map β†’ Topography β†’ 3D Relief β†’ Vertical exaggeration

Vertical exaggeration Android

Vertical exaggeration is a special coefficient for 3D relief. You can change the scale (Vertical exaggeration) from x1 to x3. This feature allows you to view smoother terrain contours with increased detail.

Hillshade and 3D Relief​

Hillshade3D Relief
Terrain layersTerrain layers

Hillshade is a type of map that displays terrain using shadows, creating a visual representation of the slope and shape of the earth's surface.
3D Relief is a feature that adds three-dimensional effects to the map.

If you disable Hillshade and enable 3D Relief, relief shadows will still be visible because Hillshade and 3D Relief are two different ways of visualizing a map. Hillshade creates shadows based on the terrain and adds them to the map, while 3D Relief models 3D elements to show the depth and shape of the terrain, and the shadows are part of the visualization. These features can work in parallel, and disabling Hillshade does not affect how 3D effects are displayed.

When Hillshade is enabled, an image with relief shadows appears more detailed, darker, and more stepped than a 3D Relief image. The explanation is that Hillshade emphasizes the gradients and contrasts of the terrain, creating a sharper and more detailed image. Whereas 3D Relief gives the map a more plastic and smooth look, which can soften the terrain and remove some detail.

Combine Layer Types​

Contour lines combined with Hillshade Contour lines combined with Slope

OsmAnd allows you to combine all three types of map layers: Contour lines, separately or Hillshade or Slope, and 3D Relief.

  • The combination of Contour lines and Hillshade is optimal for visual and numerical estimation of mountain slope steepness.
  • The combination of Contour lines and Slope layers is best for estimating slope steepness and finding points with the same height.
  • The combination of 3D Relief and Hillshade layers allows you to get a more realistic and visual representation of the terrain, its relief, and landscape details. This combination is especially suitable for mountainous and hilly terrain.

This article was last updated in August 2024