AirHub API

Check Airspace

Deprecated

POST/v1/check/airspace

Last modified: 6 months ago

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:

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.

{
  "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

Responses

200 Response(200)

HTTP Code: 200

Content Type : JSONapplication/json

statusCode

integer

required

message

string

required

data

object

required

controlled

boolean

required

enabled

boolean

required

restricted

boolean

required

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

Last modified: 6 months ago