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: https://mapzen.com/documentation/terrain-tiles/
Parameter | Description |
---|---|
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: https://www.youtube.com/watch?v=Vf0mAmxLU4M |
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: https://www.youtube.com/watch?v=im84wGILI7I |
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 'https://api-connect.eos.com/api/render/terrain/11/328/794?api_key=<your api key>'
Hillshade​
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: https://en.wikipedia.org/wiki/Terrain_cartography#Shaded_relief
GeoTIFF​
Tiles in GeoTIFF format, with spatial reference. Default dimensions - 256 x 256 pixels. Default projection - EPSG:3857 (Pseudo-Mercator, Web Mercator).
Default representation​
https://api-connect.eos.com/api/render/terrain/11/328/794?format=geotiff&api_key=<your_api_key>
Outliers filtering​
https://api-connect.eos.com/api/render/terrain/11/328/794?format=geotiff&FILTERING=TRUE&api_key=<your_api_key>
Slope​
Slope is the measure of steepness or the degree of inclination of a feature relative to the horizontal plane. Wiki: https://en.wikipedia.org/wiki/Grade_%28slope%29
Default slope visualization​
https://api-connect.eos.com/api/render/terrain/11/328/794?format=slope&api_key=<your_api_key>
Slope visualization with a custom palette​
https://api-connect.eos.com/api/render/terrain/11/328/794?format=slope&COLORMAP=OrRd_r&api_key=<your_api_key>
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.
https://api-connect.eos.com/api/render/terrain/11/328/794?format=slope&COLORMAP=Spectral&SLOPE_RANGE=0%2C70&api_key=<your_api_key>
HTTP Request​
GET https://api-connect.eos.com/api/render/terrain/<z>/<x>/<y>?api_key=<your api key>
Example:
https://api-connect.eos.com/api/render/terrain/11/328/794?api_key=<your_api_key>
Elevation point value​
Get elevation value in a given point.
curl -i 'https://api-connect.eos.com/api/render/terrain/point/<lat>/<lon>?api_key=<your_api_key>'
The above commands returns the following JSON with results
{"index_value": 1198.758544921875}
HTTP Request​
GET https://api-connect.eos.com/api/render/terrain/point/<lat>/<lon>?api_key=<your_api_key>
Parameters​
Parameter | Value | Description |
---|---|---|
lat | 35.947344068 | Latitude geographic coordinate that specifies the north–south position of a point on the Earth’s surface |
lon | 121.345009409 | Longitude 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​
Parameter | Value | Description |
---|---|---|
api_key | (Required) Apikey retrieved from developer portal |