v1

latestOpenAPI 3.0.22026-07-132450182.6 KB
Airspace

Retrieve all requested types of airspace traversed by route.

Retrieve selected types of airspace traversed by route. Request body parameters are:

  • route: GeoJSON Linestring defining the route. Max allowed length is 50 km.
  • asptypes: list of one or more airspace types you wish to retrieve. Allowed values are 'CAS', 'SUA', 'MAA', and 'MTR'.

Successful requests return a list of GeoJSON FeatureCollections, one for each Airspace type indicated in the request. Within each feature collection, there will be a separate Feature for each Airspace instance found. All Features will include a property indicating the airspace_type. Additional properties for each airspace_type are as follows:

  • CAS (Controlled Airspace)
    • name
    • cas_class: B, C, D, or E2
    • floor: integer value in ft MSL
    • ceiling: integer value in ft MSL
    • lannc: true/false indicating whether or not authorization for this airspace may be obtained via LAANC
  • SUA (Special Use Airspace)
    • name
    • sua_type: AA = Alert Area, MOA = Military Operations Area, NSA = National Security Area, PA = Prohibited Area, RA = Restricted Area, WA = Warning Area
    • floor: lower limit of the airspace
    • floor_uom: unit of measure used for the numeric floor value: FT (feet) or FL (flight level)
    • floor_ref: reference level used for the numeric floor value: AGL, MSL, or STD (standard atmosphere, used for flight level values)
    • ceiling: upper limit of the airspace
    • ceiling_uom: unit of measure used for the numeric floor value: FT (feet) or FL (flight level)
    • ceiling_ref: reference level used for the numeric ceiling value: AGL, MSL, or STD (standard atmosphere, used for flight level values)
    • schedule: default activation days/times (other times by NOTAM)
  • MAA (Miscellaneous Activity Area)
    • name
    • maa_type: one of the following - ULTRALIGHT, PARACHUTE JUMP AREA, AEROBATIC PRACTICE, GLIDER, HANG GLIDER, SPACE LAUNCH ACTIVITY
    • use_times: textual description of days/times when activity in the area should be expected
  • MTR (Military Training Route)
    • name
    • use_times: textual description of days/times when MTR is active/hot
    • terrain_following: boolean value indicating whether terrain following activity occurs on the route
    • max_extent_nm: maximum distance that aircraft can deviate from route centerline
post/us/v1/airspace/route-query

Headers

x-api-keystring

Request body

routeobject required
asptypesstring[] required

Example request

{
  "route": {
    "type": "LineString",
    "coordinates": [
      [
        -80.53,
        32.44
      ],
      [
        -80.52,
        32.43
      ],
      [
        -80.51,
        32.4
      ]
    ]
  },
  "asptypes": [
    "SUA",
    "MAA"
  ]
}

Response

A list of GeoJSON FeatureCollections, one for each Airspace type requested.

foundobject[] required

Example response

{
  "found": [
    {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "geometry": {
            "type": "Polygon",
            "coordinates": [
              [
                [
                  -80.358056,
                  32.566944
                ],
                [
                  -80.249722,
                  32.512778
                ],
                [
                  -80.111111,
                  32.503056
                ],
                [
                  -80.116139,
                  32.50167
                ],
                [
                  -80.127518,
                  32.49758
                ],
                [
                  -80.138996,
                  32.495621
                ],
                [
                  -80.151724,
                  32.49158
                ],
                [
                  -80.161096,
                  32.49025
                ],
                [
                  -80.184626,
                  32.49117
                ],
                [
                  -80.200534,
                  32.495307
                ],
                [
                  -80.211311,
                  32.488019
                ],
                [
                  -80.226344,
                  32.482349
                ],
                [
                  -80.243544,
                  32.472683
                ],
                [
                  -80.243786,
                  32.462409
                ],
                [
                  -80.246572,
                  32.452204
                ],
                [
                  -80.251798,
                  32.442714
                ],
                [
                  -80.25872,
                  32.434776
                ],
                [
                  -80.266254,
                  32.428822
                ],
                [
                  -80.274891,
                  32.424068
                ],
                [
                  -80.28437,
                  32.420657
                ],
                [
                  -80.294643,
                  32.418631
                ],
                [
                  -80.300121,
                  32.406121
                ],
                [
                  -80.309968,
                  32.394639
                ],
                [
                  -80.322923,
                  32.386056
                ],
                [
                  -80.33854,
                  32.380756
                ],
                [
                  -80.344311,
                  32.367298
                ],
                [
                  -80.354121,
                  32.355856
                ],
                [
                  -80.367453,
                  32.346999
                ],
                [
                  -80.383141,
                  32.341627
                ],
                [
                  -80.377304,
                  32.320843
                ],
                [
                  -80.377072,
                  32.312741
                ],
                [
                  -80.378285,
                  32.304947
                ],
                [
                  -80.381297,
                  32.296596
                ],
                [
                  -80.385969,
                  32.288817
                ],
                [
                  -80.391666,
                  32.282283
                ],
                [
                  -80.399966,
                  32.274934
                ],
                [
                  -80.410563,
                  32.268443
                ],
                [
                  -80.423267,
                  32.26371
                ],
                [
                  -80.441231,
                  32.261142
                ],
                [
                  -80.458845,
                  32.263057
                ],
                [
                  -80.466935,
                  32.257895
                ],
                [
                  -80.476094,
                  32.253933
                ],
                [
                  -80.486183,
                  32.251318
                ],
                [
                  -80.496559,
                  32.25025
                ],
                [
                  -80.499155,
                  32.248954
                ],
                [
                  -80.510148,
                  32.240612
                ],
                [
                  -80.52347,
                  32.234526
                ],
                [
                  -80.527231,
                  32.227556
                ],
                [
                  -80.531713,
                  32.221696
                ],
                [
                  -80.543819,
                  32.211489
                ],
                [
                  -80.545336,
                  32.20038
                ],
                [
                  -80.549795,
                  32.189689
                ],
                [
                  -80.557106,
                  32.179905
                ],
                [
                  -80.566623,
                  32.171957
                ],
                [
                  -80.575236,
                  32.167203
                ],
                [
                  -80.585668,
                  32.163529
                ],
                [
                  -80.587778,
                  32.163056
                ],
                [
                  -80.794167,
                  32.266944
                ],
                [
                  -80.358056,
                  32.566944
                ]
              ]
            ]
          },
          "properties": {
            "airspace_type": "SUA",
            "name": "BEAUFORT 1 MOA, SC",
            "sua_type": "MOA",
            "floor": 100,
            "floor_uom": "FT",
            "floor_ref": "AGL",
            "ceiling": 10000,
            "ceiling_uom": "FT",
            "ceiling_ref": "MSL",
            "schedule": {
              "MON": {
                "startTime": "00:00",
                "endTime": "23:59"
              },
              "TUE": {
                "startTime": "00:00",
                "endTime": "23:59"
              },
              "WED": {
                "startTime": "00:00",
                "endTime": "23:59"
              },
              "THU": {
                "startTime": "00:00",
                "endTime": "23:59"
              },
              "FRI": {
                "startTime": "00:00",
                "endTime": "23:59"
              },
              "SAT": {
                "startTime": "00:00",
                "endTime": "23:59"
              },
              "SUN": {
                "startTime": "00:00",
                "endTime": "23:59"
              }
            }
          }
        }
      ]
    },
    {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "geometry": {
            "type": "Polygon",
            "coordinates": [
              [
                [
                  -80.521886,
                  32.451703
                ],
                [
                  -80.521967,
                  32.450327
                ],
                [
                  -80.522206,
                  32.448964
                ],
                [
                  -80.522603,
                  32.447628
                ],
                [
                  -80.523153,
                  32.44633
                ],
                [
                  -80.523851,
                  32.445085
                ],
                [
                  -80.52469,
                  32.443903
                ],
                [
                  -80.525663,
                  32.442796
                ],
                [
                  -80.526759,
                  32.441775
                ],
                [
                  -80.527969,
                  32.44085
                ],
                [
                  -80.52928,
                  32.440029
                ],
                [
                  -80.530681,
                  32.439321
                ],
                [
                  -80.532157,
                  32.438732
                ],
                [
                  -80.533694,
                  32.438268
                ],
                [
                  -80.535278,
                  32.437933
                ],
                [
                  -80.536893,
                  32.437731
                ],
                [
                  -80.538523,
                  32.437663
                ],
                [
                  -80.540154,
                  32.437731
                ],
                [
                  -80.541769,
                  32.437933
                ],
                [
                  -80.543353,
                  32.438268
                ],
                [
                  -80.54489,
                  32.438732
                ],
                [
                  -80.546366,
                  32.439321
                ],
                [
                  -80.547766,
                  32.440029
                ],
                [
                  -80.549078,
                  32.44085
                ],
                [
                  -80.550287,
                  32.441775
                ],
                [
                  -80.551384,
                  32.442796
                ],
                [
                  -80.552356,
                  32.443903
                ],
                [
                  -80.553196,
                  32.445085
                ],
                [
                  -80.553894,
                  32.44633
                ],
                [
                  -80.554444,
                  32.447628
                ],
                [
                  -80.55484,
                  32.448964
                ],
                [
                  -80.55508,
                  32.450327
                ],
                [
                  -80.55516,
                  32.451703
                ],
                [
                  -80.55508,
                  32.453079
                ],
                [
                  -80.55484,
                  32.454442
                ],
                [
                  -80.554444,
                  32.455778
                ],
                [
                  -80.553894,
                  32.457075
                ],
                [
                  -80.553196,
                  32.458321
                ],
                [
                  -80.552356,
                  32.459502
                ],
                [
                  -80.551384,
                  32.460609
                ],
                [
                  -80.550287,
                  32.461629
                ],
                [
                  -80.549078,
                  32.462555
                ],
                [
                  -80.547766,
                  32.463375
                ],
                [
                  -80.546366,
                  32.464083
                ],
                [
                  -80.54489,
                  32.464672
                ],
                [
                  -80.543353,
                  32.465136
                ],
                [
                  -80.541769,
                  32.465471
                ],
                [
                  -80.540154,
                  32.465673
                ],
                [
                  -80.538523,
                  32.465741
                ],
                [
                  -80.536893,
                  32.465673
                ],
                [
                  -80.535278,
                  32.465471
                ],
                [
                  -80.533694,
                  32.465136
                ],
                [
                  -80.532157,
                  32.464672
                ],
                [
                  -80.530681,
                  32.464083
                ],
                [
                  -80.52928,
                  32.463375
                ],
                [
                  -80.527969,
                  32.462555
                ],
                [
                  -80.526759,
                  32.461629
                ],
                [
                  -80.525663,
                  32.460609
                ],
                [
                  -80.52469,
                  32.459502
                ],
                [
                  -80.523851,
                  32.458321
                ],
                [
                  -80.523153,
                  32.457075
                ],
                [
                  -80.522603,
                  32.455778
                ],
                [
                  -80.522206,
                  32.454442
                ],
                [
                  -80.521967,
                  32.453079
                ],
                [
                  -80.521886,
                  32.451703
                ]
              ]
            ]
          },
          "properties": {
            "airspace_type": "MAA",
            "name": "PSC006",
            "maa_type": "PARACHUTE JUMP AREA",
            "use_times": "SUNRISE-SUNSET, SAT, SUN, AND HOLIDAYS"
          }
        }
      ]
    }
  ]
}