AirHub API
  1. Elevation - NEW
AirHub API
  • Introduction
  • Authorization
    • Overview
    • Get Oauth Token
      POST
  • Advisories
    • Advisory
      POST
    • Get Advisories BBox
      GET
    • Get Advisories GeoJSON
      POST
  • Briefing
    • Overview
    • B4UFLY
      • What Is B4UFLY
      • The API Basics
      • Location vs Area
      • v1
        • B4UFLY Briefing by Area v1
        • B4UFLY Briefing by Location v1
      • v2
        • What's New in v2
        • B4UFLY Briefing by Area v2
        • B4UFLY Briefing by Location v2
  • LAANC SDSP
    • Overview
    • ASL Operations
      • List Operations
      • Create Operation
      • Get Operation
      • Delete Operation
      • Update Operation
    • LAANC Operations
      • Get Operation
      • Delete Operation
      • Create Operation
      • Update Operation
    • LAANC Authorizations
      • Rescinded and Invalid Operations
      • Submit Authorization
      • Get Authorization
      • Cancel Authorization
      • Cancel Invalid Authorization
      • Close Authorization
      • Acknowledge Rescinded Authorization
    • Operation v2
      POST
    • Create Ephemeral Operations
      POST
  • Risk
    • Get Hazard
      POST
    • Get Hazard Ground Type
      POST
    • Get Hazard Ground Risk
      POST
  • Aviation
    • Aviation
      POST
  • Surface
    • Suitability
      POST
    • Classification Surface
      POST
    • Surface v2 GeoJSON
      POST
    • Surface v2 Hexbin
      POST
  • Route
    • Route v2
  • Check
    • Check Airspace
    • Get Status
  • Elevation - NEW
    • Elevation
      POST
  • Map Vector Tiles - NEW
    • Overview
    • Styled Tiles
    • Vector Tile
  1. Elevation - NEW

Elevation

Sandbox
https://airhub-api-sandbox.airspacelink.com
Sandbox
https://airhub-api-sandbox.airspacelink.com
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:
{{access-token}}
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:
VALUEDESCRIPTION
WGS84_TO_AGLInput z is a WGS84 ellipsoid measurement. Returns Above Ground Level (AGL)
NAVD88_TO_AGLInput z is a NAVD88 vertical datum measurement. Returns Above Ground Level (AGL)
AGL_TO_WGS84Input 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_NAVD88Input 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_WGS84Input z is NAVD88 and returns WGS84 ellipsoid
WGS84_TO_NAVD88Input z is WGS84 ellipsoid and returns NAVD8
XY_ONLYInput 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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
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
Previous
Get Status
Next
Overview
Built with