MapMetrics Atlas API Docs

Appearance

Elevation API ​

Elevation lookup service provides digital elevation model (DEM) data as the result of a query. The elevation service data has many applications when combined with other routing and navigation data, including computing the steepness of roads and paths or generating an elevation profile chart along a route.

Inputs of the elevation service ​

An elevation service request takes the form of json={}, where the JSON inputs inside the {} includes location information.

Use Shape list for input location ​

The elevation request run locally takes the form of json={}, where the JSON inputs inside the {} are described below.

A shape request must include a latitude and longitude in decimal degrees, and the locations are visited in the order specified. The input coordinates can come from many input sources, such as a GPS location, a point or a click on a map, a geocoding service, and so on.

These parameters are available for shape.

Shape Parameters ​

ParameterDescription
latLatitude of the location in degrees
lonLongitude of the location in degrees
tokentoken parameter is required /elevation/?token=YOUR TOKEN

Example 1: Request with range and shape ​

json
{"range":true,"shape":[{"lat":40.712431,"lon":-76.504916},{"lat":40.712275,"lon":-76.605259},{"lat":40.712122,"lon":-76.805694},{"lat":40.722431,"lon":-76.884916},{"lat":40.812275,"lon":-76.905259},{"lat":40.912122,"lon":-76.965694}]}

Example 2: ​

json
{"shape":[{"lat":40.712433,"lon":-76.504913},{"lat":40.712276,"lon":-76.605263},{"lat":40.712124,"lon":-76.805695},{"lat":40.722431,"lon":-76.884918},{"lat":40.812275,"lon":-76.905258},{"lat":40.912121,"lon":-76.965691}],"range_height":[[0,307],[8467,272],[25380,204],[32162,204],[42309,180],[54533,198]]}

Example 3: ​

json
{"range":true,"shape":[{"lat":40.712431,"lon":-76.504916},{"lat":40.712275,"lon":-76.605259},{"lat":40.712122,"lon":-76.805694},{"lat":40.722431,"lon":-76.884916},{"lat":40.812275,"lon":-76.905259},{"lat":40.912122,"lon":-76.965694}]}

Example Response ​

json
{
  "shape": [
    {"lat": 40.712431, "lon": -76.504916},
    {"lat": 40.712275, "lon": -76.605259},
    {"lat": 40.712122, "lon": -76.805694},
    {"lat": 40.722431, "lon": -76.884916},
    {"lat": 40.812275, "lon": -76.905259},
    {"lat": 40.912122, "lon": -76.965694}
  ],
  "range_height": [
    [0, 307],
    [8467, 272],
    [25380, 204],
    [32162, 204],
    [42309, 180],
    [54533, 198]
  ],
  "height": [307, 272, 204, 204, 180, 198]
}

Response Fields:

  • shape: Array of lat/lon coordinates that were queried
  • range_height: Array of [distance, elevation] pairs where distance is in meters from the start point
  • height: Simple array of elevation values in meters corresponding to each coordinate in the shape