README.md

air-data

Collection of aviation data including airline/airport IATA/ICAO conversions, timzeone data, etc.

Data Sources

• airports.json - ip2location/ip2location-iata-icao, under the Creative Commons Attribution-ShareAlike 4.0 International License.
• airlines.json - benct/iata-utils, under the MIT License.
• timezones.json - hroptatyr/dateutils

Contributing

Requirements:

• Node.js
• pnpm
• git

Contributing Data:

To contribute data, use the type file (airports, airlines, timezones) in the src/append directory. The data should be in JSON format and follow the following examples:

airlines:

{
  "iata_code": "DL",
  "icao_code": "DAL",
  "name": "Delta Air Lines",
  "alias": "",
  "by": "iata" // This is only used if replacing an existing string in the airlines.json file (by iata or icao). If adding a new entry, this should be omitted.
}

After, run the following command to append the data to the existing JSON file:

pnpm run-all

Open a pull request with the changes and they will be reviewed and merged if they meet the requirements.

License

The code to fetch the data is licensed under the MIT License. The data itself is licensed under the respective licenses of the sources mentioned above.