{"library":"reverse-geocoder","title":"Reverse Geocoder","description":"Reverse Geocoder is a fast, offline Python library designed to convert geographic coordinates (latitude, longitude) into human-readable location data such as city, country, and administrative regions. It improves upon an existing library by utilizing a parallelized K-D tree for enhanced performance, especially for large inputs. The library uses GeoNames data, with a default population filter of >1000, and allows for custom data sources. The current version is 1.5.1, with its last release in September 2016, indicating a maintenance phase rather than active development.","language":"python","status":"maintenance","last_verified":"Sun May 17","install":{"commands":["pip install reverse-geocoder"],"cli":null},"imports":["import reverse_geocoder as rg"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import reverse_geocoder as rg\n\n# List of (latitude, longitude) tuples\ncoordinates = [\n    (51.521458, -0.138850), # London\n    (35.689487, 139.691706), # Tokyo\n    (40.7127837, -74.0059413) # New York City\n]\n\n# Perform reverse geocoding\nresults = rg.search(coordinates)\n\n# Print the results\nfor coord, result in zip(coordinates, results):\n    print(f\"Coordinates: {coord} -> Found: {result['name']}, {result['admin1']}, {result['cc']}\")\n\n# Expected output format (values may vary slightly based on data source)\n# Coordinates: (51.521458, -0.13885) -> Found: London, England, GB\n# Coordinates: (35.689487, 139.691706) -> Found: Tokyo, Tōkyō, JP\n# Coordinates: (40.7127837, -74.0059413) -> Found: New York City, New York, US","lang":"python","description":"This quickstart demonstrates how to import the library and perform reverse geocoding for a list of coordinate pairs. The `search` function returns a list of dictionaries, each containing details like city name, administrative regions, country code, and the nearest latitude/longitude from its internal database.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-17","installed_version":"1.5.1","pypi_latest":"1.5.1","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":10.1,"avg_import_s":1.26,"wheel_type":"sdist"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"reverse-geocoder","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.06,"mem_mb":23.4,"disk_size":"239.8M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"reverse-geocoder","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":9.4,"import_time_s":0.82,"mem_mb":23.4,"disk_size":"231M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"reverse-geocoder","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.73,"mem_mb":26.9,"disk_size":"255.6M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"reverse-geocoder","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":9.1,"import_time_s":1.48,"mem_mb":26.9,"disk_size":"245M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"reverse-geocoder","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.56,"mem_mb":26.2,"disk_size":"239.4M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"reverse-geocoder","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":11.3,"import_time_s":1.6,"mem_mb":26.2,"disk_size":"228M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"reverse-geocoder","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.32,"mem_mb":25.7,"disk_size":"238.2M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"reverse-geocoder","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":9.8,"import_time_s":1.45,"mem_mb":25.7,"disk_size":"227M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"reverse-geocoder","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.77,"mem_mb":20.4,"disk_size":"242.1M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"reverse-geocoder","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":10.7,"import_time_s":0.86,"mem_mb":20.4,"disk_size":"238M"}]}}