Skip to content

Extensive database of current data for nearly every airport and landing strip in the world, with over 28,000 entries.

License

Notifications You must be signed in to change notification settings

mborsetti/airportsdata

Repository files navigation

airportsdata PyPI downloads

Extensive database of location and timezone data for nearly every operational airport and landing strip in the world, with 28,270 entries.

Each entry consists of the following data:

  • icao: ICAO 4-letter Location Indicator (Doc 7910) or (if none) an internal Pseudo-ICAO Identifier [1] (28,270 entries);
  • iata: IATA 3-letter Location Code (7,859 entries) or an empty string [2];
  • name: Official name (diacritized latin script);
  • city: City (diacritized latin script), ideally using the local language or English;
  • subd: Subdivision (e.g. state, province, region, etc.), ideally using the local-language or English names of ISO 3166-2;
  • country: ISO 3166-1 alpha-2 country code (plus XK for Kosovo);
  • elevation: MSL elevation of the highest point of the landing area, in feet (warning: it is often wrong);
  • lat: Latitude (decimal) of the airport reference point (max 5 or 6 decimal digits);
  • lon: Longitude (decimal) of the airport reference point (max 5 or 6 decimal digits);
  • tz: Timezone expressed as a tz database name (IANA-compliant);
  • lid: U.S. FAA Location Identifier (12,610 entries), or an empty string.
[1]See here for an explanation on how the Pseudo-ICAO Identifier is generated for airports and seaplane bases without an ICAO 4-letter Location Indicator.
[2]IATA Multi Airport Cities (MAC) are not not airports and therfore not included, but we provide a database and a Python function that returns the above data for all the airports of a IATA MAC. Please see documentation here.

Best efforts are placed to review all contributions for accuracy, but accuracy cannot be guaranteed nor should be expected by users.

Important notes:

  • Timezone was originally sourced from TimeZoneDB;
  • No historical data (closed airports are removed);
  • No heliports without a IATA code;
  • No sea bases without a IATA code;
  • No surface transportation stations, even if they have an official IATA code.

Please report any issues you may find here.

This project is a fork of https://github.com/mwgg/Airports. All new data submitted in this fork have been validated against national Aeronautical Information Publications (AIP) or equivalent (or ARINC database) and IATA or https://www.ch-aviation.com/airports/{IATA} before publishing. ARINC database) and IATA or https://www.ch-aviation.com/airports/{IATA} before publishing.

Raw data

A CSV (comma separated values) file, with headers and encoded in UTF-8, is downloadable from GitHub here.

Python

pypi version supported Python version Kit format Package stability Security Status CI testing status code coverage by Coveralls issues

Install from PyPi using uv (recommended):

uv pip install --update airportsdata

Or, using pip:

pip install --update airportsdata

Once installed, to load the data into a dict:

import airportsdata
icao_airports = airportsdata.load()  # key is the ICAO identifier (the default)
print(icao_airports['KJFK'])

or

import airportsdata
iata_airports = airportsdata.load('IATA')  # key is the IATA location code
print(iata_airports['JFK'])

or

import airportsdata
lid_airports = airportsdata.load('LID')  # key is the FAA LID
print(lid_airports['01AA'])

Older Python versions are supported for 3 years after being obsoleted by a new major release (i.e. about 4 years since their original release).

License license

Released under the MIT License (see license here).

About

Extensive database of current data for nearly every airport and landing strip in the world, with over 28,000 entries.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 8

Languages