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

Availability

The Availability model provides information about the availability of the Location for aircraft movements, Aerodrome Rescue and Fire Fighting service, Aerodrome Air Traffic Services and Customs and Immigration facilities.

In the aviowiki API the following naming is used to identify these separate services:

  • movement for the availability of the location for take-off and landing without any further guarantee of service
  • arff for Aerodrome Rescue and Fire Fighting services
  • atc for Air Traffic Services
  • ciq for Customs, Immigration and Quarantine facilities.

Example

A query for the availability of a Location will return the following JSON data:

{
  "openingIndicator": "CLOSED",
  "arff": {
    "blocks": [
      {
        "validFrom": "2019-11-22T00:00:00",
        "validTo": "2019-11-23T23:59:59.999999999",
        "status": "UNKNOWN",
        "info": {}
      }
    ]
  },
  "atc": {
    "blocks": [
      {
        "validFrom": "2019-11-22T00:00:00",
        "validTo": "2019-11-23T23:59:59.999999999",
        "status": "UNKNOWN",
        "info": {}
      }
    ]
  },
  "ciq": {
    "blocks": [
      {
        "validFrom": "2019-11-22T00:00:00",
        "validTo": "2019-11-23T23:59:59.999999999",
        "status": "UNKNOWN",
        "info": {}
      }
    ]
  },
  "movement": {
    "blocks": [
      {
        "validFrom": "2019-11-22T18:18:36.7412",
        "validTo": "2019-11-23T07:04:59.999999999",
        "status": "CLOSED",
        "info": {}
      },
      {
        "validFrom": "2019-11-23T07:05:00",
        "validTo": "2019-11-23T17:20:59.999999999",
        "status": "FULL",
        "info": {}
      },
      {
        "validFrom": "2019-11-23T17:21:00",
        "validTo": "2019-11-23T18:18:36.741199999",
        "status": "CLOSED",
        "info": {}
      }
    ]
  }
}

Each of movement, arff, atc, and ciq have a blocks property which is a list of time-referenced blocks that contain information on the availability of the individual service.

Time reference

The API allows selecting if time returned are with reference to UTC or to Local Time. By default, all times for the Availability Blocks are with reference to the Local Time of the airport being queried.

When Availability times are entered in the aviowiki database, not all times are absolute, as some availability models depend on sunrise and sunset times. Whenever Availability Blocks are returned via the API, all such cases are resolved and times are always provided in an exact form, taking into account sunrise and sunset times where applicable.

Availability blocks

Different services require different properties to express their availability, however, all Availability Blocks have four properties in common.

  • validFrom is an ISO formatted date-time string that indicates when the block starts
  • validTo is an ISO formatted date-time string that indicates when the block ends
  • status is an enumeration that describes the current status of the facility. This can be FULL to indicate that the facility is fully available as described by the object, LIMITED to indicate that the facility is available under certain conditions that cannot be described by the model, and CLOSED to indicate that the facility is not available.
  • info is an object that contains additional information about the current Availability Block.

In all cases the info object can contain the following property:

  • notes is present only in case status is LIMITED and is used to describe in plain English the limitation in force

movement Availability

Movement Availability indicates the availability for an aircraft to physically land or take-off at a location, with no guarantee of any other service being rendered.

The info object for Movement Availability can only contain notes, if applicable.

ciq Availability

CIQ (Customs Immigration and Quarantine) Availability indicates the availability of Customs and Immigration facilities to process aircraft, crew, passengers and cargo as required by local regulations.

The info object for CIQ Availability can only contain notes, if applicable.

atc Availability

ATC (Air Traffic Control) Availability indicates the availability of Air Traffic Services to support aircraft during the final descent, landing and ground movement.

The info object for ATC Availability have the following properties in addition to the base model described before:

  • afisOnly a boolean which when true indicates that only AFIS (Aerodrome Flight Information Service) is provided.
  • enRtfAvailable a boolean which when true indicates that English Radiotelephony is available. This simply means that the radio operator can speak English.

arff Availability

ARFF (Airport Rescue and Fire Fighting) Availability indicates the availability of Rescue and Fire Fighting services to attend in case of an emergency.

The info object for ARFF Availability have the following properties in addition to the base model described before:

  • icaoCatAirplane indicates the ICAO Rescue and Fire Fighting category for airplanes (not helicopters). Possible values are NONE, I, II, III, IV, V, VI, VII, VIII, IX, X. null means the information is not available.
  • faaCatAirplane indicates the FAA category. Possible values are NONE, A, B, C, D, E. null indicates that the information is not available.
  • faa139Certified boolean that indicates if the airport is certified according to 14 CFR ยง139. If true, it means the basis for the ARFF certification are the US rules, which don’t allow for immediate conversion of faaCatAirplane to icaoCatAirplane. If true it indicates that icaoCatAirplane was a value calculated based on the values of waterQuantity, complementaryQuantity, arffVehicles, and dischargeCapacity.
  • catHelicopters indicates the ARFF value for helicopters. Possible values are NONE, I, II, III, IV. null if the information is not available.
  • waterQuantity the total water capacity of all ARFF vehicles available, in litres.
  • complementaryQuantity the total capacity of Complimentary Extinguishing Agent available, in kilograms. null if the information is not available.
  • arffVehicles the number of ARFF vehicles available. null if the information is not available.
  • dischargeCapacity the total discharge capacity of all ARFF vehicles available, in litres per minute. null if the information is not available.
  • extensionAvailable boolean which indicates if an upgrade of the ARFF to a higher category can be arranged. null if the information is not available.
  • extensionNotice amount of hours required to obtain ARFF extension before departure or arrival. null if the information is not available.
  • extensionUpToIcao the maximum ARFF obtainable with extension. This is only available in ICAO format. Possible values are as per icaoCatAirplane. null if the information is not available.
  • firestationRemote boolean which indicates if the ARFF service is offered by a remote fire station, not located at the airfield, for example, a village fire station. null if the information is not available.
  • firestationNotes if firestationRemote is true, this text field allows notes about the location and performance of the remote fire station, for example, to indicate the response time.

The openingIndicator flag

This indicator is produced by the backend and takes into consideration all 4 availabilities at the current time.

Possible values are:

  • OPEN to indicate that all facilities are fully available.
  • SEE_TIMES to indicate that some, potentially non-critical, facilities are not fully available and that the user should check full details.
  • CLOSED to indicate that either movemet or all facilities are not available.
  • UNKNOWN to indicate that there is not enough information to determine the current opening status of the location.

For client implementation, it is recommended that only OPEN and CLOSED statuses are used for decision-making, and that any other status is analyzed in more details or referred to a human.

Was this article helpful to you? Yes No

How can we help?