Get Advisories GeoJSON

Scope: advisory:read

Advisories represent geographic areas where special consideration must be made before operating drones. Examples of advisories may range from restricted airspace, where it's illegal to operate a drone, to warnings where it's important for you to understand the context of where you're flying to maximize safety.

Find advisories that intersect the input geometry as described by a GeoJSON geometry. May be a point, line, or polygon.

Request

Header Params

Body Params application/json

Example

{
    "geometry": {
        "type": "Point",
        "coordinates": [
            -84.695,
            44.695
        ]
    },
    "geoIDs": [
        "1300021",
        "13"
    ],
    "altitudeUpper": 500,
    "altitudeLower": -100,
    "startTime": "2022-06-01T23:39:00Z",
    "endTime": "2022-06-30T23:39:00Z"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200200 Response

application/json

Body

Example

{
    "statusCode": 200,
    "message": "success",
    "data": {
        "type": "FeatureCollection",
        "features": [
            {
                "type": "Feature",
                "geometry": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                -84.69289659570808,
                                44.68428721296152
                            ],
                            [
                                -84.69476557152252,
                                44.69483277365174
                            ],
                            [
                                -84.67317443855015,
                                44.70036706219832
                            ],
                            [
                                -84.67203280238344,
                                44.67752066765469
                            ],
                            [
                                -84.686540954764,
                                44.67911058319509
                            ],
                            [
                                -84.69289659570808,
                                44.68428721296152
                            ]
                        ]
                    ]
                },
                "properties": {
                    "advisoryCategory": "admin",
                    "altitudeLower": 0,
                    "altitudeUpper": 400,
                    "contactEmail": "example@email.com",
                    "contactFirstName": "Example",
                    "contactLastName": "User",
                    "contactPhone": "+3135551234",
                    "countryGeoID": "1000",
                    "description": "Example Advisory to communicate events, conditions, activities relevant to UAS operations or planning",
                    "endTime": "2024-02-23T16:12:00Z",
                    "geoID": "26",
                    "id": "311343de-7526-444e-9cc5-bdc9d785bae3",
                    "lastEditDate": "2024-02-22T15:59:07.097661Z",
                    "name": "UAS Operation Coordination",
                    "published": true,
                    "referenceNumber": null,
                    "startTime": "2024-02-22T16:12:00Z",
                    "tags": [],
                    "timezoneName": "America/New_York",
                    "url": null
                }
            },
            {
                "type": "Feature",
                "geometry": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                -84.66588398881683,
                                44.71657210650567
                            ],
                            [
                                -84.60743044011728,
                                44.716572106505666
                            ],
                            [
                                -84.60743044011728,
                                44.683243709601655
                            ],
                            [
                                -84.66588398881683,
                                44.68324370960165
                            ],
                            [
                                -84.66588398881683,
                                44.71657210650567
                            ]
                        ]
                    ]
                },
                "properties": {
                    "advisoryCategory": "admin",
                    "altitudeLower": 0,
                    "altitudeUpper": 400,
                    "contactEmail": "example@email.com",
                    "contactFirstName": "Example",
                    "contactLastName": "User",
                    "contactPhone": "+13135551234",
                    "countryGeoID": "1000",
                    "description": "Example live fire exercise",
                    "endTime": "2024-03-06T19:57:00Z",
                    "geoID": "26",
                    "id": "73c9ddff-366b-4372-b4c2-daaea5a90199",
                    "lastEditDate": "2024-03-05T19:43:51.178522Z",
                    "name": "Demonstration Activities",
                    "published": true,
                    "referenceNumber": null,
                    "startTime": "2024-03-05T19:57:00Z",
                    "tags": [],
                    "timezoneName": "America/New_York",
                    "url": null
                }
            }
        ]
    }
}

🔴500500 Response