reverse-geocode

What it is and what it does

Reverse Geocode is a Python library that maps latitude/longitude coordinates to their nearest known geographic location (country, state, city) using offline lookup rather than a web API. It structures geonames data into a k-d tree for efficient nearest-neighbor searches, making it practical for bulk geocoding tasks where calling an external service would be impractical or undesirable.

The package depends on numpy and scipy for its spatial indexing and numerical operations. Results are returned as dictionaries containing country code, country name, state, city, population, and exact coordinates of the matched location. You can filter results by minimum population to prefer larger cities over nearby smaller ones, though the package notes that point-based lookup gives only a rough approximation compared to polygon-based geographic systems.

Use it for:

• Batch reverse geocoding thousands of GPS coordinates from a dataset without hitting rate limits or API costs
• Finding the nearest city to a set of sensor readings or IoT device locations in an offline or air-gapped environment
• Filtering location results by population threshold to prioritize major cities over small towns in proximity searches
• Building location-aware analytics on historical coordinate data where real-time API access is not available

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Reverse Geocode converts latitude/longitude coordinates to the nearest known country, state, and city using a k-d tree lookup against geonames data, without requiring a web API.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and solves a specific problem (offline bulk reverse geocoding) that web APIs handle poorly. The LGPL license is permissive for non-modifying use. Install it if you need to map coordinates to cities at scale without external dependencies.

Install

reverse-geocode on PyPI

pip install reverse-geocode

uv add reverse-geocode

poetry add reverse-geocode

Installing reverse-geocode

Before you install

Low friction install with only numpy and scipy as runtime dependencies. The package is actively maintained with a recent commit on 2026-08-01 and has been stable since its first release in 2015.

License in practice

Licensed under LGPL (copyleft), which requires that derivative works and modifications remain under the same license; using this package in proprietary software is permissible if you do not modify it, but modifications must be shared under LGPL terms.

Quickstart

pip install reverse-geocode

import reverse_geocode
melbourne_coord = -37.81, 144.96
result = reverse_geocode.get(melbourne_coord)
print(result)

Verify before relying

• Whether the package supports batch processing of very large coordinate sets efficiently
• How frequently the underlying geonames data is updated in the package
• Accuracy limitations beyond the note that it is point-based rather than polygon-based

Package facts

Evidence: reverse_geocode-1.6.6-py3-none-any.whl

Tags

More Information Analysis packages