Classification Surface

Sandbox

https://airhub-api-sandbox.airspacelink.com

POST

/v2/classify

Last modified:2025-07-15 16:22:45

Scope: surface:create

The HexGen™ Surface API is a powerful geospatial aggregation and modeling engine that efficiently processes and combines multiple datasets to generate custom-tailored insights. This API enables users to integrate authoritative data provided by Airspace Link with their own GIS data, creating comprehensive and data-driven solutions. The API simplifies the process of combining and processing large amounts of data, transforming complexity into actionable insights.

For more information see the Surface Overview.

Request

Header Params

Body Params application/json

Example

{
    "geometry": {
        "coordinates": [
            [
                [
                    -83.281174,
                    42.258
                ],
                [
                    -83.281174,
                    42.3121
                ],
                [
                    -83.218689,
                    42.3121
                ],
                [
                    -83.218689,
                    42.258
                ],
                [
                    -83.281174,
                    42.258
                ]
            ]
        ],
        "type": "Polygon"
    },
    "layers": [
        {
            "code": "uasfm_ceiling",
            "risk": 1
        }
    ],
    "resolution": 9
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://airhub-api-sandbox.airspacelink.com/v2/classify' \
--header 'Authorization: ' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
    "geometry": {
        "coordinates": [
            [
                [
                    -83.281174,
                    42.258
                ],
                [
                    -83.281174,
                    42.3121
                ],
                [
                    -83.218689,
                    42.3121
                ],
                [
                    -83.218689,
                    42.258
                ],
                [
                    -83.281174,
                    42.258
                ]
            ]
        ],
        "type": "Polygon"
    },
    "layers": [
        {
            "code": "uasfm_ceiling",
            "risk": 1
        }
    ],
    "resolution": 9
}'

Responses

🟢200Happy path desc

application/json

Body

Example

{
    "data": {
        "bitmaskMap": {
            "uasfm_ceiling": {
                "bitmask": 1,
                "risk": 1
            }
        },
        "hexes": [
            {
                "bitmask": 1,
                "index": "892ab2cd8d7ffff",
                "risk": 1
            }
        ]
    },
    "message": "success",
    "statusCode": 200
}

🔴500Internal error

Modified at 2025-07-15 16:22:45

Suitability

Surface v2 GeoJSON