Airspace
Background
The National Airspace System (NAS) contains many different categories, types, and designations of airspace. Not all are relevant for UAV operations, but a full understanding of the whole NAS is useful. Your best references are these two FAA publications:
Your concerns as related to airspace will be “am I legally allowed to be here?”, and “is it safe for me to be here?”. DFlight API provides the relevant information you need. In this tutorial we’ll walk through the process of making calls to the airspace endpoints and understanding the results returned to you.
The airspace request body
As with all information categories available in DFlight there are three endpoints for airspace, one for each way you can define your geographic area of interest. We’ll be using the route-query option for this example. The request body has two required elements:
- route: GeoJSON Linestring defining the route
- asptypes: list of one or more airspace types you wish to retrieve. Allowed values are “CAS”, “SUA”, “MAA”, and “MTR” where
-
- CAS – Controlled Airspace
- SUA – Special Use Airspace
- MAA – Miscellaneous Activity Areas
- MTR – Military Training Routes
In order to discuss every airspace type available we include all types in the asptypes list and have chosen a route that traverses at least one of example each. Here is our request body:
{ "route": { "type": "LineString", "coordinates": [[-77.419999, 34.564914], [-77.603671, 34.432356], [-77.851233, 34.292991]] }, "asptypes": ["SUA","MTR","MAA","CAS"] }
and we’ll send our POST request to the /airspace/route-query endpoint.
{ "found": [ { "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "type": "Polygon", "coordinates": [ [ [ -77.591389, 34.475278 ], [ -77.466389, 34.583611 ], [ -77.383056, 34.579444 ], [ -77.316389, 34.550278 ], [ -77.263611, 34.505833 ], [ -77.269167, 34.505556 ], [ -77.271944, 34.504722 ], [ -77.275, 34.502222 ], [ -77.279444, 34.499444 ], [ -77.285833, 34.495556 ], [ -77.292222, 34.492222 ], [ -77.297222, 34.49 ], [ -77.303056, 34.487778 ], [ -77.309722, 34.485 ], [ -77.314722, 34.482222 ], [ -77.319444, 34.480278 ], [ -77.324444, 34.478611 ], [ -77.329722, 34.476389 ], [ -77.335556, 34.473889 ], [ -77.339444, 34.471944 ], [ -77.343333, 34.470556 ], [ -77.346667, 34.469167 ], [ -77.349444, 34.467778 ], [ -77.352778, 34.466667 ], [ -77.356667, 34.465556 ], [ -77.359722, 34.463889 ], [ -77.363333, 34.462222 ], [ -77.366389, 34.461389 ], [ -77.370556, 34.459722 ], [ -77.375, 34.458611 ], [ -77.378611, 34.456667 ], [ -77.381667, 34.455278 ], [ -77.385556, 34.454167 ], [ -77.388333, 34.453333 ], [ -77.392778, 34.451944 ], [ -77.395833, 34.450833 ], [ -77.398333, 34.449722 ], [ -77.401389, 34.449167 ], [ -77.403889, 34.447778 ], [ -77.4075, 34.446944 ], [ -77.410556, 34.446111 ], [ -77.415, 34.444722 ], [ -77.418611, 34.443611 ], [ -77.420556, 34.441944 ], [ -77.423611, 34.440556 ], [ -77.426667, 34.438889 ], [ -77.431111, 34.436111 ], [ -77.435556, 34.434167 ], [ -77.439167, 34.431667 ], [ -77.443333, 34.428611 ], [ -77.448333, 34.428611 ], [ -77.452222, 34.423333 ], [ -77.454444, 34.421389 ], [ -77.457222, 34.420556 ], [ -77.461111, 34.419167 ], [ -77.464444, 34.416667 ], [ -77.468611, 34.414167 ], [ -77.471389, 34.413333 ], [ -77.475556, 34.411389 ], [ -77.480556, 34.408333 ], [ -77.485, 34.405556 ], [ -77.488611, 34.403611 ], [ -77.499444, 34.391667 ], [ -77.591389, 34.475278 ] ] ] }, "properties": { "airspace_type": "SUA", "name": "HATTERAS F MOA, NC", "sua_type": "MOA", "floor": 3000, "floor_uom": "FT", "floor_ref": "MSL", "ceiling": 13000, "ceiling_uom": "FT", "ceiling_ref": "MSL" } }, { "type": "Feature", "geometry": { "type": "Polygon", "coordinates": [ [ [ -77.531111, 34.541111 ], [ -77.526877, 34.540989 ], [ -77.522663, 34.540624 ], [ -77.518491, 34.540018 ], [ -77.51438, 34.539173 ], [ -77.510351, 34.538094 ], [ -77.506423, 34.536786 ], [ -77.502616, 34.535255 ], [ -77.498948, 34.533509 ], [ -77.495436, 34.531557 ], [ -77.492099, 34.529407 ], [ -77.488952, 34.527071 ], [ -77.486011, 34.524559 ], [ -77.48329, 34.521885 ], [ -77.480802, 34.51906 ], [ -77.478559, 34.5161 ], [ -77.476572, 34.513017 ], [ -77.474852, 34.509828 ], [ -77.473406, 34.506548 ], [ -77.472241, 34.503193 ], [ -77.471363, 34.499779 ], [ -77.470776, 34.496323 ], [ -77.470483, 34.492841 ], [ -77.470485, 34.489351 ], [ -77.470783, 34.48587 ], [ -77.471375, 34.482414 ], [ -77.472258, 34.479001 ], [ -77.473427, 34.475647 ], [ -77.474877, 34.472368 ], [ -77.476601, 34.46918 ], [ -77.47859, 34.4661 ], [ -77.480835, 34.463141 ], [ -77.483325, 34.460319 ], [ -77.486047, 34.457646 ], [ -77.488989, 34.455137 ], [ -77.492135, 34.452803 ], [ -77.495471, 34.450655 ], [ -77.49898, 34.448704 ], [ -77.502646, 34.44696 ], [ -77.50645, 34.445431 ], [ -77.510374, 34.444125 ], [ -77.514399, 34.443047 ], [ -77.518506, 34.442203 ], [ -77.522673, 34.441597 ], [ -77.526882, 34.441233 ], [ -77.531111, 34.441111 ], [ -77.53534, 34.441233 ], [ -77.539549, 34.441597 ], [ -77.543716, 34.442203 ], [ -77.547823, 34.443047 ], [ -77.551848, 34.444125 ], [ -77.555772, 34.445431 ], [ -77.559576, 34.44696 ], [ -77.563242, 34.448704 ], [ -77.566751, 34.450655 ], [ -77.570087, 34.452803 ], [ -77.573233, 34.455137 ], [ -77.576175, 34.457646 ], [ -77.578897, 34.460319 ], [ -77.581387, 34.463141 ], [ -77.583632, 34.4661 ], [ -77.585621, 34.46918 ], [ -77.587345, 34.472368 ], [ -77.588795, 34.475647 ], [ -77.589964, 34.479001 ], [ -77.590847, 34.482414 ], [ -77.591439, 34.48587 ], [ -77.591737, 34.489351 ], [ -77.591739, 34.492841 ], [ -77.591446, 34.496323 ], [ -77.590859, 34.499779 ], [ -77.589981, 34.503193 ], [ -77.588816, 34.506548 ], [ -77.58737, 34.509828 ], [ -77.58565, 34.513017 ], [ -77.583663, 34.5161 ], [ -77.58142, 34.51906 ], [ -77.578932, 34.521885 ], [ -77.576211, 34.524559 ], [ -77.57327, 34.527071 ], [ -77.570123, 34.529407 ], [ -77.566786, 34.531557 ], [ -77.563274, 34.533509 ], [ -77.559606, 34.535255 ], [ -77.555799, 34.536786 ], [ -77.551871, 34.538094 ], [ -77.547842, 34.539173 ], [ -77.543731, 34.540018 ], [ -77.539559, 34.540624 ], [ -77.535345, 34.540989 ], [ -77.531111, 34.541111 ] ] ] }, "properties": { "airspace_type": "SUA", "name": "R-5304A CAMP LEJEUNE, NC", "sua_type": "RA", "floor": 0, "floor_uom": "FT", "floor_ref": "AGL", "ceiling": 7000, "ceiling_uom": "FT", "ceiling_ref": "AGL" } } ] }, { "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "type": "LineString", "coordinates": [ [ -77.716663, 34.349996 ], [ -77.78333, 34.799997 ], [ -76.199997, 34.966663 ], [ -76.63333, 35.199996 ], [ -75.216667, 35.3 ], [ -75.35, 35.35 ], [ -75.649999, 35.649998 ], [ -75.725, 35.683333 ], [ -75.216667, 35.3 ], [ -75.3, 35.275 ] ] }, "properties": { "airspace_type": "MTR", "name": "012IR", "use_times": "CONTINUOUS", "terrain_following": true, "max_extent_nm": 5 } }, { "type": "Feature", "geometry": { "type": "LineString", "coordinates": [ [ -77.699997, 33.916663 ], [ -77.749996, 34.449996 ], [ -77.033331, 34.449996 ], [ -78.683332, 33.949998 ], [ -79.95, 33.966663 ], [ -79.449999, 33.599997 ], [ -80.933333, 33.599999 ] ] }, "properties": { "airspace_type": "MTR", "name": "035IR", "use_times": "0600-2200 LOCAL, DAILY", "terrain_following": true, "max_extent_nm": 5 } }, { "type": "Feature", "geometry": { "type": "LineString", "coordinates": [ [ -75.449999, 35.399996 ], [ -76.883331, 36.216665 ], [ -76.333326, 36.48333 ], [ -77.466663, 36.633332 ], [ -78.666664, 36.399999 ], [ -78.349997, 35.733332 ], [ -78.299997, 34.883331 ], [ -78.699997, 34.533331 ], [ -77.216664, 34.53333 ], [ -76.016665, 34.73333 ], [ -76.533329, 35.33333 ], [ -76.949997, 35.53333 ], [ -75.449997, 35.883328 ], [ -76.949997, 35.53333 ], [ -75.266667, 35.25 ] ] }, "properties": { "airspace_type": "MTR", "name": "062IR", "use_times": "CONTINUOUS", "terrain_following": false, "max_extent_nm": 4 } }, { "type": "Feature", "geometry": { "type": "LineString", "coordinates": [ [ -77.633331, 33.899996 ], [ -77.733329, 34.434996 ], [ -77.033331, 34.449996 ], [ -78.266667, 33.75 ], [ -78.183333, 33.516667 ], [ -78.05, 33.333333 ], [ -79.633332, 33.149997 ], [ -79.533331, 32.33333 ], [ -79.066667, 31.9 ], [ -80.816664, 31.516663 ], [ -80.933331, 30.249999 ], [ -80.766664, 29.699999 ], [ -80.549997, 29.399999 ], [ -80.48333, 29.383332 ] ] }, "properties": { "airspace_type": "MTR", "name": "1040VR", "use_times": "CONTINUOUS", "terrain_following": false, "max_extent_nm": 4 } }, { "type": "Feature", "geometry": { "type": "LineString", "coordinates": [ [ -76.933331, 34.866664 ], [ -76.833332, 34.499997 ], [ -76.056667, 33.805 ], [ -77.633331, 33.899996 ], [ -77.733329, 34.434996 ], [ -77.033331, 34.449996 ], [ -78.499997, 34.533331 ], [ -79.883332, 34.58333 ], [ -79.733334, 34.416663 ], [ -80, 34.016663 ], [ -78.749999, 34.049998 ], [ -77.366664, 34.016663 ], [ -76.099999, 34.083329 ], [ -75.466666, 34.583329 ], [ -75.483333, 34.758329 ] ] }, "properties": { "airspace_type": "MTR", "name": "1043VR", "use_times": "0700-2300 LOCAL DAILY", "terrain_following": false, "max_extent_nm": 2 } } ] }, { "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "type": "Polygon", "coordinates": [ [ [ -77.401502, 34.576557 ], [ -77.401582, 34.575215 ], [ -77.401822, 34.573885 ], [ -77.402218, 34.572581 ], [ -77.402768, 34.571315 ], [ -77.403466, 34.5701 ], [ -77.404306, 34.568947 ], [ -77.405278, 34.567867 ], [ -77.406375, 34.566871 ], [ -77.407584, 34.565968 ], [ -77.408896, 34.565167 ], [ -77.410296, 34.564476 ], [ -77.411772, 34.563901 ], [ -77.413309, 34.563448 ], [ -77.414893, 34.563121 ], [ -77.416508, 34.562924 ], [ -77.418139, 34.562858 ], [ -77.419769, 34.562924 ], [ -77.421384, 34.563121 ], [ -77.422968, 34.563448 ], [ -77.424505, 34.563901 ], [ -77.425981, 34.564476 ], [ -77.427382, 34.565167 ], [ -77.428693, 34.565968 ], [ -77.429903, 34.566871 ], [ -77.430999, 34.567867 ], [ -77.431972, 34.568947 ], [ -77.432811, 34.5701 ], [ -77.433509, 34.571315 ], [ -77.434059, 34.572581 ], [ -77.434456, 34.573885 ], [ -77.434695, 34.575215 ], [ -77.434775, 34.576557 ], [ -77.434695, 34.5779 ], [ -77.434456, 34.57923 ], [ -77.434059, 34.580534 ], [ -77.433509, 34.581799 ], [ -77.432811, 34.583015 ], [ -77.431972, 34.584167 ], [ -77.430999, 34.585247 ], [ -77.429903, 34.586243 ], [ -77.428693, 34.587146 ], [ -77.427382, 34.587946 ], [ -77.425981, 34.588637 ], [ -77.424505, 34.589212 ], [ -77.422968, 34.589665 ], [ -77.421384, 34.589991 ], [ -77.419769, 34.590189 ], [ -77.418139, 34.590255 ], [ -77.416508, 34.590189 ], [ -77.414893, 34.589991 ], [ -77.413309, 34.589665 ], [ -77.411772, 34.589212 ], [ -77.410296, 34.588637 ], [ -77.408896, 34.587946 ], [ -77.407584, 34.587146 ], [ -77.406375, 34.586243 ], [ -77.405278, 34.585247 ], [ -77.404306, 34.584167 ], [ -77.403466, 34.583015 ], [ -77.402768, 34.581799 ], [ -77.402218, 34.580534 ], [ -77.401822, 34.57923 ], [ -77.401582, 34.5779 ], [ -77.401502, 34.576557 ] ] ] }, "properties": { "airspace_type": "MAA", "name": "OWL DROP ZONE", "maa_type": "PARACHUTE JUMP AREA", "use_times": "UNKNOWN" } } ] }, { "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "type": "Polygon", "coordinates": [ [ [ -77.901412, 34.187356 ], [ -77.903581, 34.187356 ], [ -77.905749, 34.187395 ], [ -77.907916, 34.187473 ], [ -77.91008, 34.187589 ], [ -77.912241, 34.187745 ], [ -77.914398, 34.187939 ], [ -77.916548, 34.188171 ], [ -77.918693, 34.188442 ], [ -77.920829, 34.188752 ], [ -77.922958, 34.1891 ], [ -77.925076, 34.189486 ], [ -77.927185, 34.189909 ], [ -77.929281, 34.190371 ], [ -77.931366, 34.190869 ], [ -77.933436, 34.191405 ], [ -77.935493, 34.191979 ], [ -77.937534, 34.192588 ], [ -77.939559, 34.193235 ], [ -77.941567, 34.193917 ], [ -77.943556, 34.194635 ], [ -77.945526, 34.195389 ], [ -77.947477, 34.196178 ], [ -77.949406, 34.197001 ], [ -77.951314, 34.197859 ], [ -77.953199, 34.198751 ], [ -77.95506, 34.199677 ], [ -77.956897, 34.200636 ], [ -77.958709, 34.201627 ], [ -77.960494, 34.202651 ], [ -77.962253, 34.203706 ], [ -77.963983, 34.204793 ], [ -77.965685, 34.205911 ], [ -77.967358, 34.207058 ], [ -77.969001, 34.208236 ], [ -77.970612, 34.209442 ], [ -77.972192, 34.210678 ], [ -77.97374, 34.211941 ], [ -77.975254, 34.213232 ], [ -77.976735, 34.214549 ], [ -77.978181, 34.215893 ], [ -77.979592, 34.217262 ], [ -77.980966, 34.218657 ], [ -77.982305, 34.220075 ], [ -77.983606, 34.221518 ], [ -77.98487, 34.222983 ], [ -77.986095, 34.22447 ], [ -77.987281, 34.22598 ], [ -77.988428, 34.22751 ], [ -77.989535, 34.22906 ], [ -77.990601, 34.23063 ], [ -77.991626, 34.232219 ], [ -77.99261, 34.233825 ], [ -77.993552, 34.235449 ], [ -77.994451, 34.237089 ], [ -77.995308, 34.238745 ], [ -77.996121, 34.240416 ], [ -77.996891, 34.242102 ], [ -77.997617, 34.2438 ], [ -77.998298, 34.245511 ], [ -77.998935, 34.247234 ], [ -77.999527, 34.248969 ], [ -78.000074, 34.250713 ], [ -78.000575, 34.252467 ], [ -78.001031, 34.254229 ], [ -78.001441, 34.255999 ], [ -78.001804, 34.257776 ], [ -78.002122, 34.259559 ], [ -78.002392, 34.261347 ], [ -78.002617, 34.26314 ], [ -78.002795, 34.264936 ], [ -78.002926, 34.266735 ], [ -78.00301, 34.268536 ], [ -78.003047, 34.270339 ], [ -78.003037, 34.272141 ], [ -78.002981, 34.273943 ], [ -78.002878, 34.275743 ], [ -78.002728, 34.277541 ], [ -78.002531, 34.279336 ], [ -78.002287, 34.281127 ], [ -78.001997, 34.282913 ], [ -78.001661, 34.284694 ], [ -78.001278, 34.286468 ], [ -78.000849, 34.288235 ], [ -78.000375, 34.289994 ], [ -77.999854, 34.291744 ], [ -77.999289, 34.293484 ], [ -77.998678, 34.295214 ], [ -77.998022, 34.296932 ], [ -77.997322, 34.298638 ], [ -77.996577, 34.300331 ], [ -77.995789, 34.302011 ], [ -77.994957, 34.303676 ], [ -77.994081, 34.305325 ], [ -77.993163, 34.306959 ], [ -77.992203, 34.308575 ], [ -77.991201, 34.310174 ], [ -77.990158, 34.311755 ], [ -77.989073, 34.313317 ], [ -77.987948, 34.314859 ], [ -77.986783, 34.31638 ], [ -77.985579, 34.31788 ], [ -77.984336, 34.319359 ], [ -77.983055, 34.320814 ], [ -77.981736, 34.322246 ], [ -77.980381, 34.323655 ], [ -77.978988, 34.325038 ], [ -77.977561, 34.326397 ], [ -77.976098, 34.327729 ], [ -77.9746, 34.329035 ], [ -77.973069, 34.330314 ], [ -77.971505, 34.331565 ], [ -77.969909, 34.332788 ], [ -77.968281, 34.333982 ], [ -77.966623, 34.335146 ], [ -77.964934, 34.33628 ], [ -77.963217, 34.337384 ], [ -77.961471, 34.338457 ], [ -77.959697, 34.339498 ], [ -77.957897, 34.340508 ], [ -77.956071, 34.341484 ], [ -77.95422, 34.342428 ], [ -77.952344, 34.343338 ], [ -77.950446, 34.344215 ], [ -77.948525, 34.345057 ], [ -77.946582, 34.345865 ], [ -77.944619, 34.346638 ], [ -77.942636, 34.347375 ], [ -77.940634, 34.348077 ], [ -77.938615, 34.348742 ], [ -77.936578, 34.349371 ], [ -77.934526, 34.349964 ], [ -77.932459, 34.350519 ], [ -77.930378, 34.351038 ], [ -77.928283, 34.351519 ], [ -77.926177, 34.351962 ], [ -77.924059, 34.352368 ], [ -77.921932, 34.352735 ], [ -77.919795, 34.353065 ], [ -77.917651, 34.353355 ], [ -77.915499, 34.353608 ], [ -77.913341, 34.353821 ], [ -77.911178, 34.353996 ], [ -77.909011, 34.354133 ], [ -77.906841, 34.35423 ], [ -77.904669, 34.354288 ], [ -77.902496, 34.354308 ], [ -77.900323, 34.354288 ], [ -77.898151, 34.35423 ], [ -77.895981, 34.354133 ], [ -77.893814, 34.353996 ], [ -77.891651, 34.353821 ], [ -77.889493, 34.353608 ], [ -77.887341, 34.353355 ], [ -77.885196, 34.353064 ], [ -77.88306, 34.352735 ], [ -77.880932, 34.352368 ], [ -77.878815, 34.351962 ], [ -77.876708, 34.351519 ], [ -77.874614, 34.351038 ], [ -77.872533, 34.350519 ], [ -77.870465, 34.349963 ], [ -77.868413, 34.349371 ], [ -77.866377, 34.348742 ], [ -77.864357, 34.348076 ], [ -77.862356, 34.347375 ], [ -77.860373, 34.346637 ], [ -77.85841, 34.345865 ], [ -77.856467, 34.345057 ], [ -77.854546, 34.344214 ], [ -77.852647, 34.343338 ], [ -77.850772, 34.342428 ], [ -77.848921, 34.341484 ], [ -77.847095, 34.340507 ], [ -77.845294, 34.339498 ], [ -77.843521, 34.338456 ], [ -77.841775, 34.337384 ], [ -77.840057, 34.33628 ], [ -77.838369, 34.335145 ], [ -77.83671, 34.333981 ], [ -77.835083, 34.332787 ], [ -77.833486, 34.331564 ], [ -77.831922, 34.330313 ], [ -77.830391, 34.329034 ], [ -77.828894, 34.327728 ], [ -77.827431, 34.326396 ], [ -77.826003, 34.325038 ], [ -77.824611, 34.323654 ], [ -77.823255, 34.322246 ], [ -77.821936, 34.320813 ], [ -77.820655, 34.319358 ], [ -77.819412, 34.31788 ], [ -77.818208, 34.316379 ], [ -77.817043, 34.314858 ], [ -77.815919, 34.313316 ], [ -77.814834, 34.311754 ], [ -77.813791, 34.310174 ], [ -77.812789, 34.308575 ], [ -77.811828, 34.306958 ], [ -77.81091, 34.305324 ], [ -77.810035, 34.303675 ], [ -77.809203, 34.30201 ], [ -77.808415, 34.30033 ], [ -77.80767, 34.298637 ], [ -77.80697, 34.296931 ], [ -77.806314, 34.295213 ], [ -77.805703, 34.293483 ], [ -77.805137, 34.291743 ], [ -77.804617, 34.289993 ], [ -77.804142, 34.288234 ], [ -77.803714, 34.286468 ], [ -77.803331, 34.284693 ], [ -77.802995, 34.282913 ], [ -77.802705, 34.281126 ], [ -77.802461, 34.279335 ], [ -77.802264, 34.27754 ], [ -77.802114, 34.275742 ], [ -77.802011, 34.273942 ], [ -77.801954, 34.27214 ], [ -77.801945, 34.270338 ], [ -77.801982, 34.268536 ], [ -77.802066, 34.266735 ], [ -77.802197, 34.264936 ], [ -77.802375, 34.263139 ], [ -77.802599, 34.261346 ], [ -77.80287, 34.259558 ], [ -77.803188, 34.257775 ], [ -77.803551, 34.255998 ], [ -77.803961, 34.254228 ], [ -77.804417, 34.252466 ], [ -77.804918, 34.250712 ], [ -77.805465, 34.248968 ], [ -77.806057, 34.247234 ], [ -77.806694, 34.245511 ], [ -77.807375, 34.2438 ], [ -77.808101, 34.242101 ], [ -77.808871, 34.240416 ], [ -77.809684, 34.238745 ], [ -77.810541, 34.237089 ], [ -77.81144, 34.235448 ], [ -77.812382, 34.233824 ], [ -77.813366, 34.232218 ], [ -77.814391, 34.230629 ], [ -77.815457, 34.22906 ], [ -77.816564, 34.227509 ], [ -77.817711, 34.225979 ], [ -77.818897, 34.22447 ], [ -77.820123, 34.222982 ], [ -77.821386, 34.221517 ], [ -77.822687, 34.220075 ], [ -77.824026, 34.218656 ], [ -77.825401, 34.217262 ], [ -77.826811, 34.215892 ], [ -77.828257, 34.214549 ], [ -77.829738, 34.213231 ], [ -77.831252, 34.21194 ], [ -77.8328, 34.210677 ], [ -77.83438, 34.209442 ], [ -77.835991, 34.208235 ], [ -77.837634, 34.207058 ], [ -77.839307, 34.20591 ], [ -77.841009, 34.204793 ], [ -77.84274, 34.203706 ], [ -77.844498, 34.202651 ], [ -77.846284, 34.201627 ], [ -77.848095, 34.200635 ], [ -77.849932, 34.199677 ], [ -77.851793, 34.198751 ], [ -77.853678, 34.197859 ], [ -77.855586, 34.197001 ], [ -77.857516, 34.196178 ], [ -77.859466, 34.195389 ], [ -77.861436, 34.194635 ], [ -77.863426, 34.193917 ], [ -77.865433, 34.193234 ], [ -77.867458, 34.192588 ], [ -77.869499, 34.191978 ], [ -77.871556, 34.191405 ], [ -77.873627, 34.190869 ], [ -77.875711, 34.19037 ], [ -77.877808, 34.189909 ], [ -77.879916, 34.189485 ], [ -77.882035, 34.1891 ], [ -77.884163, 34.188752 ], [ -77.8863, 34.188442 ], [ -77.888444, 34.188171 ], [ -77.890595, 34.187939 ], [ -77.892751, 34.187745 ], [ -77.894912, 34.187589 ], [ -77.897076, 34.187473 ], [ -77.899243, 34.187395 ], [ -77.901412, 34.187356 ] ] ] }, "properties": { "airspace_type": "CAS", "name": "WILMINGTON CLASS E2", "cas_class": "E2", "floor": 0, "ceiling": 18000, "laanc": true } }, { "type": "Feature", "geometry": { "type": "Polygon", "coordinates": [ [ [ -77.901412, 34.187356 ], [ -77.903581, 34.187356 ], [ -77.905749, 34.187395 ], [ -77.907916, 34.187473 ], [ -77.91008, 34.187589 ], [ -77.912241, 34.187745 ], [ -77.914398, 34.187939 ], [ -77.916548, 34.188171 ], [ -77.918693, 34.188442 ], [ -77.920829, 34.188752 ], [ -77.922958, 34.1891 ], [ -77.925076, 34.189486 ], [ -77.927185, 34.189909 ], [ -77.929281, 34.190371 ], [ -77.931366, 34.190869 ], [ -77.933436, 34.191405 ], [ -77.935493, 34.191979 ], [ -77.937534, 34.192588 ], [ -77.939559, 34.193235 ], [ -77.941567, 34.193917 ], [ -77.943556, 34.194635 ], [ -77.945526, 34.195389 ], [ -77.947477, 34.196178 ], [ -77.949406, 34.197001 ], [ -77.951314, 34.197859 ], [ -77.953199, 34.198751 ], [ -77.95506, 34.199677 ], [ -77.956897, 34.200636 ], [ -77.958709, 34.201627 ], [ -77.960494, 34.202651 ], [ -77.962253, 34.203706 ], [ -77.963983, 34.204793 ], [ -77.965685, 34.205911 ], [ -77.967358, 34.207058 ], [ -77.969001, 34.208236 ], [ -77.970612, 34.209442 ], [ -77.972192, 34.210678 ], [ -77.97374, 34.211941 ], [ -77.975254, 34.213232 ], [ -77.976735, 34.214549 ], [ -77.978181, 34.215893 ], [ -77.979592, 34.217262 ], [ -77.980966, 34.218657 ], [ -77.982305, 34.220075 ], [ -77.983606, 34.221518 ], [ -77.98487, 34.222983 ], [ -77.986095, 34.22447 ], [ -77.987281, 34.22598 ], [ -77.988428, 34.22751 ], [ -77.989535, 34.22906 ], [ -77.990601, 34.23063 ], [ -77.991626, 34.232219 ], [ -77.99261, 34.233825 ], [ -77.993552, 34.235449 ], [ -77.994451, 34.237089 ], [ -77.995308, 34.238745 ], [ -77.996121, 34.240416 ], [ -77.996891, 34.242102 ], [ -77.997617, 34.2438 ], [ -77.998298, 34.245511 ], [ -77.998935, 34.247234 ], [ -77.999527, 34.248969 ], [ -78.000074, 34.250713 ], [ -78.000575, 34.252467 ], [ -78.001031, 34.254229 ], [ -78.001441, 34.255999 ], [ -78.001804, 34.257776 ], [ -78.002122, 34.259559 ], [ -78.002392, 34.261347 ], [ -78.002617, 34.26314 ], [ -78.002795, 34.264936 ], [ -78.002926, 34.266735 ], [ -78.00301, 34.268536 ], [ -78.003047, 34.270339 ], [ -78.003037, 34.272141 ], [ -78.002981, 34.273943 ], [ -78.002878, 34.275743 ], [ -78.002728, 34.277541 ], [ -78.002531, 34.279336 ], [ -78.002287, 34.281127 ], [ -78.001997, 34.282913 ], [ -78.001661, 34.284694 ], [ -78.001278, 34.286468 ], [ -78.000849, 34.288235 ], [ -78.000375, 34.289994 ], [ -77.999854, 34.291744 ], [ -77.999289, 34.293484 ], [ -77.998678, 34.295214 ], [ -77.998022, 34.296932 ], [ -77.997322, 34.298638 ], [ -77.996577, 34.300331 ], [ -77.995789, 34.302011 ], [ -77.994957, 34.303676 ], [ -77.994081, 34.305325 ], [ -77.993163, 34.306959 ], [ -77.992203, 34.308575 ], [ -77.991201, 34.310174 ], [ -77.990158, 34.311755 ], [ -77.989073, 34.313317 ], [ -77.987948, 34.314859 ], [ -77.986783, 34.31638 ], [ -77.985579, 34.31788 ], [ -77.984336, 34.319359 ], [ -77.983055, 34.320814 ], [ -77.981736, 34.322246 ], [ -77.980381, 34.323655 ], [ -77.978988, 34.325038 ], [ -77.977561, 34.326397 ], [ -77.976098, 34.327729 ], [ -77.9746, 34.329035 ], [ -77.973069, 34.330314 ], [ -77.971505, 34.331565 ], [ -77.969909, 34.332788 ], [ -77.968281, 34.333982 ], [ -77.966623, 34.335146 ], [ -77.964934, 34.33628 ], [ -77.963217, 34.337384 ], [ -77.961471, 34.338457 ], [ -77.959697, 34.339498 ], [ -77.957897, 34.340508 ], [ -77.956071, 34.341484 ], [ -77.95422, 34.342428 ], [ -77.952344, 34.343338 ], [ -77.950446, 34.344215 ], [ -77.948525, 34.345057 ], [ -77.946582, 34.345865 ], [ -77.944619, 34.346638 ], [ -77.942636, 34.347375 ], [ -77.940634, 34.348077 ], [ -77.938615, 34.348742 ], [ -77.936578, 34.349371 ], [ -77.934526, 34.349964 ], [ -77.932459, 34.350519 ], [ -77.930378, 34.351038 ], [ -77.928283, 34.351519 ], [ -77.926177, 34.351962 ], [ -77.924059, 34.352368 ], [ -77.921932, 34.352735 ], [ -77.919795, 34.353065 ], [ -77.917651, 34.353355 ], [ -77.915499, 34.353608 ], [ -77.913341, 34.353821 ], [ -77.911178, 34.353996 ], [ -77.909011, 34.354133 ], [ -77.906841, 34.35423 ], [ -77.904669, 34.354288 ], [ -77.902496, 34.354308 ], [ -77.900323, 34.354288 ], [ -77.898151, 34.35423 ], [ -77.895981, 34.354133 ], [ -77.893814, 34.353996 ], [ -77.891651, 34.353821 ], [ -77.889493, 34.353608 ], [ -77.887341, 34.353355 ], [ -77.885196, 34.353064 ], [ -77.88306, 34.352735 ], [ -77.880932, 34.352368 ], [ -77.878815, 34.351962 ], [ -77.876708, 34.351519 ], [ -77.874614, 34.351038 ], [ -77.872533, 34.350519 ], [ -77.870465, 34.349963 ], [ -77.868413, 34.349371 ], [ -77.866377, 34.348742 ], [ -77.864357, 34.348076 ], [ -77.862356, 34.347375 ], [ -77.860373, 34.346637 ], [ -77.85841, 34.345865 ], [ -77.856467, 34.345057 ], [ -77.854546, 34.344214 ], [ -77.852647, 34.343338 ], [ -77.850772, 34.342428 ], [ -77.848921, 34.341484 ], [ -77.847095, 34.340507 ], [ -77.845294, 34.339498 ], [ -77.843521, 34.338456 ], [ -77.841775, 34.337384 ], [ -77.840057, 34.33628 ], [ -77.838369, 34.335145 ], [ -77.83671, 34.333981 ], [ -77.835083, 34.332787 ], [ -77.833486, 34.331564 ], [ -77.831922, 34.330313 ], [ -77.830391, 34.329034 ], [ -77.828894, 34.327728 ], [ -77.827431, 34.326396 ], [ -77.826003, 34.325038 ], [ -77.824611, 34.323654 ], [ -77.823255, 34.322246 ], [ -77.821936, 34.320813 ], [ -77.820655, 34.319358 ], [ -77.819412, 34.31788 ], [ -77.818208, 34.316379 ], [ -77.817043, 34.314858 ], [ -77.815919, 34.313316 ], [ -77.814834, 34.311754 ], [ -77.813791, 34.310174 ], [ -77.812789, 34.308575 ], [ -77.811828, 34.306958 ], [ -77.81091, 34.305324 ], [ -77.810035, 34.303675 ], [ -77.809203, 34.30201 ], [ -77.808415, 34.30033 ], [ -77.80767, 34.298637 ], [ -77.80697, 34.296931 ], [ -77.806314, 34.295213 ], [ -77.805703, 34.293483 ], [ -77.805137, 34.291743 ], [ -77.804617, 34.289993 ], [ -77.804142, 34.288234 ], [ -77.803714, 34.286468 ], [ -77.803331, 34.284693 ], [ -77.802995, 34.282913 ], [ -77.802705, 34.281126 ], [ -77.802461, 34.279335 ], [ -77.802264, 34.27754 ], [ -77.802114, 34.275742 ], [ -77.802011, 34.273942 ], [ -77.801954, 34.27214 ], [ -77.801945, 34.270338 ], [ -77.801982, 34.268536 ], [ -77.802066, 34.266735 ], [ -77.802197, 34.264936 ], [ -77.802375, 34.263139 ], [ -77.802599, 34.261346 ], [ -77.80287, 34.259558 ], [ -77.803188, 34.257775 ], [ -77.803551, 34.255998 ], [ -77.803961, 34.254228 ], [ -77.804417, 34.252466 ], [ -77.804918, 34.250712 ], [ -77.805465, 34.248968 ], [ -77.806057, 34.247234 ], [ -77.806694, 34.245511 ], [ -77.807375, 34.2438 ], [ -77.808101, 34.242101 ], [ -77.808871, 34.240416 ], [ -77.809684, 34.238745 ], [ -77.810541, 34.237089 ], [ -77.81144, 34.235448 ], [ -77.812382, 34.233824 ], [ -77.813366, 34.232218 ], [ -77.814391, 34.230629 ], [ -77.815457, 34.22906 ], [ -77.816564, 34.227509 ], [ -77.817711, 34.225979 ], [ -77.818897, 34.22447 ], [ -77.820123, 34.222982 ], [ -77.821386, 34.221517 ], [ -77.822687, 34.220075 ], [ -77.824026, 34.218656 ], [ -77.825401, 34.217262 ], [ -77.826811, 34.215892 ], [ -77.828257, 34.214549 ], [ -77.829738, 34.213231 ], [ -77.831252, 34.21194 ], [ -77.8328, 34.210677 ], [ -77.83438, 34.209442 ], [ -77.835991, 34.208235 ], [ -77.837634, 34.207058 ], [ -77.839307, 34.20591 ], [ -77.841009, 34.204793 ], [ -77.84274, 34.203706 ], [ -77.844498, 34.202651 ], [ -77.846284, 34.201627 ], [ -77.848095, 34.200635 ], [ -77.849932, 34.199677 ], [ -77.851793, 34.198751 ], [ -77.853678, 34.197859 ], [ -77.855586, 34.197001 ], [ -77.857516, 34.196178 ], [ -77.859466, 34.195389 ], [ -77.861436, 34.194635 ], [ -77.863426, 34.193917 ], [ -77.865433, 34.193234 ], [ -77.867458, 34.192588 ], [ -77.869499, 34.191978 ], [ -77.871556, 34.191405 ], [ -77.873627, 34.190869 ], [ -77.875711, 34.19037 ], [ -77.877808, 34.189909 ], [ -77.879916, 34.189485 ], [ -77.882035, 34.1891 ], [ -77.884163, 34.188752 ], [ -77.8863, 34.188442 ], [ -77.888444, 34.188171 ], [ -77.890595, 34.187939 ], [ -77.892751, 34.187745 ], [ -77.894912, 34.187589 ], [ -77.897076, 34.187473 ], [ -77.899243, 34.187395 ], [ -77.901412, 34.187356 ] ] ] }, "properties": { "airspace_type": "CAS", "name": "WILMINGTON CLASS D", "cas_class": "D", "floor": 0, "ceiling": 2500, "laanc": true } } ] } ] }
As noted in the API specification, for airspace requests the found element will be a list of GeoJSON FeatureCollections, one for each Airspace type requested. Below shows the entirety of returned results, with the dashed black line indicating the requested route.
Let’s look at each airspace type we requested, and interpret the results.
Special Use Airspace (SUA)
First in our asptypes list was “SUA”. The feature properties given for SUA are:
- name: name of the area
- sua_type: one of
- 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 ceiling 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)
The first is a MOA (Military Operations Area), and you can see that the floor is 3000 FT MSL. If you’re flying below that altitude you can safely ignore it’s presence.
The second is a RA (Restricted Area), and the floor is at the surface. What exactly is a Restricted Area? Read the FAA’s full definition. You are legally allowed to penetrate this airspace (the restrictions apply to ATC issuing clearances through the space), but is it safe? Maybe?
Military Training Routes (MTR)
Next we have several crossing MTR (Military Training Routes). The feature properties given for MTR are:
- name: name of the route
- use_times: textual description of days/times when the MTR is active
- terrain_following: boolean value indicating whether terrain following activity occurs on the route
- max_extent_nm: maximum distance in nautical miles that aircraft can deviate from the route centerline
Military Training Routes need to be taken seriously. Unlike most airspace where manned aircraft are generally operating well above the altitudes where UAVs fly, on MTRs you have military jets skimming the tree tops and operating at speeds that can approach Mach 1. Pay particular attention when you see MTR which have terrain_following = True. In those cases, these aircraft can be down at 200 FT AGL or lower. The probability of your UAV being in the same place at the same time as one of these aircraft may be small, but the consequences would be serious. When in doubt, contact the closest Flight Service Station for more information (1-800-992-7433).
Miscellaneous Activity Areas (MAA)
Third in the asptypes list we have MAA (Miscellaneous Activity Areas). Per the FAA, these are areas which are “published and/or charted to advise pilots of activity that may affect flight operations”. Feature properties given for MAA are:
- name: name of the area
- maa_type: one of the six categories of activity which the FAA charts
- AEROBATIC PRACTICE
- GLIDER
- HANG GLIDER
- PARACHUTE JUMP AREA
- SPACE LAUNCH ACTIVITY
- ULTRALIGHT
- use_times: textual description of the times when area is used for the designated activity (if known)
In all cases, it is up to the organization conducting these activities to report them to the FAA for charting/reporting. As a UAV operator you need to be aware of these areas due to the fact that these activities might occur at same altitudes in which you are flying. You need to be prepared to avoid conflict with any such activity.
If you are lucky, the use_times field will give concrete days/times when activities will take place. In our example however, the operator reporting the area has specified UNKNOWN, meaning parachute jumping might be in progress at any time.
Controlled Airspace (CAS)
Finally, we have CAS (Controlled Airspace). The feature properties given for CAS are:
- name: name of the airspace
- cas_class: B, C, D, or E2
- floor: integer value in FT MSL
- ceiling: integer value in FT MSL
- laanc: boolean value indicating whether or not authorization for this airspace may be obtained via LAANC
We do not return results for Class A airspace (it begins at 18,000 FT MSL and you won’t be up there) or Class E airspace other than type E2 (because you are fine to operate in those other E-type areas without prior authorization). Below shows the Classified Airspace traversed by our route.
Looking back to the overview map, you only see the gray circle for Wilmington Class D. That’s because the Class E2 airspace has the exact same geometry and they’re on top of each other. In both cases we see laanc = True meaning you can make an automated LAANC request for authorization through the service provider of your choice.