Surface v2 Hexbin

Sandbox

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

POST

/v2/surface

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

Scope: surface:create

Combine authoritative data provided by Airspace Link with your own GIS data to deliver profile services tailored to your needs. Over 65 datasets that can be used as a feature within the surface engine to aggregate and process vast amounts of data. For a GeoJSON response, use the Surface v2 GeoJSON endpoint.

For more information see the Surface Overview.

Request

Header Params

Body Params application/json

Example

{
    "geometry": {
        "coordinates": [
            [
                [
                    -83.2428932189941,
                    42.2835320469015
                ],
                [
                    -83.2011795043945,
                    42.2835320469015
                ],
                [
                    -83.2011795043945,
                    42.3354533445451
                ],
                [
                    -83.2428932189941,
                    42.3354533445451
                ],
                [
                    -83.2428932189941,
                    42.2835320469015
                ]
            ]
        ],
        "type": "Polygon"
    },
    "layers": [
        {
            "code": "code",
            "where": [
                "AND",
                [
                    [
                        "=",
                        "some_field",
                        100
                    ],
                    [
                        "<=",
                        "another_field",
                        200
                    ]
                ]
            ]
        }
    ],
    "resolution": 10
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://airhub-api-sandbox.airspacelink.com/v2/surface' \
--header 'Authorization: ' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
    "geometry": {
        "coordinates": [
            [
                [
                    -83.2428932189941,
                    42.2835320469015
                ],
                [
                    -83.2011795043945,
                    42.2835320469015
                ],
                [
                    -83.2011795043945,
                    42.3354533445451
                ],
                [
                    -83.2428932189941,
                    42.3354533445451
                ],
                [
                    -83.2428932189941,
                    42.2835320469015
                ]
            ]
        ],
        "type": "Polygon"
    },
    "layers": [
        {
            "code": "code",
            "where": [
                "AND",
                [
                    [
                        "=",
                        "some_field",
                        100
                    ],
                    [
                        "<=",
                        "another_field",
                        200
                    ]
                ]
            ]
        }
    ],
    "resolution": 10
}'

Responses

🟢200Successful response

application/json

Body

Example

{
    "data": [
        {
            "hexes": [
                "872ab2554ffffff",
                "872ab2550ffffff"
            ],
            "props": {
                "type": "code"
            }
        }
    ],
    "message": "success",
    "statusCode": 200
}

🟠400Your request was invalid JSON or is using invalid types

🟠408Your request timed out; try reducing the size of the request

🟠422Part of your request had invalid values

🔴500Internal error reaching data

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

Surface v2 GeoJSON

Route v2