1. Home
  2. Docs
  3. Airports
  4. Data models
  5. Airport

Airport

Airports are root objects, meaning it does not have a parent object.

AIDs identifying airports have APT as their namespace.

An airport identifies any landing site, regardless of the form, usage or amount of traffic. For example, a heliport next to a hospital will be identified as an airport.

Separate landing surfaces within the same establishment, for example, different runways or helipads within the same airport, are identified as runways, not as separate airports.

Below is a description of all properties of the Airport object:

PropertyTypeDescription
aidstringA string with the AID of the airport, with APT as namespace
icaostring, nullA string with the 4-letters ICAO code of the airport, ornull if none is assigned
iatastring, nullA string with the 3-letters IATA code of the airport, or null if none is assigned.
faastring, nullA string with the FAA code, or null if none is assigned.
coordinatesobject, nullA Coordinates object which represents the location of the Aerodrome Reference Point.
This is null when the information is not known.
elevationnumber, nullA decimal number representing the elevation of the airport expressed in meters. Two decimal positions are provided, for precise conversion to feet.

This is null when the information is not known.
variationnumber, nullA decimal number representing the magnetic variation at the airport. This is expressed in degrees, with two decimal positions. Positive for East variation and Negative for West variation.
This is null when the information is not known.
countryobjectA Country object which represents the country at which an airport is located.
timeZonestring, nullThe timezone of the airfield as noted in the IANA Time Zone Database.
null indicates that this information is not available.
namestringThe name of the airport. This should be the official name of the airport written in Latin characters.
servedCitystring, nullA string containing the name of the city served by the airport. In some countries, like the USA, this includes the state. For example: Los Angeles, CA.

This is null when the information is not known.
typestring, nullA string that sescribes the type of airport. Possible values are:
null the information is not known.
AIRPORT a defined area, often certified by a local authority, with infrastructure to support commercial operations, and at least one runway in service.
HELIPORT a location uniquely designated to the operation of helicopters or other VTOL aircraft.
AIRSTRIP an area prepared for the operation of aircraft. This differs from AIRPORT in that the quality of the landing surface and surrounding infrastructure may not be guaranteed, surveyed or certified by a suitable authority.
WATER a site used by aircraft on floats. This may be defined by buoys or other markings, or not.
operatorstring, nullA string that identifies the type of operator that runs the airport. Possible values are:
null the information is not known.
PUBLIC an airport that is operated by a governmental body or by a private or public company on behalf of a governmental body, in the public interest (i.e. London Heathrow).
PRIVATE an airport that is operated by an individual or a company, for revenue or not, where there is no involvement of public bodies in the decision making.
MILITARY an airport that is operated by a military or paramilitary entities, such as Air Force, Army, Coast Guard, State Police, etc. Access to such airport may be granted under rules set by the operating entity.
JOINT an airport that is at least in part operated by a military or paramilitary body. The aerodrome may have a dedicated military side, or military interests in other forms, like training grounds.
accessibleForlist, nullA list of strings that identifies what type of traffic has access to the airport.

This is null when the information is not known.

Each element of the list is a string of possible value:
SCHEDULED Civil flights of a scheduled nature. Usually notified to Air Traffic Control with ICAO flightplan of type S
NON_SCHEDULED Civil flights of non-scheduled commercial nature. Usually notified to Air Traffic Control with an ICAO flightplan of type N.
GENERAL_AVIATION Civil flights of a private nature. Usually notified to Air Traffic Control with an ICAO flightplan of type G.
TRAINING Civil flights performed for training.
BUSINESS_AVIATION Civil flights of a private or commercial nature. These are usually operated with aircraft of any type or size, but generally in configurations of less than 19 passengers.
MILITARY Any type of military traffic.
HELICOPTER Any type of flight operated by a VTOL aircraft.
ifrboolean, nullIndicates if the airport is capable and authorised to accept flights operating under Instrument Flight Rules.

true if IFR flights are accepted, false otherwise.

null if the information is not known.
mandatoryHandlingboolean, nullIndicates if local regulations mandate that visiting aircraft utilise a ground handling company.

true if the use of a ground handling company is mandated, false otherwise.

null if the information is not known.
mandatoryQualificationboolean, nullIndicates if local regulations mandate that pilots are qualified before operating at the airport.

true if pilots require a qualification, false otherwise.

null if the information is not known.

When this property is true, the properties qualificationLink and qualificationNotes may contain additional information.
qualificationLinkstring, nullA URL which points to a page explaining the process for pilots to obtain the qualification required to operate at the airport.

null indicate that this information was not added.
qualificationNotesstring, nullFree-text notes about the mandatory qualification that must be obtained before operating at the airport.

null if this information was not added.
nonScheduledPermissionstring, nullIndicates what kind of permission is required for non-scheduled flights (of either a private or commercial nature) to operate on the airport.
Possible values are:
NONE if no permission is required
UNAVAILABLE if the airfield is not available for non-scheduled traffic.
PPR if permission is required, and once obtained it does not restrict the aircraft to operate at a certain time during the day.
SLOT if permission is requires, and once obtained it does restrict the aircraft to operate at a certain time, for which the permission was issued.

null indicates that this information is not available.

If this property is not null additional information may be available in the nonScheduledPermissionNotes property.
nonScheduledPermissionNotesstring, nullFree text with an explanation of the permission that needs to be obtained by non-scheduled flights to operate.
paxLimitnumber, nullThe maximum number of passengers seats allowed for each aircarft operating at the airfield.

When this is set to 999 there are no restrictions imposed.

null indicates that the information is not known.
weightLimitnumber, nullThe highest MTOM (Maximum Take-off Mass, or Weight) allowed for an aircraft operating at the airfield.
Values are expressed in Kilos.

When this is set to 9999999 there are no restrictions imposed.

null indicates that the information is not known.
wingspanLimitnumber, nullThe largest wingspan allowed for an aircraft operating at the field.
Values are expressed in meters.

When this is set to 999 there are no restrictions imposed.

null indicates that the information is not known.
referenceWeatherStationstring, nullIf an airfield is known to not publish weather reports, or if the weather reports are not published 24h a day, the identifier of a different location can be specified here to indicate which nearby station best describes the weather conditions at the airfield.

The value of this field is the AID of a nearby airport that is known to issue weather reports 24h a day.

null indicates that this information was not added.

Below a full example of an airport:

{
  "icao": "UWSG",
  "iata": "GSV",
  "faa": null,
  "name": "Gagarin International",
  "servedCity": "Saratov",
  "elevation": 31.39,
  "coordinates": {
    "latitude": 51.712777777777,
    "longitude": 46.17111111111111
  },
  "variation": 11.60,
  "country": {
    "iso3": "RUS",
    "iso2": "RU",
    "isoNumeric": 643,
    "name": "Russian Federation",
    "continent": "Europe"
  },
  "timeZone": "Europe/Saratov",
  "type": "AIRPORT",
  "operator": "PUBLIC",
  "accessibleFor": [
    "SCHEDULED",
    "HELICOPTER",
    "MILITARY",
    "GENERAL_AVIATION",
    "BUSINESS_AVIATION",
    "NON_SCHEDULED",
    "TRAINING"
  ],
  "ifr": true,
  "nonScheduledPermission": "SLOT",
  "nonScheduledPermissionNotes": null,
  "mandatoryHandling": true,
  "mandatoryQualification": false,
  "qualificationLink": null,
  "qualificationNotes": null,
  "weightLimit": 0,
  "wingspanLimit": 0,
  "paxLimit": 0,
  "referenceWeatherStation": null,
  "aid": "APT-SY1A-N129"
}
Was this article helpful to you? Yes No

How can we help?