Area reports are useful for summarising the severity and nature of the hazards within a given geography.

Request

GET https://api.altitudeangel.com/v2/preflight/areareports?n=*north*&e=*east*&s=*south*&w=*west*

This endpoint will return data for the area specified by a bounding box.

Querystring parameter	Description
n	The north coordinate of the bounding box in degrees
e	The east coordinate of the bounding box in degrees
s	The south coordinate of the bounding box in degrees
w	The west coordinate of the bounding box in degrees

The area of the bounding box must be less than the maximum of 10,000,000,000m² (100 km x 100 km)

The response consists of a summary with an overall hazard factor along with a breakdown by feature category, along with an array of the map features that were included in the analysis.

These features can be cross referenced against the map data via their id which is consistent with the map data downloaded from the Map Data endpoint.

In the example below, we return an overall summary indicating a hazardFactor of 60, which is translated into an English string hazardFactorName of Danger.

To build conditional logic within your apps that are dependent on the output of this call, we do not recommend you bind to the string fields, instead using the hazardFactor numeric values as we may change the definitions/string values that correspond to the integer values at any time.

Sample Request

GET https://api.altitudeangel.com/v2/preflight/areareports?n=52.30344944512444&e=4.802795172119141&s=52.285916419748276&w=4.75987982788086
Authorization: X-AA-ApiKey YOUR_API_KEY

Sample Area Report

{
    "summary": {
      "overall": {
        "hazardFactorName": "Danger",
        "hazardFactor": 60
      },
      "categories": {
        "groundHazard": {
          "hazardFactorName": "Warning",
          "hazardFactor": 40
        },
        "risk": {
          "hazardFactorName": "Warning",
          "hazardFactor": 40
        },
        "airspace": {
          "hazardFactorName": "Danger",
          "hazardFactor": 60
        },
        "flightReport": {
          "hazardFactorName": "Information",
          "hazardFactor": 20
        }
      }
    },
    "features": [
      {
        "id": "73A18AC20DABDAEC46108A65D5C2BBE696FDF4F7",
        "name": "RAF Benson",
        "category": "groundHazard",
        "detailedCategory": "aeroway:aerodrome",
        "hazardFactorName": "Warning",
        "hazardFactor": 40
      },      
      {
        "id": "935A7411ADBEBA1CFD266B68E01FA40BC824942A",
        "name": "Crowmarsh Gifford Primary School",
        "category": "groundHazard",
        "detailedCategory": "amenity:school",
        "hazardFactorName": "Warning",
        "hazardFactor": 40
      },
      // Other results truncated for clarity ... 
      {
        "id": "02d98bba-794d-4be6-bc0d-1a0f1f9c772e",
        "name": "Chimney inspection",
        "category": "flightReport",
        "detailedCategory": "user:flight_report",
        "hazardFactorName": "Information",
        "hazardFactor": 20
      }
    ]
}