Menu

API Documentation

GeoJSON API (V1)

/api/v1/geojson/airspaces

Provides all airspaces. This includes AIP, VLK (airfields and heliports), as well as local agreements. Returns a GeoJSON FeatureCollection. Each airspace is a feature inside the collection and represented by a polygon. Metadata is described in the airspace properties object.

Test it!

/api/v1/geojson/wildlife

Provides all wildlife areas. Returns a GeoJSON FeatureCollection. Each airspace is a feature inside the collection and represented by a polygon. Metadata is described in the wildlife properties object.

Test it!

Example

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "properties": { ... },
            "geometry": {
                "type": "Polygon",
                "coordinates": [ ... ]
            }
        }
    ]
}

Airspace metadata / properties object

The following airspace metadata is available in the properties object:

"properties": { 
    "Name": "TMA Emmen 3 HX",
    "ASClass": "D",
    "ASType": "TMA",
    "HX": true,
    "DABS": false,
    "Dropzone": false,
    "InactiveByAgreement": false,
    "Callsign": "Emmen TWR",
    "Frequency": "120.425",
    "AdditionalInfos": "Sample text...",
    "Validity": [ ... ],
    "Upper": { ... },
    "Lower": { ... }
}
Name
Name of the airspace
ASClass
Airspace class A-G (optional). Usually only provided for relevant airspaces (Class C and D). Class A and B don't exist in Switzerland. Class E-G are usually not designated, since they are not relevant for navigational purpose.
ASType
Airspace type:
CTA: according to ICAO/glider chart
AWY: Airway, according to ICAO/glider chart
CTR: according to ICAO/glider chart
TMA: according to ICAO/glider chart
FIZ: according to ICAO/glider chart
RMZ: Radio Mandatory Zone, according to ICAO/glider chart or local agreements
Q: Danger Area (LS-D) according to ICAO/glider chart
R: Restricted Area (LS-R) according to ICAO/glider chart
W: Glider Sector according to ICAO/glider chart
Airfield: according to VLK or local agreements
Heliport: according to VLK or local agreements
HX
Whether the airspace is HX activated (can be activated any time)
DABS
Whether the airspace is activated by DABS
Dropzone
Whether the airspace/airfield contains a Para/Dropzone.
InactiveByAgreement
Whether the airspace (mostly used for small airfields / heliports) is replaced by some local agreements. In this case, the airspace is just depicted for situational awareness and the boundaries of the local agreement (usually smaller) counts.
Callsign
[optional] Callsign to be used when communicating on the airspace frequency
Frequency
[optional] Associated frequency of the airspace, e.g. to get a clearence
AdditionalInfos
[optional] Description / additional infos for the airspace if available
Validity
[optional] In what date range(s) the airspace is valid/active. E.g. if an airspace is newly added or removed or if it's only valid on certain dates during the year. See Validity object. If the airspace is always valid, the property is omitted.
Upper and Lower altitudes

Wildlife metadata / properties object

The following wildlife metadata is available in the properties object:

"properties": { 
    "Name": "Aescher Ebenalp",
    "ASType": "Wildschutzvereinbarung",
    "AdditionalInfos": "Description...",
    "Validity": [ ... ],
    "Upper": { ... },
    "Lower": { ... }
}
Name
Name of the wildlife area
ASType
Zone type:
Wildschutzvereinbarung: Agreements by SHV and/or clubs
Vogelschutzzone: Voluntary protection zones of eagle nests
AdditionalInfos
[optional] Description / additional infos for the zone if available
Validity
[optional] In what date range(s) the zone is valid/active. E.g. if a zone is newly added or removed or if it's only valid on certain dates during the year. See Validity object. If the zone is always valid, the property is omitted.
Upper and Lower altitudes

Airspace Altitudes

With each airspace (segment), an upper and lower altitude boundary is provided. Since published metric (glider chart) and imperial (ICAO) altitudes are not mathematical meter/feet conversions, we'll provide both numbers in separate fields. If only one of them is availabe, we will provide the original value and will not calculate the other.

"Upper": {
    "Metric": {
        "Alt": { "Type": "m STD", "Altitude": 3950 }
    }
    "Imperial": {
        "Alt": { "Type": "FL", "Altitude": 130 }
    }
},
"Lower": {
    "Metric": {
        "Alt": { "Type": "m QNH", "Altitude": 1850 },
        "Alt2": { "Type": "m AGL", "Altitude": 300 }
    },
    "Imperial": {
        "Alt": { "Type": "ft QNH", "Altitude": 6000 },
        "Alt2": { "Type": "ft AGL", "Altitude": 1000 }
    }
}
Alt
Primary altitude, always given
Alt2
[optional] Secondary altitude, if an airspace boundary is defined by two altitudes like "1850m AMSL or 300m AGL".
Type
Unit of the altitude and wheter it refers to local pressure (QNH) or standard atmosphere. Possible values are:
m QNH: Meters above mean sea level in local pressure (QNH)
m STD: Meters above mean sea level in standard atmosphere
m AGL: Meters above ground ("GND" will be encoded as 0 m AGL)
ft QNH: Feet above mean sea level in local pressure (QNH)
ft STD: Feet above mean sea level in standard atmosphere (usually, these altitudes should be given as FL)
ft AGL: Feet above ground ("GND" will be encoded as 0 ft AGL)
FL: Flight level, always in standard atmosphere
NOTAM: Altitude is only defined by NOTAM. Altitude value will be 0.
Altitude
The altitude value

Airspace Validity

Array of from/to dates, when an airspace is valid/active. The following example shows an airspace that is active until March 24th, from May 1st until May 31st, and then again from October 1st onwards.

[
    { "ValidFrom": null, "ValidTo": "2021-03-24" },
    { "ValidFrom": "2021-05-01", "ValidTo": "2021-05-31" },
    { "ValidFrom": "2021-10-01", "ValidTo": null },
]

See also

Support

If you have any questions about the API, feel free to ask:
Dominik Mauchle.
Also, if you are using the API and want to be informed about updates, let me know.