Computed SkyPath Turbulence data for corridor
POST/observations/v5/corridor
Use this to fetch SkyPath computed turbulence data for a specific time span, range of altitudes and calculated for a specific aircraft type. Using this operation you can limit the query to a Geo fence corridor. (Supports now only GeoJson fragments: Polygon). For performance and network optimization it is restricted to maximum 250 vertices and 7500 square kilometers, the polygon should be convex.
Request
- application/json
Body
required
corridor
object
required
Possible values: [Polygon
]
Timestamp (unix time) to retrieve only the data that has changed since this time.
Possible values: [0.5
, 1
, 2
, 4
]
Default value: 2
Number of hours ago to retrieve data for
Default value: C60
Aircraft category
Possible values: >= 5
and <= 52
Default value: 5
The minimum altitude in thousands of feet. (5-52)
Possible values: >= 5
and <= 52
Default value: 52
Maximum altitude in thousands of feet. (5-52)
Responses
- 200
- 400
- 401
Response for get map data
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
data
object
Corridor data
Unix timestamp of the last update
hexagons
object[]
required
array of hexagons with calculated turbulence data
H3 hexagon id in zoom 5
Altitude level
SkyPath severity level
Timestamp in Linux epoch when this hexagon was last observed
Additional data
Links
Warnings
{
"data": {
"lastUpdatedAt": 1732704917,
"hexagons": [
{
"id": "8a283082a677fff",
"alt": 38,
"sev": 2,
"observedAt": 1659530580
}
]
},
"meta": {},
"links": {},
"warnings": {}
}
Error: Bad Request
- application/json
- Schema
- Example (from schema)
Schema
data
object
required
Error details
HTTP status code
Error code
Error message
Error details
Additional error details
Error links
Additional error warnings
{
"data": {
"statusCode": 400,
"code": "FST_ERR_VALIDATION",
"error": "Bad Request",
"message": "body must have required property 'corridor'"
},
"meta": {},
"links": {},
"warnings": {}
}
Operation is not authorized or wrong API KEY
- application/json
- Schema
- Example (from schema)
Schema
data
object
required
Error details
HTTP status code
Error code
Error message
Error details
Additional error details
Error links
Additional error warnings
{
"data": {
"statusCode": 401,
"code": 401001,
"error": "Unauthorized",
"message": "The method requires authentication but it was not presented or is invalid."
},
"meta": {},
"links": {},
"warnings": {}
}