Check Airspace - AirHub API

Scope: aviation:read

DEPRECATED

Returns a payload containing properties that inform whether Airspace Authorization is required.

controlled: Represents airspace that is monitored and managed by air traffic control. If true, rules implemented by air traffic apply.

enabled: Applies to controlled grids/areas with altitude ceilings. At times, these grids may be disabled. If true, the altitude ceilings are in effect and require authorization in accordance with the rules and ceilings. If false, alternative authorization is likely required. For example, the Drone Zone in the US.

restricted: Denotes airspace that is subject to limitations or may be prohibited entirely. If true, drone flights cannot be authorized during a time window or in some cases into perpetuity.

Examples:

Airspace is uncontrolled and does not require authorization
{ "controlled": false, "enabled": true | false, "restricted": false }

Airspace is controlled with enabled grids/areas and requires authorization
{ "controlled": true, "enabled": true, "restricted": false }

Airspace is restricted and drone flights are not allowed
{ "controlled": false, "enabled": false, "restricted": true }

Airspace is controlled but grids/areas are not enabled and alternative authorization is required
{ "controlled": true, "enabled": false, "restricted": false }

Request

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 polygon.

type

string

required

coordinates

array [array]

required

startTime

string

required

ISO 8601 compliant start timestamp of the operation.

endTime

string

required

ISO 8601 compliant end timestamp of the operation.

Example

{
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          -112.02512913435557,
          43.47753185851303
        ],
        [
          -112.02512913435557,
          43.47466874495615
        ],
        [
          -112.02118361183014,
          43.47466874495615
        ],
        [
          -112.02118361183014,
          43.47753185851303
        ],
        [
          -112.02512913435557,
          43.47753185851303
        ]
      ]
    ]
  },
  "startTime": "2024-09-24T14:00:00.00Z",
  "endTime": "2024-09-24T15:00:00.00Z"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200200 Response

application/json

Body

statusCode

integer

required

message

string

required

data

object

required

controlled

boolean

required

enabled

boolean

required

restricted

boolean

required

Example

{
  "statusCode": 200,
  "message": "success",
  "data": {
    "controlled": false,
    "enabled": false,
    "restricted": false
  }
}