Using the DFlight API UAS Operating Area Endpoints

Background

UAS Operating Areas (UOAs) are communicated via NOTAM to provide awareness of UAS operations being conducted under an FAA issued Certificate of Waiver or Authorization (COA). These activities include flights which might normally be prohibited under Part 107 regulations, so without the prior awareness provided by these NOTAMs other operators would not expect to encounter them. Note that only COA holders are required to report UOAs. These are generally law enforcement organizations, fire departments, search and rescue units, schools, universities, and research institutions. 

UOAs can define either a single operation or a recurring operation over a period of days or months.

The UOA request body

Request bodies for /uoa endpoints are “basic”,  meaning the only information you need to provide are those parameters that define your area of interest (point/distance, route, or poly).

The UOA response body

As with all request types (except airspace), the response body is a json object containing a single element named found. The contents of found will be a GeoJSON FeatureCollection with one Feature per UOA found in your requested area of interest. The feature properties given for each UOA are:

  • startDateTime: beginning of scheduled activity
  • endDateTime: end of scheduled activity
  • text: a textual description of the area, affected altitudes, and schedule (for recurring operations)

When a COA holder submits a UOA NOTAM they have three options for defining the area:

  • circular area (center point + radius)
  • non-circular area: boundary defined by a series of points
  • line: a line defined by multiple points and a width

Regardless of how the submitter defines the area, /uoa endpoints will always return geometry of type Polygon as shown in this distance request (sent via POST request to https://dflight-api.ljaero.com/us/v1/uoa/distance-query). The dashed grey circle shows our requested area.

{
  "longitude": -98.095, 
  "latitude": 28.021, 
  "distance": 25000
}
Response JSON
{
  "found": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -97.956111,
                27.965833
              ],
              [
                -97.708889,
                27.964167
              ],
              [
                -97.676389,
                27.577778
              ],
              [
                -98.358889,
                27.586667
              ],
              [
                -98.354444,
                27.803333
              ],
              [
                -97.956944,
                27.820278
              ],
              [
                -97.956111,
                27.965833
              ]
            ]
          ]
        },
        "properties": {
          "startDateTime": "2022-12-01T00:00:00.000Z",
          "endDateTime": "2022-12-31T23:59:00.000Z",
          "text": "AIRSPACE UAS WI AN AREA DEFINED AS 275757N0975722W (11.4NM NW 67T) TO 275751N0974232W (9.9NM WSW T69) TO 273440N0974035W (4.5NM ESE 07R) TO 273512N0982132W (17.6NM W IKG) TO 274812N0982116W (14.0NM ESE T19) TO 274913N0975725W (5.8NM W 67T) TO POINT OF ORIGIN SFC-400FT AGL DLY 0000-2359"
        }
      },
      {
        "type": "Feature",
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -97.940736,
                27.98076
              ],
              [
                -97.954585,
                27.981545
              ],
              [
                -97.96828,
                27.983525
              ],
              [
                -97.98169,
                27.986681
              ],
              [
                -97.994684,
                27.990983
              ],
              [
                -98.007139,
                27.996388
              ],
              [
                -98.018933,
                28.002844
              ],
              [
                -98.029955,
                28.01029
              ],
              [
                -98.040096,
                28.018653
              ],
              [
                -98.04926,
                28.027853
              ],
              [
                -98.057359,
                28.0378
              ],
              [
                -98.064313,
                28.048399
              ],
              [
                -98.070058,
                28.059548
              ],
              [
                -98.074536,
                28.071139
              ],
              [
                -98.077705,
                28.083059
              ],
              [
                -98.079535,
                28.095196
              ],
              [
                -98.080008,
                28.10743
              ],
              [
                -98.079119,
                28.119645
              ],
              [
                -98.076876,
                28.131723
              ],
              [
                -98.073303,
                28.143548
              ],
              [
                -98.068432,
                28.155006
              ],
              [
                -98.06231,
                28.165986
              ],
              [
                -98.054998,
                28.176384
              ],
              [
                -98.046564,
                28.186098
              ],
              [
                -98.037091,
                28.195037
              ],
              [
                -98.02667,
                28.203113
              ],
              [
                -98.0154,
                28.21025
              ],
              [
                -98.003391,
                28.216378
              ],
              [
                -97.990758,
                28.22144
              ],
              [
                -97.977623,
                28.225386
              ],
              [
                -97.964112,
                28.228178
              ],
              [
                -97.950356,
                28.229791
              ],
              [
                -97.936486,
                28.230207
              ],
              [
                -97.286764,
                28.221605
              ],
              [
                -97.272915,
                28.220822
              ],
              [
                -97.25922,
                28.218846
              ],
              [
                -97.24581,
                28.215697
              ],
              [
                -97.232816,
                28.211404
              ],
              [
                -97.220361,
                28.20601
              ],
              [
                -97.208567,
                28.199566
              ],
              [
                -97.197545,
                28.192133
              ],
              [
                -97.187404,
                28.183783
              ],
              [
                -97.17824,
                28.174597
              ],
              [
                -97.170141,
                28.164662
              ],
              [
                -97.163187,
                28.154075
              ],
              [
                -97.157442,
                28.142936
              ],
              [
                -97.152964,
                28.131353
              ],
              [
                -97.149795,
                28.119438
              ],
              [
                -97.147965,
                28.107304
              ],
              [
                -97.147492,
                28.09507
              ],
              [
                -97.148381,
                28.082852
              ],
              [
                -97.150624,
                28.070768
              ],
              [
                -97.154197,
                28.058935
              ],
              [
                -97.159068,
                28.047468
              ],
              [
                -97.16519,
                28.036475
              ],
              [
                -97.172502,
                28.026064
              ],
              [
                -97.180936,
                28.016335
              ],
              [
                -97.190409,
                28.007381
              ],
              [
                -97.20083,
                27.99929
              ],
              [
                -97.2121,
                27.99214
              ],
              [
                -97.224109,
                27.985998
              ],
              [
                -97.236742,
                27.980925
              ],
              [
                -97.249877,
                27.97697
              ],
              [
                -97.263388,
                27.974171
              ],
              [
                -97.277144,
                27.972555
              ],
              [
                -97.291014,
                27.972138
              ],
              [
                -97.940736,
                27.98076
              ]
            ]
          ]
        },
        "properties": {
          "startDateTime": "2022-12-01T00:00:00.000Z",
          "endDateTime": "2022-12-31T23:59:00.000Z",
          "text": "AIRSPACE UAS WI AN AREA DEFINED AS 8.5NM EITHER SIDE OF A LINE FM 280549N0971720W (11.7NM NNW TFP) TO 280620N0975619W (17.3NM SSW BEA) SFC-400FT AGL DLY 0000-2359"
        }
      },
      {
        "type": "Feature",
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -98.164247,
                27.880667
              ],
              [
                -98.166249,
                27.844626
              ],
              [
                -98.172238,
                27.80892
              ],
              [
                -98.182156,
                27.773893
              ],
              [
                -98.195907,
                27.739885
              ],
              [
                -98.213358,
                27.707223
              ],
              [
                -98.234342,
                27.676224
              ],
              [
                -98.258656,
                27.647187
              ],
              [
                -98.286067,
                27.620394
              ],
              [
                -98.31631,
                27.596104
              ],
              [
                -98.349094,
                27.574554
              ],
              [
                -98.384103,
                27.555952
              ],
              [
                -98.421001,
                27.540479
              ],
              [
                -98.459431,
                27.528286
              ],
              [
                -98.499025,
                27.519491
              ],
              [
                -98.539399,
                27.514179
              ],
              [
                -98.580167,
                27.512403
              ],
              [
                -98.620934,
                27.514179
              ],
              [
                -98.661309,
                27.519491
              ],
              [
                -98.700902,
                27.528286
              ],
              [
                -98.739332,
                27.540479
              ],
              [
                -98.77623,
                27.555952
              ],
              [
                -98.811239,
                27.574554
              ],
              [
                -98.844024,
                27.596104
              ],
              [
                -98.874267,
                27.620394
              ],
              [
                -98.901677,
                27.647187
              ],
              [
                -98.925991,
                27.676224
              ],
              [
                -98.946975,
                27.707223
              ],
              [
                -98.964427,
                27.739885
              ],
              [
                -98.978177,
                27.773893
              ],
              [
                -98.988095,
                27.80892
              ],
              [
                -98.994084,
                27.844626
              ],
              [
                -98.996087,
                27.880667
              ],
              [
                -98.994084,
                27.916696
              ],
              [
                -98.988095,
                27.952366
              ],
              [
                -98.978177,
                27.987335
              ],
              [
                -98.964427,
                28.021265
              ],
              [
                -98.946975,
                28.053833
              ],
              [
                -98.925991,
                28.084724
              ],
              [
                -98.901677,
                28.113644
              ],
              [
                -98.874267,
                28.140316
              ],
              [
                -98.844024,
                28.164484
              ],
              [
                -98.811239,
                28.185917
              ],
              [
                -98.77623,
                28.204411
              ],
              [
                -98.739332,
                28.219789
              ],
              [
                -98.700902,
                28.231905
              ],
              [
                -98.661309,
                28.240642
              ],
              [
                -98.620934,
                28.245918
              ],
              [
                -98.580167,
                28.247682
              ],
              [
                -98.539399,
                28.245918
              ],
              [
                -98.499025,
                28.240642
              ],
              [
                -98.459431,
                28.231905
              ],
              [
                -98.421001,
                28.219789
              ],
              [
                -98.384103,
                28.204411
              ],
              [
                -98.349094,
                28.185917
              ],
              [
                -98.31631,
                28.164484
              ],
              [
                -98.286067,
                28.140316
              ],
              [
                -98.258656,
                28.113644
              ],
              [
                -98.234342,
                28.084724
              ],
              [
                -98.213358,
                28.053833
              ],
              [
                -98.195907,
                28.021265
              ],
              [
                -98.182156,
                27.987335
              ],
              [
                -98.172238,
                27.952366
              ],
              [
                -98.166249,
                27.916696
              ],
              [
                -98.164247,
                27.880667
              ]
            ]
          ]
        },
        "properties": {
          "startDateTime": "2022-12-03T00:00:00.000Z",
          "endDateTime": "2023-01-01T23:59:00.000Z",
          "text": "AIRSPACE UAS WI AN AREA DEFINED AS 25NM RADIUS OF 275250.40N0983448.60W (1.2NM ESE T19) SFC-400FT AGL DLY 0000-2359"
        }
      }
    ]
  }
}