Elevation

Sandbox

POST

/v2/elevation

New

Last modified:2024-08-05 19:29:15

Scope: elevation:read

Elevation, altitude, and other "z" measurements from different sources (ex. GPS,
digital elevation models) can be measured with different vertical datum
(reference point), resulting in incompatible measurements. UAS regulation uses
"Above Ground Level" for drone heights, which requires establishing ground level.
This data service converts elevation and altitude measurements between common
vertical datum: ellipsoidal (WGS84/common GPS), orthometric (US only -
NAVD88/measurement above geoid), and Above Ground Level (AGL). Above Ground Level
(AGL) is calculated based on the difference between input z value and surface
elevation in compatible datum.

NOTE: This service is only available in the contiguous United Sates.

NOTE: This service is limited to 3600 requests per hour.

Returns a GeoJSON feature collection with requested transformations (see below)
between WGS84, NAVD88, Above Ground Level, or surface only.

Request

Header Params

Authorization

string

optional

Authorization bearer accessToken

Example:

Content-Type

string

optional

Example:

application/json;charset=UTF-8

Body Params application/json

unitsIn

string

required

Unit of input vertical/z value: ft (feet) or m (meters)

unitsOut

string

required

Unit of output vertical/z value: ft (feet) or m (meters)

transformation

string

required

The transformation made to input z values:

VALUE	DESCRIPTION
`WGS84_TO_AGL`	Input z is a WGS84 ellipsoid measurement. Returns Above Ground Level (AGL)
`NAVD88_TO_AGL`	Input z is a NAVD88 vertical datum measurement. Returns Above Ground Level (AGL)
`AGL_TO_WGS84`	Input z is Above Ground Level (AGL) and returns WGS84 ellipsoid measurement - e.g. User wants to know 100 ft AGL at a given location in WGS84
`AGL_TO_NAVD88`	Input z is Above Ground Level (AGL) and returns NAVD88 vertical datum measurement - e.g. User wants to know 100 ft AGL at a given location in NAVD88
`NAVD88_TO_WGS84`	Input z is NAVD88 and returns WGS84 ellipsoid
`WGS84_TO_NAVD88`	Input z is WGS84 ellipsoid and returns NAVD8
`XY_ONLY`	Input points with XY only (NO Z or AGL) and return WGS84 terrain, NAVD88 terrain, and geoid height

geometry

object

required

The requested point geometries: Can be GeoJSON type POINT or MULTIPOINT or LINESTRING

type

string

required

coordinates

array [oneOf]

required

Example

{
  "unitsIn": "m",
  "unitsOut": "m",
  "transformation": "AGL_TO_WGS84",
  "geometry": {
    "type": "Point",
    "coordinates": [
      -83.04,
      42.34,
      100
    ]
  }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://airhub-api-sandbox.airspacelink.com/v2/elevation' \
--header 'Content-Type: application/json' \
--data-raw '{
    "unitsIn": "m",
    "unitsOut": "m",
    "transformation": "AGL_TO_WGS84",
    "geometry": {
        "type": "Point",
        "coordinates": [
            -83.04,
            42.34,
            100
        ]
    }
}'

Responses

🟢200Success

application/json

Body

statusCode

integer

required

message

string

required

data

object

required

type

string

required

features

array [object {4}]

required

Example

{
  "statusCode": 200,
  "message": "success",
  "data": {
    "type": "FeatureCollection",
    "features": [
      {
        "id": "0",
        "type": "Feature",
        "properties": {
          "AGL": 100,
          "terrainWGS84": 149.2,
          "zWGS84": 249.2,
          "units": "m"
        },
        "geometry": {
          "type": "Point",
          "coordinates": [
            -83.04,
            42.34
          ]
        }
      }
    ]
  }
}

🟠400Bad Request

🟠404Record Not Found

Modified at 2024-08-05 19:29:15

Get Status

Overview