Metadata-Version: 2.1
Name: airportsdata
Version: 20210608.3
Summary: Extensive database of location data for nearly every airport and landing strip in the world
Home-page: https://github.com/mborsetti/airportsdata
Author: Mike Borsetti
Author-email: mike@borsetti.com
License: MIT
Project-URL: Bug Tracker, https://github.com/mborsetti/airportsdata/issues
Project-URL: Source Code, https://github.com/mborsetti/airportsdata
Project-URL: Documentation, https://github.com/mborsetti/airportsdata/README.rst
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Operating System :: OS Independent
Classifier: Topic :: Database
Classifier: Intended Audience :: Developers
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: typing-extensions ; python_version < "3.8"
Provides-Extra: testing
Requires-Dist: pytest ; extra == 'testing'
Requires-Dist: pytest-cov ; extra == 'testing'
Requires-Dist: tzdata ; (os_name == "nt") and extra == 'testing'
Requires-Dist: backports.zoneinfo ; (python_version < "3.9") and extra == 'testing'

============
airportsdata
============

.. |ICAO| replace:: 28,865

.. |IATA| replace:: 6,560

.. |version| image:: https://img.shields.io/pypi/v/airportsdata.svg
    :target: https://pypi.org/project/airportsdata/
    :alt: pypi version

.. |support| image:: https://img.shields.io/pypi/pyversions/airportsdata.svg
    :target: https://pypi.org/project/airportsdata/
    :alt: supported Python version

.. |license| image:: https://img.shields.io/pypi/l/airportsdata.svg
    :target: https://pypi.org/project/airportsdata/
    :alt: license

.. |issues| image:: https://img.shields.io/github/issues-raw/mborsetti/airportsdata
    :target: https://github.com/mborsetti/airportsdata/issues
    :alt: issues

.. |CI| image:: https://github.com/mborsetti/airportsdata/workflows/Tests/badge.svg?branch=main
    :target: https://github.com/mborsetti/airportsdata/actions
    :alt: CI testing status

.. |coveralls| image:: https://coveralls.io/repos/github/mborsetti/airportsdata/badge.svg?branch=main
    :target: https://coveralls.io/github/mborsetti/airportsdata?branch=main
    :alt: code coverage by Coveralls


Extensive database of location data for nearly every airport and landing strip in the world, with |ICAO| entries.

Each entry consists of the following data:

* ``icao``: ICAO (or FAA/TD LID) 4-alphanumeric code
* ``iata``: IATA 3-letter code (for |IATA| entries) or an empty string; these will be validated, going forward, against
  `IATA data <https://www.iata.org/en/publications/directories/code-search/>`__
* ``name``: official name (latin script)
* ``city``: city
* ``subd``: subdivision (e.g. state, province, region, etc.)
* ``country``: `ISO 3166-1 <https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes>`__ alpha-2 country code
  (plus ``XK`` for Kosovo)
* ``elevation``: MSL elevation (the highest point of the landing area) in feet
* ``lat``: latitude (decimal)
* ``lon``: longitude (decimal)
* ``tz``: timezone expressed as a `tz database name <https://en.wikipedia.org/wiki/List_of_tz_database_time_zones>`__
  (IANA-compliant) (originally sourced from `TimeZoneDB <https://timezonedb.com>`__)

Best efforts are placed to review all contributions for accuracy, but accuracy cannot be guaranteed or should be
expected by users. Please report any issues you may find `here
<https://github.com/mborsetti/airportsdata/blob/main/CONTRIBUTING.rst>`__.

Known issues:

* 219 aerodromes have IATA codes that are not in the `IATA database
  <https://www.iata.org/en/publications/directories/code-search/>`__ and may be incorrect
* A small, but unknown, number of aerodromes are missing their IATA code (none are major airports)
* No historical data

This project is a fork of https://github.com/mwgg/Airports

Python
======
|version| |support| |CI| |coveralls| |issues|

Install from `PyPi <https://pypi.org/project/airportsdata/>`__  using pip:

.. code-block:: bash

  pip install -U airportsdata

Once installed, to load the data into a dict:

.. code-block:: python

  import airportsdata
  airports = airportsdata.load()  # key is ICAO code

or

.. code-block:: python

  import airportsdata
  airports = airportsdata.load('IATA')  # key is IATA code

Raw data
========

A CSV (comma separated values) file with headers (UTF-8 encoding) is downloadable from GitHub `here
<https://github.com/mborsetti/airportsdata/raw/main/airportsdata/airports.csv>`__.

License
=======

|license|

Released under the `MIT License <https://opensource.org/licenses/MIT>`__ (see license `here
<https://github.com/mborsetti/airportsdata/blob/main/LICENSE>`__).


