Elevation API

The purpose of this guide is to document the Elevation API

The AirMap Elevation API provides elevation data for nearly all locations on the surface of the earth (except for extreme latitudes). All responses are in meters. Here are the detailed specifications:

Projection

Geographic

Horizontal Datum

WGS84

Vertical Datum

EGM96 (Earth Gravitational Model 1996)

Vertical Units

Meters

Spatial Resolution

1 arc-second for global coverage (~30 meters)

๐Ÿšง

Elevation Dataset Limitations

The elevation dataset for this API is limited to latitudes from 56ยบS to 60ยบN

Elevation (Geo Points)

GET https://api.airmap.com/elevation/v1/ele?points={Array of LatLng Points}

Return an array of elevations matching the array of given GEO Points

Parameter Name

Type

Description

points

Array

Array of Lat/Lng Points

curl "https://api.airmap.com/elevation/v1/ele/?points=49.97609502353998,14.129133478483624" \
     -H "X-API-Key: {YOUR API KEY}" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d $'{}'
{
  "status": "success",
  "data": [
    347
  ]
}

Elevation (Carpet)

GET https://api.airmap.com/elevation/v1/ele/carpet?points=[sw, ne]

Returns a carpet, which is a concatenation of elevation values covering the rectangular area defined by the two given corners and inflated to the nearest outer pixels of the underlying elevation tiles.

The carpet is an an array of rows orientated south-west to north-east

Parameter Name

Type

Description

points

Array

Lat/Lng coordinate of the south-west and north-east corners of the rectangle.

curl "https://api.airmap.com/elevation/v1/ele/carpet?points=49.9760329253738,14.128741875966284,49.97493584462879,14.130635515530571" \
     -H "X-API-Key: {YOUR API KEY}" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d $'{}'
{
  "status": "success",
  "data": {
    "bounds": {
      "sw": [
        49.97472222222222,
        14.12861111111111
      ],
      "ne": [
        49.97611111111111,
        14.130833333333333
      ]
    },
    "stats": {
      "max": 360,
      "min": 288,
      "avg": 330.8301886792453
    },
    "carpet": [
      [
        335,
        328,
        323,
        320,
        318,
        316,
        309,
        301,
        293
      ],
      [
        349,
        342,
        334,
        331,
        327,
        322,
        315,
        304,
        292
      ],
      [
        356,
        350,
        341,
        334,
        329,
        323,
        315,
        305,
        292
      ],
      [
        358,
        351,
        345,
        337,
        329,
        320,
        312,
        301,
        289
      ],
      [
        357,
        352,
        346,
        337,
        327,
        319,
        310,
        298,
        288
      ],
      [
        360,
        354,
        347,
        337,
        329,
        321,
        311,
        302,
        293
      ]
    ]
  }
}

Elevation (Path)

Returns the profile of the path described by the given latlngs milestones.

๐Ÿšง

Notice

Please note that this returns the finest resolution it can and this cannot be negotiated

points

Array

Array of Lat/Lng geo coordinates along a path

curl "https://api.airmap.com/elevation/v1/ele/path?points=49.9760329253738,14.128741875966284,49.97493584462879,14.130635515530571" \
     -H "X-API-Key: {YOUR API KEY}" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d $'{}'
{
  "status": "success",
  "data": [
    {
      "from": [
        49.9760329253738,
        14.128741875966284
      ],
      "to": [
        49.97493584462879,
        14.130635515530571
      ],
      "step": [
        -0.00018284679083535593,
        0.00031560659404779773
      ],
      "profile": [
        360,
        346,
        337,
        329,
        323,
        315,
        304
      ]
    }
  ]
}

Updated about a year ago

Elevation API


The purpose of this guide is to document the Elevation API

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.