AirHub API
  1. Surface
AirHub API
  • Introduction
  • Authorization
    • Overview
    • Get Oauth Token
      POST
  • Advisories
    • Advisory
      POST
    • Get Advisories BBox
      GET
    • Get Advisories GeoJSON
      POST
  • Briefing
    • Overview
    • B4UFLY
      • What Is B4UFLY
      • The API Basics
      • Location vs Area
      • v1
        • B4UFLY Briefing by Area v1
        • B4UFLY Briefing by Location v1
      • v2
        • What's New in v2
        • B4UFLY Briefing by Area v2
        • B4UFLY Briefing by Location v2
  • LAANC SDSP
    • Overview
    • ASL Operations
      • List Operations
      • Create Operation
      • Get Operation
      • Delete Operation
      • Update Operation
    • LAANC Operations
      • Get Operation
      • Delete Operation
      • Create Operation
      • Update Operation
    • LAANC Authorizations
      • Rescinded and Invalid Operations
      • Submit Authorization
      • Get Authorization
      • Cancel Authorization
      • Cancel Invalid Authorization
      • Close Authorization
      • Acknowledge Rescinded Authorization
    • Operation v2
      POST
    • Create Ephemeral Operations
      POST
  • Risk
    • Get Hazard
      POST
    • Get Hazard Ground Type
      POST
    • Get Hazard Ground Risk
      POST
  • Aviation
    • Aviation
      POST
  • Surface
    • Overview
    • Suitability
      POST
    • Classification Surface
      POST
    • Surface v2 GeoJSON
      POST
    • Surface v2 Hexbin
      POST
  • Route
    • Route v2
  • Check
    • Check Airspace
    • Get Status
  • Elevation - NEW
    • Get List
  • Map Vector Tiles - NEW
    • Overview
    • Styled Tiles
    • Vector Tile
  • Flight
    • Get Flight Last Position QUERY
    • Get Flight Last Position INFO
  • Data Notification Subscribers
    • Get List
  1. Surface

Suitability

Deprecated
Sandbox
https://airhub-api-sandbox.airspacelink.com
Sandbox
https://airhub-api-sandbox.airspacelink.com
POST
/v1/suitability
Last modified:2024-05-17 17:25:38
Scope: surface:create
DEPRECATED - use Classification Surface instead.
Generates a risk suitability surface with any data sources you request. Suitability surfaces are similar to computing risk, but allow you to model risk classification that are consistent with your concept of operations.

Request

Header Params

Body Params application/json

Example
{
    "uavWeight": "MICRO",
    "uavType": "FIXED_WING",
    "pilotControl": "SINGLE_PILOT",
    "losType": "VLOS",
    "maxAltitude": 100,
    "resolution": 10,
    "noFill": true,
    "features": {
        "police_stations": {
            "weight": 100
        }
    },
    "geometry": {
        "type": "Polygon",
        "coordinates": [
            [
                [
                    -83.2428932189941,
                    42.2835320469015
                ],
                [
                    -83.2011795043945,
                    42.2835320469015
                ],
                [
                    -83.2011795043945,
                    42.3354533445451
                ],
                [
                    -83.2428932189941,
                    42.3354533445451
                ],
                [
                    -83.2428932189941,
                    42.2835320469015
                ]
            ]
        ]
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://airhub-api-sandbox.airspacelink.com/v1/suitability' \
--header 'Authorization: ' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
    "uavWeight": "MICRO",
    "uavType": "FIXED_WING",
    "pilotControl": "SINGLE_PILOT",
    "losType": "VLOS",
    "maxAltitude": 100,
    "resolution": 10,
    "noFill": true,
    "features": {
        "police_stations": {
            "weight": 100
        }
    },
    "geometry": {
        "type": "Polygon",
        "coordinates": [
            [
                [
                    -83.2428932189941,
                    42.2835320469015
                ],
                [
                    -83.2011795043945,
                    42.2835320469015
                ],
                [
                    -83.2011795043945,
                    42.3354533445451
                ],
                [
                    -83.2428932189941,
                    42.3354533445451
                ],
                [
                    -83.2428932189941,
                    42.2835320469015
                ]
            ]
        ]
    }
}'

Responses

🟢200Success
application/json
Body

Example
{
    "statusCode": 200,
    "message": "success",
    "data": {
        "features": [
            {
                "type": "Feature",
                "geometry": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                -83.2290423803194,
                                42.3237818364034
                            ],
                            [
                                -83.2299442668952,
                                42.3235550600582
                            ],
                            [
                                -83.2301025552757,
                                42.3228889819488
                            ],
                            [
                                -83.2293589804454,
                                42.3224496833283
                            ],
                            [
                                -83.2284571118341,
                                42.3226764515939
                            ],
                            [
                                -83.2282988000888,
                                42.3233425265594
                            ],
                            [
                                -83.2290423803194,
                                42.3237818364034
                            ]
                        ]
                    ]
                },
                "properties": {
                    "density": "Suburban",
                    "infrastructureTypes": [],
                    "popPerSqMi": 1032.72537252511,
                    "score": 2,
                    "suitableFeatures": []
                }
            }
        ],
        "type": "FeatureCollection"
    }
}
🔴500500
Modified at 2024-05-17 17:25:38
Previous
Overview
Next
Classification Surface
Built with