{"id":13412267,"url":"https://github.com/geopy/geopy","last_synced_at":"2025-05-14T21:02:19.055Z","repository":{"id":830462,"uuid":"547504","full_name":"geopy/geopy","owner":"geopy","description":"Geocoding library for Python.","archived":false,"fork":false,"pushed_at":"2024-08-14T15:31:25.000Z","size":2669,"stargazers_count":4619,"open_issues_count":47,"forks_count":658,"subscribers_count":88,"default_branch":"master","last_synced_at":"2025-04-22T16:47:50.982Z","etag":null,"topics":["geocoder","geocoding","python"],"latest_commit_sha":null,"homepage":"https://geopy.readthedocs.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/geopy.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2010-03-04T22:05:28.000Z","updated_at":"2025-04-21T00:42:17.000Z","dependencies_parsed_at":"2023-07-05T18:47:53.545Z","dependency_job_id":"dce2113f-20bc-4061-8b24-ab427ea0c822","html_url":"https://github.com/geopy/geopy","commit_stats":{"total_commits":1086,"total_committers":135,"mean_commits":8.044444444444444,"dds":0.5128913443830572,"last_synced_commit":"f495974c32a7a7b1eb433e7b8c87166e96375c32"},"previous_names":[],"tags_count":68,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geopy%2Fgeopy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geopy%2Fgeopy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geopy%2Fgeopy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geopy%2Fgeopy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/geopy","download_url":"https://codeload.github.com/geopy/geopy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252835102,"owners_count":21811480,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["geocoder","geocoding","python"],"created_at":"2024-07-30T20:01:22.808Z","updated_at":"2025-05-07T07:39:22.047Z","avatar_url":"https://github.com/geopy.png","language":"Python","readme":"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\u0026style=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 \u003chttps://github.com/geopy/geopy/blob/master/LICENSE\u003e`__.\n\nInstallation\n------------\n\nInstall using `pip \u003chttp://www.pip-installer.org/en/latest/\u003e`__ with:\n\n::\n\n    pip install geopy\n\nOr, `download a wheel or source archive from\nPyPI \u003chttps://pypi.python.org/pypi/geopy\u003e`__.\n\nGeocoding\n---------\n\nTo geolocate a query to an address and coordinates:\n\n.. code:: pycon\n\n    \u003e\u003e\u003e from geopy.geocoders import Nominatim\n    \u003e\u003e\u003e geolocator = Nominatim(user_agent=\"specify_your_app_name_here\")\n    \u003e\u003e\u003e location = geolocator.geocode(\"175 5th Avenue NYC\")\n    \u003e\u003e\u003e print(location.address)\n    Flatiron Building, 175, 5th Avenue, Flatiron, New York, NYC, New York, ...\n    \u003e\u003e\u003e print((location.latitude, location.longitude))\n    (40.7410861, -73.9896297241625)\n    \u003e\u003e\u003e 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    \u003e\u003e\u003e from geopy.geocoders import Nominatim\n    \u003e\u003e\u003e geolocator = Nominatim(user_agent=\"specify_your_app_name_here\")\n    \u003e\u003e\u003e location = geolocator.reverse(\"52.509669, 13.376294\")\n    \u003e\u003e\u003e print(location.address)\n    Potsdamer Platz, Mitte, Berlin, 10117, Deutschland, European Union\n    \u003e\u003e\u003e print((location.latitude, location.longitude))\n    (52.5094982, 13.3765983)\n    \u003e\u003e\u003e 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\u003chttps://en.wikipedia.org/wiki/Geodesics_on_an_ellipsoid\u003e`_ or the\n`great-circle distance\n\u003chttps://en.wikipedia.org/wiki/Great-circle_distance\u003e`_,\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    \u003e\u003e\u003e from geopy.distance import geodesic\n    \u003e\u003e\u003e newport_ri = (41.49008, -71.312796)\n    \u003e\u003e\u003e cleveland_oh = (41.499498, -81.695391)\n    \u003e\u003e\u003e 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    \u003e\u003e\u003e from geopy.distance import great_circle\n    \u003e\u003e\u003e newport_ri = (41.49008, -71.312796)\n    \u003e\u003e\u003e cleveland_oh = (41.499498, -81.695391)\n    \u003e\u003e\u003e 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 \u003chttp://geopy.readthedocs.io/en/latest/\u003e`__.\n","funding_links":[],"categories":["Python","Geolocation","资源列表","地理Geo处理","地理位置","Geospatial Library","🐍 Python","Geolocation [🔝](#readme)","کتابخانه هاي جغرافيا","Awesome Python","Feature Extraction","Maps"],"sub_categories":["地理位置","Python","Useful Python Tools for Data Analysis","کار با زمان و تقویم","Geolocation","Drone Frames","Geocoding"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeopy%2Fgeopy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeopy%2Fgeopy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeopy%2Fgeopy/lists"}