Skip to main content

Terrain tile API

The API serves raster tiles of Terrain Tiles dataset - basemap digital elevation model (DEM) of the world in a raster tile format.

For more information on Terrain Tiles please refer to:

format(optional) tile format [hillshade, geotiff, slope]. Default : hillshade
FILTERING(optional) bool parameter, apply artifact removing (filtering) to tile? Default : FALSE
COLORMAP(optional) name of colormap to be applied for slope. Default : terrain
MIN_SLOPE(optional) min slope to be shown. Default : 0
SLOPE_RANGE(optional) slope range for map visualization and legend. Default : (0.0,90.0)
AZIMUTH(optional, valid when format=hillshade) The azimuth is the angular direction of the sun, measured from north in clockwise degrees from 0 to 360. An azimuth of 90 degrees is east. The default azimuth is 315 degrees (NW). Visualization:
ALTITUDE(optional, valid when format=hillshade) The altitude is the slope or angle of the illumination source above the horizon. The units are in degrees, from 0 (on the horizon) to 90 (overhead). The default is 45 degrees. Visualization:
THRESHOLDS(optional, valid when format=hillshade) The value thresholds for coloring the terrain.
COLORS(optional, valid when format=hillshade) The hex color values linked to the corresponding ranges, which are derived by given THRESHOLDS.

Representation of DEM data​

Various techniques can be used to visualize terrain data.

curl '<your api key>'

Render terrain


Shaded relief, or hill-shading, shows the shape of the terrain in a realistic fashion by showing how the three-dimensional surface would be illuminated from a point light source. For details, see:


Tiles in GeoTIFF format, with spatial reference. Default dimensions - 256 x 256 pixels. Default projection - EPSG:3857 (Pseudo-Mercator, Web Mercator).

Default representation​<your_api_key>

Outliers filtering​<your_api_key>


Slope is the measure of steepness or the degree of inclination of a feature relative to the horizontal plane. Wiki:

Default slope visualization​<your_api_key>

Render terrain

Slope visualization with a custom palette​<your_api_key>

Render terrain

Slope range correction​

When a minimum and maximum values of slope are known in advance they can be set using SLOPE_RANGE query to enhance local representation.<your_api_key>

HTTP Request​

GET<z>/<x>/<y>?api_key=<your api key>


Elevation point value​

Get elevation value in a given point.

curl -i '<lat>/<lon>?api_key=<your_api_key>'

The above commands returns the following JSON with results

{"index_value": 1198.758544921875}

HTTP Request​



lat35.947344068Latitude geographic coordinate that specifies the north–south position of a point on the Earth’s surface
lon121.345009409Longitude is a geographic coordinate that specifies the east-west position of a point on the Earth’s surface. It is an angular measurement

Query parameters​

api_key(Required) Apikey retrieved from developer portal