airportsdata


Nameairportsdata JSON
Version 20240415 PyPI version JSON
download
home_pageNone
SummaryExtensive database of location and timezone data for nearly every airport and landing strip in the world.
upload_time2024-04-15 01:53:59
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseThe MIT License (MIT) Copyright (c) 2020- Mike Borsetti <mike@borsetti.com> This project includes data from https://github.com/mwgg/Airports Copyright (c) 2014 mwgg Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords airports aerodromes icao iata
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ========================
airportsdata |downloads|
========================

.. |ICAO| replace:: 28,186

.. |IATA| replace:: 7,821

.. |LID| replace:: 12,603

.. |pyversion| 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
.. |pypi_version| image:: https://img.shields.io/pypi/v/airportsdata.svg?label=
    :target: https://pypi.org/project/airportsdata/
    :alt: PyPI version
.. |format| image:: https://img.shields.io/pypi/format/airportsdata.svg
    :target: https://pypi.org/project/airportsdata/
    :alt: Kit format
.. |downloads| image:: https://static.pepy.tech/badge/airportsdata
    :target: https://www.pepy.tech/project/airportsdata
    :alt: PyPI downloads
.. |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/actions/workflows/ci-cd.yaml/badge.svg?event=push
    :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
.. |status| image:: https://img.shields.io/pypi/status/airportsdata.svg
    :target: https://pypi.org/project/airportsdata/
    :alt: Package stability
.. |security| image:: https://img.shields.io/badge/security-bandit-yellow.svg
    :target: https://github.com/PyCQA/bandit
    :alt: Security Status

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

Each entry consists of the following data:

* ``icao``: ICAO 4-letter Location Indicator (Doc 7910) or (if none) an internal Pseudo-ICAO Identifier [#]_ (|ICAO|
  entries);
* ``iata``: IATA 3-letter Location Code (|IATA| entries) or an empty string [#]_;
* ``name``: Official name (diacritized latin script);
* ``city``: City (diacritized latin script), ideally using the local language;
* ``subd``: Subdivision (e.g. state, province, region, etc.), ideally using the local-language or English names of
  `ISO 3166-2 <https://en.wikipedia.org/wiki/ISO_3166-2#Current_codes>`__;
* ``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 of the highest point of the landing area, in feet (warning: it is often wrong);
* ``lat``: Latitude (decimal) of the `airport reference point
  <https://en.wikipedia.org/wiki/Airport_reference_point>`__ (max 5 decimal digits);
* ``lon``: Longitude (decimal) of the `airport reference point
  <https://en.wikipedia.org/wiki/Airport_reference_point>`__ (max 5 decimal digits);
* ``tz``: Timezone expressed as a `tz database name <https://en.wikipedia.org/wiki/List_of_tz_database_time_zones>`__
  (IANA-compliant);
* ``lid``: U.S. FAA Location Identifier (|LID| entries), or an empty string.

.. [#] See `here <https://github.com/mborsetti/airportsdata/blob/main/README_identifiers.rst>`__ for an explanation on
   how the Pseudo-ICAO Identifier is generated for airports and seaplane bases without an ICAO 4-letter Location
   Indicator.

.. [#] IATA Multi Airport Cities 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
   <https://github.com/mborsetti/airportsdata/blob/main/README_IATA.rst>`__.

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 <https://timezonedb.com>`__;
* No historical data (closed airports are removed).

Please report any issues you may find `here
<https://github.com/mborsetti/airportsdata/blob/main/CONTRIBUTING.rst>`__.

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
<https://github.com/mborsetti/airportsdata/blob/main/README_AIP.rst>`__ (or
ARINC database) and `IATA <https://www.iata.org/en/publications/directories/code-search/>`__ before publishing.

Raw data
========

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

Python
======
|pyversion| |support| |format| |status| |security| |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 the ICAO identifier (the default)
   print(airports['KJFK'])

or

.. code-block:: python

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

or

.. code-block:: python

   import airportsdata
   airports = airportsdata.load('LID')  # key is the FAA LID
   print(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 <https://opensource.org/licenses/MIT>`__ (see license `here
<https://github.com/mborsetti/airportsdata/blob/main/LICENSE>`__).

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "airportsdata",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": "Mike Borsetti <mike+airportsdata@borsetti.com>",
    "keywords": "airports, aerodromes, ICAO, IATA",
    "author": null,
    "author_email": "Mike Borsetti <mike+airportsdata@borsetti.com>",
    "download_url": "https://files.pythonhosted.org/packages/a4/c4/f9bbf96d57ab8cce1eb9d4f6c3c4a4d5c7f3cbb4e88e7e98e8b7f20e77aa/airportsdata-20240415.tar.gz",
    "platform": null,
    "description": "========================\nairportsdata |downloads|\n========================\n\n.. |ICAO| replace:: 28,186\n\n.. |IATA| replace:: 7,821\n\n.. |LID| replace:: 12,603\n\n.. |pyversion| image:: https://img.shields.io/pypi/v/airportsdata.svg\n    :target: https://pypi.org/project/airportsdata/\n    :alt: pypi version\n.. |support| image:: https://img.shields.io/pypi/pyversions/airportsdata.svg\n    :target: https://pypi.org/project/airportsdata/\n    :alt: supported Python version\n.. |pypi_version| image:: https://img.shields.io/pypi/v/airportsdata.svg?label=\n    :target: https://pypi.org/project/airportsdata/\n    :alt: PyPI version\n.. |format| image:: https://img.shields.io/pypi/format/airportsdata.svg\n    :target: https://pypi.org/project/airportsdata/\n    :alt: Kit format\n.. |downloads| image:: https://static.pepy.tech/badge/airportsdata\n    :target: https://www.pepy.tech/project/airportsdata\n    :alt: PyPI downloads\n.. |license| image:: https://img.shields.io/pypi/l/airportsdata.svg\n    :target: https://pypi.org/project/airportsdata/\n    :alt: license\n.. |issues| image:: https://img.shields.io/github/issues-raw/mborsetti/airportsdata\n    :target: https://github.com/mborsetti/airportsdata/issues\n    :alt: issues\n.. |CI| image:: https://github.com/mborsetti/airportsdata/actions/workflows/ci-cd.yaml/badge.svg?event=push\n    :target: https://github.com/mborsetti/airportsdata/actions\n    :alt: CI testing status\n.. |coveralls| image:: https://coveralls.io/repos/github/mborsetti/airportsdata/badge.svg?branch=main\n    :target: https://coveralls.io/github/mborsetti/airportsdata?branch=main\n    :alt: code coverage by Coveralls\n.. |status| image:: https://img.shields.io/pypi/status/airportsdata.svg\n    :target: https://pypi.org/project/airportsdata/\n    :alt: Package stability\n.. |security| image:: https://img.shields.io/badge/security-bandit-yellow.svg\n    :target: https://github.com/PyCQA/bandit\n    :alt: Security Status\n\nExtensive database of location and timezone data for nearly every operational airport and landing strip in the world,\nwith |ICAO| entries.\n\nEach entry consists of the following data:\n\n* ``icao``: ICAO 4-letter Location Indicator (Doc 7910) or (if none) an internal Pseudo-ICAO Identifier [#]_ (|ICAO|\n  entries);\n* ``iata``: IATA 3-letter Location Code (|IATA| entries) or an empty string [#]_;\n* ``name``: Official name (diacritized latin script);\n* ``city``: City (diacritized latin script), ideally using the local language;\n* ``subd``: Subdivision (e.g. state, province, region, etc.), ideally using the local-language or English names of\n  `ISO 3166-2 <https://en.wikipedia.org/wiki/ISO_3166-2#Current_codes>`__;\n* ``country``: `ISO 3166-1 <https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes>`__ alpha-2 country code\n  (plus ``XK`` for Kosovo);\n* ``elevation``: MSL elevation of the highest point of the landing area, in feet (warning: it is often wrong);\n* ``lat``: Latitude (decimal) of the `airport reference point\n  <https://en.wikipedia.org/wiki/Airport_reference_point>`__ (max 5 decimal digits);\n* ``lon``: Longitude (decimal) of the `airport reference point\n  <https://en.wikipedia.org/wiki/Airport_reference_point>`__ (max 5 decimal digits);\n* ``tz``: Timezone expressed as a `tz database name <https://en.wikipedia.org/wiki/List_of_tz_database_time_zones>`__\n  (IANA-compliant);\n* ``lid``: U.S. FAA Location Identifier (|LID| entries), or an empty string.\n\n.. [#] See `here <https://github.com/mborsetti/airportsdata/blob/main/README_identifiers.rst>`__ for an explanation on\n   how the Pseudo-ICAO Identifier is generated for airports and seaplane bases without an ICAO 4-letter Location\n   Indicator.\n\n.. [#] IATA Multi Airport Cities are not not airports and therfore not included, but we provide a database and a Python\n   function that returns the above data for all the airports of a IATA MAC. Please see documentation `here\n   <https://github.com/mborsetti/airportsdata/blob/main/README_IATA.rst>`__.\n\nBest efforts are placed to review all contributions for accuracy, but accuracy cannot be guaranteed nor should be\nexpected by users.\n\nImportant notes:\n\n* Timezone was originally sourced from `TimeZoneDB <https://timezonedb.com>`__;\n* No historical data (closed airports are removed).\n\nPlease report any issues you may find `here\n<https://github.com/mborsetti/airportsdata/blob/main/CONTRIBUTING.rst>`__.\n\nThis project is a fork of https://github.com/mwgg/Airports. All new data submitted in this fork have been validated\nagainst national `Aeronautical Information Publications (AIP) or equivalent\n<https://github.com/mborsetti/airportsdata/blob/main/README_AIP.rst>`__ (or\nARINC database) and `IATA <https://www.iata.org/en/publications/directories/code-search/>`__ before publishing.\n\nRaw data\n========\n\nA CSV (comma separated values) file, with headers and encoded in UTF-8, is downloadable from GitHub `here\n<https://github.com/mborsetti/airportsdata/raw/main/airportsdata/airports.csv>`__.\n\nPython\n======\n|pyversion| |support| |format| |status| |security| |CI| |coveralls| |issues|\n\nInstall from `PyPi <https://pypi.org/project/airportsdata/>`__  using pip:\n\n.. code-block:: bash\n\n  pip install -U airportsdata\n\nOnce installed, to load the data into a dict:\n\n.. code-block:: python\n\n   import airportsdata\n   airports = airportsdata.load()  # key is the ICAO identifier (the default)\n   print(airports['KJFK'])\n\nor\n\n.. code-block:: python\n\n   import airportsdata\n   airports = airportsdata.load('IATA')  # key is the IATA location code\n   print(airports['JFK'])\n\nor\n\n.. code-block:: python\n\n   import airportsdata\n   airports = airportsdata.load('LID')  # key is the FAA LID\n   print(airports['01AA'])\n\nOlder Python versions are supported for 3 years after being obsoleted by a new major release (i.e. about 4 years\nsince their original release).\n\nLicense |license|\n=================\n\nReleased under the `MIT License <https://opensource.org/licenses/MIT>`__ (see license `here\n<https://github.com/mborsetti/airportsdata/blob/main/LICENSE>`__).\n",
    "bugtrack_url": null,
    "license": "The MIT License (MIT)  Copyright (c) 2020- Mike Borsetti <mike@borsetti.com>  This project includes data from https://github.com/mwgg/Airports Copyright (c) 2014 mwgg  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
    "summary": "Extensive database of location and timezone data for nearly every airport and landing strip in the world.",
    "version": "20240415",
    "project_urls": {
        "Changelog": "https://github.com/mborsetti/airportsdata/blob/main/CHANGELOG.rst",
        "Database (csv)": "https://github.com/mborsetti/airportsdata/blob/main/airportsdata/airports.csv",
        "Documentation": "https://github.com/mborsetti/airportsdata/blob/main/README.rst",
        "Issues": "https://github.com/mborsetti/airportsdata/issues",
        "Repository": "https://github.com/mborsetti/airportsdata/"
    },
    "split_keywords": [
        "airports",
        " aerodromes",
        " icao",
        " iata"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d2a29b5cab466746fc18787f67f61e4a8582f6d80aa72f6c63fab7a167630740",
                "md5": "9ad0aa9efa669767e9ecad42d6b8eb05",
                "sha256": "492abd1b35b207f441e52aa3ecbd49d03261e6a2826444895f1203f0ee4bc905"
            },
            "downloads": -1,
            "filename": "airportsdata-20240415-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "9ad0aa9efa669767e9ecad42d6b8eb05",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 911007,
            "upload_time": "2024-04-15T01:53:56",
            "upload_time_iso_8601": "2024-04-15T01:53:56.804998Z",
            "url": "https://files.pythonhosted.org/packages/d2/a2/9b5cab466746fc18787f67f61e4a8582f6d80aa72f6c63fab7a167630740/airportsdata-20240415-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "a4c4f9bbf96d57ab8cce1eb9d4f6c3c4a4d5c7f3cbb4e88e7e98e8b7f20e77aa",
                "md5": "478b91532b8e69e3d3ab8a07455b4974",
                "sha256": "1f1c2d311217d4779d3327a2e48546e0571467d5c0144f4d94c6951e85bcd604"
            },
            "downloads": -1,
            "filename": "airportsdata-20240415.tar.gz",
            "has_sig": false,
            "md5_digest": "478b91532b8e69e3d3ab8a07455b4974",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 901254,
            "upload_time": "2024-04-15T01:53:59",
            "upload_time_iso_8601": "2024-04-15T01:53:59.531589Z",
            "url": "https://files.pythonhosted.org/packages/a4/c4/f9bbf96d57ab8cce1eb9d4f6c3c4a4d5c7f3cbb4e88e7e98e8b7f20e77aa/airportsdata-20240415.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-04-15 01:53:59",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "mborsetti",
    "github_project": "airportsdata",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "tox": true,
    "lcname": "airportsdata"
}
        
Elapsed time: 0.26188s