Aviation - AirHub API

Request

Query Params

buffer

number

optional

Note: only used when type includes airports. buffer specifies the buffer around the airport in nautical miles. If not specified, the default is 3.

Header Params

Content-Type

enum<string>

required

Allowed value:

application/json;charset=UTF-8

Example:

application/json;charset=UTF-8

Authorization

string

required

Authorization bearer accessToken generated in Authorization step

Example:

Body Params application/json

geometry

object

required

GeoJSON formatted geometry. Available geometries may be a point, line, or polygon. The resulting bounding box of the geometry can't have a side length greater than 30 nautical miles.

coordinates

array [array]

required

type

string

required

type

array[string]

required

An array of zero or more types. Specifying type will limit the results to only include the types that you specify. If you specify no type then all types will be returned.

FAA Type	Description
controlled_airspace	Controlled Airspace Classification.
uasfm_ceiling	UAS Facility Management Flight Ceiling.
sua	Both sua_prohibited and sua_restricted.
washington_frz	Washington DC Flight Restricted Zone.
nsufr_pt	Part Time National Security UAS Flight Restriction.
nsufr_ft	Full Time National Security UAS Flight Restriction.
stadium	Select stadiums containing temporary flight restriction. The stadium points are buffered by 3 nautical miles.
airports	Points designated for landing or takeoff. Returns all airports within 3 nautical miles of input geometry by default.
airspace_schedule	Controlled airspace schedule for select airports across the country (geometry has no bearing on the result).
tfr	Temporary Flight Restrictions imposed by the FAA to restrict aircraft operations within designated areas.

Example

{
  "geometry": {
    "coordinates": [
      [
        -85.5252170562744,
        41.7848170756551
      ]
    ],
    "type": "Point"
  },
  "type": [
    "sua",
    "stadium"
  ]
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://airhub-api-sandbox.airspacelink.com/v1/aviation?buffer' \
--header 'Authorization: ' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
    "geometry": {
        "coordinates": [
            [
                -85.5252170562744,
                41.7848170756551
            ]
        ],
        "type": "Point"
    },
    "type": [
        "sua",
        "stadium"
    ]
}'

Responses

🟢200Success

application/json

Body

data

array [object {3}]

required

geometry

object

optional

properties

object

optional

type

string

optional

message

string

required

statusCode

integer

required

Example

{
  "data": [
    {
      "geometry": {
        "coordinates": [
          [
            [
              -83.2320785522461,
              42.3341843859394
            ],
            [
              -83.2262420654297,
              42.3341843859394
            ],
            [
              -83.2262420654297,
              42.3364684929947
            ],
            [
              -83.2320785522461,
              42.3364684929947
            ],
            [
              -83.2320785522461,
              42.3341843859394
            ]
          ]
        ],
        "type": "Polygon"
      },
      "properties": {},
      "type": "Feature"
    }
  ],
  "message": "success",
  "statusCode": 200
}

🟠422Parameter Error

🔴500500