Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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

✈️ Various IATA files, mappings and utilities
https://github.com/benct/iata-utils

airline-search airport iana iata iata-codes iata-location iata-utilities icao optd por search ssim timezones utility

Last synced: about 1 month ago
JSON representation

✈️ Various IATA files, mappings and utilities

Awesome Lists containing this project

README

        

# IATA Utilities
Various [IATA](https://www.iata.org/) files, mappings and utilities.

[![GitHub last commit](https://img.shields.io/github/last-commit/benct/iata-utils.svg)](https://github.com/benct/iata-utils)
[![GitHub licence](https://img.shields.io/github/license/benct/iata-utils.svg)](https://github.com/benct/iata-utils/blob/master/LICENCE)
[![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/benct/iata-utils.svg)](https://github.com/benct/iata-utils)

## 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](https://www.iana.org/time-zones) timezones.
```
LON^Europe/London
LHR^Europe/London
JFK^America/New_York
```

### iata_ssim_tz.csv
Mapping of IATA's [SSIM](https://www.iata.org/publications/store/Pages/standard-schedules-information.aspx) timezones to the
more common [IANA](https://www.iana.org/time-zones) 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](https://github.com/opentraveldata/opentraveldata/tree/master/data/IATA/archives).

### optd_por_public.csv
Sub-set data file containing around 20,000 points of reference (POR), referenced by an IATA code ([Source](https://github.com/opentraveldata/opentraveldata/blob/master/opentraveldata/optd_por_public.csv)).

### optd_airline_best_known_so_far.csv
Data file containing best known information and details on airlines ([Source](https://github.com/opentraveldata/opentraveldata/blob/master/opentraveldata/optd_airline_best_known_so_far.csv)).

##### Open Travel Data
The data curated and/or generated by the OPTD project are governed by the [CC-BY license](http://creativecommons.org/licenses/by/4.0/).

## Development

Update generated files by running the application [IataApplication.kt](https://github.com/benct/iata-utils/blob/master/src/main/java/no/tomlin/iata/IataApplication.kt).

```bash
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.

```bash
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_.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