Area Reports
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,000m2 (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
}
]
}
Updated almost 3 years ago