API Documentation

API access is in the general form

https://airspace.bgaladder.net/API/Get<type>/<BaseLatitude>/<BaseLongitude>/<TopLatitude>/<TopLongitude>

where
  • type is Airspace, LoA or RAT
  • BaseLatitude, BaseLongitude, TopLatitude and TopLongitude are numbers defining the Bounding Box of interest. Any airspace definitions intersecting this bounding box will be returned. If not specified, these default to a box covering the UK

Vertical limits are specified as strings, in one of the forms:

  • SFC - the surface
  • nnnn ft - an Altitude in feet
  • FLnnn - a Flight level

All requests must be HTTP GET accompanied by an Authorization header in the form Authorization: Bearer <token>

A suitable token can be obtained from this site once logged in, or by direct API call. See below for details

Airspace

https://airspace.bgaladder.net/API/GetAirspace/<BaseLatitude>/<BaseLongitude>/<TopLatitude>/<TopLongitude>
Returns an array of Airspace definition objects.
  • name: Name of Airspace
  • type: Type of Airspace
  • class: Class of Airspace
  • id: an optional id used to manage the LoA process
  • rules: Any specific rules that might apply
  • localtype: The local type of airspace - e.g. MATZ
  • controltype: the control type of the airspace
  • lower: The lower limit
  • upper: the upper limit
  • geojSON: a geoJSON Feature definition of the lateral boundaries. The properties above are included as properties of the Feature

Letters of Agreement

https://airspace.bgaladder.net/API/GetLoA/<BaseLatitude>/<BaseLongitude>/<TopLatitude>/<TopLongitude>

Based on the British Gliding Association's Letters of Agreement with various authorities, these define special use airspace accessible under defined circumstances.

There are two sets of data available: the 'additional' blocks of airspace, and the 'replaced' blocks of airspace

  • 'Additional' airspace is that which would not normally be available but can be used under the terms of the LoA
  • 'Replaced' airspace is that defined in the main Airspace list that is replaced by the LoA-defined airspace

Returns an object defining Letter of Agreement airspace

The object has properties 'add' and 'replace', each containing an array of LoA definitions

  • areaname: Name of the Letter of Agreement Area
  • name: Specific name within the Area
  • type: Type of Airspace
  • class: Class of Airspace
  • rules: Any specific rules that might apply
  • lower: The lower limit
  • upper: the upper limit
  • geojSON: a geoJSON Feature definition of the lateral boundaries. The properties above are included as properties of the Feature

For 'replace' items, there is an additional property 'replaceid'. This provides the id of the element in the Airspace defintion list which is replaced by this block

Restricted Area Temporary - RA(T)s

https://airspace.bgaladder.net/API/GetRAT/<BaseLatitude>/<BaseLongitude>/<TopLatitude>/<TopLongitude>

From Mauve AICs. See ASSelect for details

For these, the data comprises:

  • name: the name of the RA(T)
  • type: the Type of RAT
  • localtype: the 'local type' of the airspace - usually 'RAT'
  • lower: The lower limit
  • upper: the upper limit
  • geojSON: a geoJSON Feature definition of the lateral boundaries.

Get Access Token

https://airspace.bgaladder.net/Auth/Token?<username>&<password>

Generate an access token to use for other API calls. A valid Username and Password must be supplied; however for this call the Authorization header is not required.

Returns a 'token' object containing the token value