{"author":"","author_email":"","bugtrack_url":null,"classifiers":["Development Status :: 5 - Production/Stable","Intended Audience :: Developers","Intended Audience :: Science/Research","License :: OSI Approved :: MIT License","Operating System :: OS Independent","Programming Language :: Python","Programming Language :: Python :: 3","Programming Language :: Python :: 3 :: Only","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11","Programming Language :: Python :: 3.12","Programming Language :: Python :: 3.7","Programming Language :: Python :: 3.8","Programming Language :: Python :: 3.9","Programming Language :: Python :: Implementation :: CPython","Programming Language :: Python :: Implementation :: PyPy","Topic :: Scientific/Engineering :: GIS","Topic :: Software Development :: Libraries :: Python Modules"],"description":"geopy\n=====\n\n.. image:: https://img.shields.io/pypi/v/geopy.svg?style=flat-square\n :target: https://pypi.python.org/pypi/geopy/\n :alt: Latest Version\n\n.. image:: https://img.shields.io/github/actions/workflow/status/geopy/geopy/ci.yml?branch=master&style=flat-square\n :target: https://github.com/geopy/geopy/actions/workflows/ci.yml?query=branch%3Amaster\n :alt: Build Status\n\n.. image:: https://img.shields.io/github/license/geopy/geopy.svg?style=flat-square\n :target: https://pypi.python.org/pypi/geopy/\n :alt: License\n\n\ngeopy is a Python client for several popular geocoding web\nservices.\n\ngeopy makes it easy for Python developers to locate the coordinates of\naddresses, cities, countries, and landmarks across the globe using\nthird-party geocoders and other data sources.\n\ngeopy includes geocoder classes for the `OpenStreetMap Nominatim`_,\n`Google Geocoding API (V3)`_, and many other geocoding services.\nThe full list is available on the `Geocoders doc section`_.\nGeocoder classes are located in `geopy.geocoders`_.\n\n.. _OpenStreetMap Nominatim: https://nominatim.org\n.. _Google Geocoding API (V3): https://developers.google.com/maps/documentation/geocoding/\n.. _Geocoders doc section: https://geopy.readthedocs.io/en/latest/#geocoders\n.. _geopy.geocoders: https://github.com/geopy/geopy/tree/master/geopy/geocoders\n\ngeopy is tested against CPython (versions 3.7, 3.8, 3.9, 3.10, 3.11, 3.12)\nand PyPy3. geopy 1.x line also supported CPython 2.7, 3.4 and PyPy2.\n\n© geopy contributors 2006-2018 (see AUTHORS) under the `MIT\nLicense `__.\n\nInstallation\n------------\n\nInstall using `pip `__ with:\n\n::\n\n pip install geopy\n\nOr, `download a wheel or source archive from\nPyPI `__.\n\nGeocoding\n---------\n\nTo geolocate a query to an address and coordinates:\n\n.. code:: pycon\n\n >>> from geopy.geocoders import Nominatim\n >>> geolocator = Nominatim(user_agent=\"specify_your_app_name_here\")\n >>> location = geolocator.geocode(\"175 5th Avenue NYC\")\n >>> print(location.address)\n Flatiron Building, 175, 5th Avenue, Flatiron, New York, NYC, New York, ...\n >>> print((location.latitude, location.longitude))\n (40.7410861, -73.9896297241625)\n >>> print(location.raw)\n {'place_id': '9167009604', 'type': 'attraction', ...}\n\nTo find the address corresponding to a set of coordinates:\n\n.. code:: pycon\n\n >>> from geopy.geocoders import Nominatim\n >>> geolocator = Nominatim(user_agent=\"specify_your_app_name_here\")\n >>> location = geolocator.reverse(\"52.509669, 13.376294\")\n >>> print(location.address)\n Potsdamer Platz, Mitte, Berlin, 10117, Deutschland, European Union\n >>> print((location.latitude, location.longitude))\n (52.5094982, 13.3765983)\n >>> print(location.raw)\n {'place_id': '654513', 'osm_type': 'node', ...}\n\nMeasuring Distance\n------------------\n\nGeopy can calculate geodesic distance between two points using the\n`geodesic distance\n`_ or the\n`great-circle distance\n`_,\nwith a default of the geodesic distance available as the function\n`geopy.distance.distance`.\n\nHere's an example usage of the geodesic distance, taking pair\nof :code:`(lat, lon)` tuples:\n\n.. code:: pycon\n\n >>> from geopy.distance import geodesic\n >>> newport_ri = (41.49008, -71.312796)\n >>> cleveland_oh = (41.499498, -81.695391)\n >>> print(geodesic(newport_ri, cleveland_oh).miles)\n 538.390445368\n\nUsing great-circle distance, also taking pair of :code:`(lat, lon)` tuples:\n\n.. code:: pycon\n\n >>> from geopy.distance import great_circle\n >>> newport_ri = (41.49008, -71.312796)\n >>> cleveland_oh = (41.499498, -81.695391)\n >>> print(great_circle(newport_ri, cleveland_oh).miles)\n 536.997990696\n\nDocumentation\n-------------\n\nMore documentation and examples can be found at\n`Read the Docs `__.\n\n\n","description_content_type":"","docs_url":null,"download_url":"https://github.com/geopy/geopy/archive/2.4.1.tar.gz","downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":null,"home_page":"https://github.com/geopy/geopy","keywords":"geocode,geocoding,gis,geographical,maps,earth,distance","license":"MIT","license_expression":null,"license_files":null,"maintainer":"Kostya Esmukov","maintainer_email":"kostya@esmukov.net","name":"geopy","package_url":"https://pypi.org/project/geopy/","platform":null,"project_url":"https://pypi.org/project/geopy/","project_urls":{"Download":"https://github.com/geopy/geopy/archive/2.4.1.tar.gz","Homepage":"https://github.com/geopy/geopy"},"provides_extra":null,"release_url":"https://pypi.org/project/geopy/2.4.1/","requires_dist":["geographiclib (<3,>=1.52)","aiohttp ; extra == 'aiohttp'","coverage ; extra == 'dev'","flake8 (<5.1,>=5.0) ; extra == 'dev'","isort (<5.11.0,>=5.10.0) ; extra == 'dev'","pytest-asyncio (>=0.17) ; extra == 'dev'","pytest (>=3.10) ; extra == 'dev'","readme-renderer ; extra == 'dev'","sphinx-issues ; extra == 'dev'","sphinx (<=4.3.2) ; extra == 'dev'","sphinx-rtd-theme (>=0.5.0) ; extra == 'dev'","readme-renderer ; extra == 'dev-docs'","sphinx (<=4.3.2) ; extra == 'dev-docs'","sphinx-issues ; extra == 'dev-docs'","sphinx-rtd-theme (>=0.5.0) ; extra == 'dev-docs'","flake8 (<5.1,>=5.0) ; extra == 'dev-lint'","isort (<5.11.0,>=5.10.0) ; extra == 'dev-lint'","coverage ; extra == 'dev-test'","pytest-asyncio (>=0.17) ; extra == 'dev-test'","pytest (>=3.10) ; extra == 'dev-test'","sphinx (<=4.3.2) ; extra == 'dev-test'","urllib3 (>=1.24.2) ; extra == 'requests'","requests (>=2.16.2) ; extra == 'requests'","pytz ; extra == 'timezone'"],"requires_python":">=3.7","summary":"Python Geocoding Toolbox","version":"2.4.1","yanked":false,"yanked_reason":null}

Dependency	Optional
geographiclib	false
aiohttp	true
coverage	true
flake8	true
isort	true
pytest	true
pytest-asyncio	true
pytz	true
readme-renderer	true
requests	true
sphinx	true
sphinx-issues	true
sphinx-rtd-theme	true
urllib3	true

Package search

geopy

project_urls

Dependencies

All package metadata

Releases