benct / iata-utils

✈️ Various IATA files, mappings and utilities

IATA Utilities

Various IATA files, mappings and utilities.

IATA location and airline search

https://benct.github.io/iata-utils/

Follow the link above or see the docs folder for the live IATA location and airline search tool.

Generated data

iata_tz.csv

Mapping of IATA location identifiers to IANA timezones.

LON^Europe/London
LHR^Europe/London
JFK^America/New_York

iata_ssim_tz.csv

Mapping of IATA's SSIM timezones to the more common IANA timezones.

GB^Europe/London
US1^America/New_York
US2^America/Chicago

iata_airlines.csv

Mapping of IATA two-letter airline codes to ICAO three-letter codes, airline names and possible airline alias.

BA^BAW^British Airways^
NH^ANA^All Nippon Airways^ANA
SK^SAS^Scandinavian Airlines^
UA^UAL^United Airlines^

Imported data

iata_airport_list.csv

The source for this file can be found in the Open Travel Data (OPTD) IATA archives.

optd_por_public.csv

Sub-set data file containing around 20,000 points of reference (POR), referenced by an IATA code (Source).

optd_airline_best_known_so_far.csv

Data file containing best known information and details on airlines (Source).

Open Travel Data

The data curated and/or generated by the OPTD project are governed by the CC-BY license.

Development

Update generated files by running the application IataApplication.kt.

kotlinc src/main/kotlin/no/tomlin/iata/* -include-runtime -d build/iata.jar

java -jar build/iata.jar

Live search (docs)

Make changes to the javascript app and run the following commands.

yarn install
yarn clean
yarn lint
yarn build-prod

Updating data files

Only update the imported data files by copying in changes from their respective sources (use curl commands below in root folder).

curl -o data/iata_airport_list.csv https://raw.githubusercontent.com/opentraveldata/opentraveldata/master/data/IATA/archives/iata_airport_list_<insert_latest_date>.csv

curl -o data/optd_por_public.csv https://raw.githubusercontent.com/opentraveldata/opentraveldata/master/opentraveldata/optd_por_public.csv

curl -o data/optd_airline_best_known_so_far.csv https://raw.githubusercontent.com/opentraveldata/opentraveldata/master/opentraveldata/optd_airline_best_known_so_far.csv

Sources

• https://www.iata.org/publications/Pages/code-search.aspx
• https://en.wikipedia.org/wiki/IATA_airport_code
• https://www.iana.org/time-zones
• https://github.com/opentraveldata/opentraveldata