v1
latestOpenAPI 3.0.22026-07-132450182.6 KBAirspace
Retrieve all requested types of airspace located within given distance of location.
Retrieve selected types of airspace existing within given distance from a point. Request body parameters are:
- latitude: WGS84 latitude coordinate of your selected point, in decimal degrees
- longitude: WGS84 longitude coordinate of your selected point, in decimal degrees
- distance: distance in meters (max allowed value is 25000)
- 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)
- 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/distance-query
Headers
x-api-keystring
Request body
Example request
{
"longitude": -88.2188,
"latitude": 44.6031,
"distance": 5000,
"asptypes": [
"MAA",
"MTR"
]
}Response
A list of GeoJSON FeatureCollections, one for each Airspace type requested.
Example response
{
"found": [
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-88.196474,
44.637461
],
[
-88.196554,
44.636301
],
[
-88.196794,
44.635151
],
[
-88.197191,
44.634024
],
[
-88.197741,
44.63293
],
[
-88.198439,
44.63188
],
[
-88.199278,
44.630884
],
[
-88.200251,
44.62995
],
[
-88.201347,
44.629089
],
[
-88.202557,
44.628309
],
[
-88.203868,
44.627617
],
[
-88.205268,
44.62702
],
[
-88.206744,
44.626523
],
[
-88.208282,
44.626131
],
[
-88.209865,
44.625849
],
[
-88.21148,
44.625679
],
[
-88.213111,
44.625622
],
[
-88.214742,
44.625679
],
[
-88.216357,
44.625849
],
[
-88.21794,
44.626131
],
[
-88.219478,
44.626523
],
[
-88.220954,
44.62702
],
[
-88.222354,
44.627617
],
[
-88.223665,
44.628309
],
[
-88.224875,
44.629089
],
[
-88.225971,
44.62995
],
[
-88.226944,
44.630884
],
[
-88.227783,
44.63188
],
[
-88.228481,
44.63293
],
[
-88.229031,
44.634024
],
[
-88.229428,
44.635151
],
[
-88.229668,
44.636301
],
[
-88.229748,
44.637461
],
[
-88.229668,
44.638621
],
[
-88.229428,
44.63977
],
[
-88.229031,
44.640897
],
[
-88.228481,
44.641991
],
[
-88.227783,
44.643041
],
[
-88.226944,
44.644038
],
[
-88.225971,
44.644971
],
[
-88.224875,
44.645831
],
[
-88.223665,
44.646611
],
[
-88.222354,
44.647303
],
[
-88.220954,
44.6479
],
[
-88.219478,
44.648397
],
[
-88.21794,
44.648788
],
[
-88.216357,
44.649071
],
[
-88.214742,
44.649241
],
[
-88.213111,
44.649298
],
[
-88.21148,
44.649241
],
[
-88.209865,
44.649071
],
[
-88.208282,
44.648788
],
[
-88.206744,
44.648397
],
[
-88.205268,
44.6479
],
[
-88.203868,
44.647303
],
[
-88.202557,
44.646611
],
[
-88.201347,
44.645831
],
[
-88.200251,
44.644971
],
[
-88.199278,
44.644038
],
[
-88.198439,
44.643041
],
[
-88.197741,
44.641991
],
[
-88.197191,
44.640897
],
[
-88.196794,
44.63977
],
[
-88.196554,
44.638621
],
[
-88.196474,
44.637461
]
]
]
},
"properties": {
"airspace_type": "MAA",
"name": "PWI007",
"maa_type": "PARACHUTE JUMP AREA",
"use_times": "DAILY SR-SS"
}
}
]
},
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "LineString",
"coordinates": [
[
-89.108332,
44.578334
],
[
-89.283332,
44.755
],
[
-89.566666,
44.894445
],
[
-89.9,
44.891667
],
[
-88.052779,
44.561112
],
[
-89.936666,
44.450001
],
[
-89.916666,
44.233334
]
]
},
"properties": {
"airspace_type": "MTR",
"name": "1650VR",
"use_times": "0730 LOCAL-SUNSET TUE-SAT, OT BY NOTAM",
"terrain_following": true,
"max_extent_nm": 4
}
}
]
}
]
}