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

Overview

Types#

Surface generation is the foundation of all the advanced features of the Airspace Link API. It has its own
set of types and lexicon that assist in making the queries intuitive and powerful.

Layer Object#

The layer object represents the building block for requesting surface information. At a minimum, provide a code and
that data source will be fetched. You can access attributes using the JSON key fields, and you can
provide a filter using the JSON key where.
ParameterTypeDescription
codestringA metadata source.
fieldsstring[]The fields of the metadata source you'd like to return. Setting "fields": ["*"] will return all valid fields for supported data types.
where<where>A pseudo-SQL expression tree. Click here for information on how to generate one.
riskfloat64An optional risk value to assign to the layer. Only relevant when requesting risk surfaces.

SQL Expression Tree#

Backus-Naur Form
Simple comparisons
Logical operators
Several API endpoints require generating surfaces, and all surface generation supports advanced querying.
You can provide a filter via a tree data structure for each resource you request that will be parsed out
and produce a filter that suits your use case.
Logical operators
OperatorArityDescription
ANDBinary or greaterA standard logical AND. All the arguments provided to the AND will be nested.
ORBinary or greaterA standard logical OR. All the arguments provided to the OR will be nested.
Comparison operators
OperatorArityDescription
=Binary= does an equality check on the field and the passed value. Type coercion may be performed if the types are different.
>Binary> checks the field is greater than the passed value. Type coercion may be performed if the types are different.
<Binary< checks the field is less than the passed value. Type coercion may be performed if the types are different.
<=Binary<= checks the field is less than or equal to the passed value. Type coercion may be performed if the types are different.
>=Binary>= checks the field is greater than or equal to the passed value. Type coercion may be performed if the types are different.
!=Binary!= checks the field is not equal to the passed value. Type coercion may be performed if the types are different.
Modified at 2025-07-15 16:21:36
Previous
Aviation
Next
Suitability
Built with