Skip to main content

Extensive database of location and timezone data for nearly every airport and landing strip in the world.

Project description

Extensive database of location and timezone data for nearly every operational airport and landing strip in the world, with 28,274 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,274 entries);

  • iata: IATA 3-letter Location Code (7,865 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.

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).

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

airportsdata-20250204.tar.gz (910.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

airportsdata-20250204-py3-none-any.whl (914.0 kB view details)

Uploaded Python 3

File details

Details for the file airportsdata-20250204.tar.gz.

File metadata

  • Download URL: airportsdata-20250204.tar.gz
  • Upload date:
  • Size: 910.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for airportsdata-20250204.tar.gz
Algorithm Hash digest
SHA256 b64bd63f318f2db95ab624b62ffb1120a6284d5cc341e8c53ebe083823ed13e8
MD5 fc30950320f301f5f2d01592879ea1c4
BLAKE2b-256 dd9cc093dcfdfee128aa0d4949f4484374d7338bd0a95d903fc0f7acdd2aa6d7

See more details on using hashes here.

Provenance

The following attestation bundles were made for airportsdata-20250204.tar.gz:

Publisher: ci-cd.yaml on mborsetti/airportsdata

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file airportsdata-20250204-py3-none-any.whl.

File metadata

File hashes

Hashes for airportsdata-20250204-py3-none-any.whl
Algorithm Hash digest
SHA256 7882a0c48bf26627f78a0deb5cd0d89cdd8d3bdbc5202b39a65db531063905ba
MD5 872e8e722356d436ac77e61e06db1e5f
BLAKE2b-256 f167cffd33a70dff2a21ab1c6932e9cf39f1ebfa97a4bfe564f526419f752e29

See more details on using hashes here.

Provenance

The following attestation bundles were made for airportsdata-20250204-py3-none-any.whl:

Publisher: ci-cd.yaml on mborsetti/airportsdata

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page