Skip to main content

Fast, offline reverse geocoder

Project description

Reverse Geocoder takes a latitude / longitude coordinate and returns the nearest town/city. This library improves on an existing library called reverse_geocode developed by Richard Penman in the following ways: 1. Besides city and country, this library also returns the administrative 1 & 2 regions, latitude and longitude 2. The performance is much faster since a parallelized K-D tree is implemented (See for performance comparison)

Supports Python 2 and 3. You can also load a custom data source. Fore more help, see

Example usage:
>>> import reverse_geocoder as rg
>>> coordinates = (51.5214588,-0.1729636),(9.936033, 76.259952),(37.38605,-122.08385)
[{'name': 'Bayswater',
  'cc': 'GB',
  'lat': '51.51116',
  'lon': '-0.18426',
  'admin1': 'England',
  'admin2': 'Greater London'},
 {'name': 'Cochin',
  'cc': 'IN',
  'lat': '9.93988',
  'lon': '76.26022',
  'admin1': 'Kerala',
  'admin2': 'Ernakulam'},
 {'name': 'Mountain View',
  'cc': 'US',
  'lat': '37.38605',
  'lon': '-122.08385',
  'admin1': 'California',
  'admin2': 'Santa Clara County'}]

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for reverse_geocoder, version 1.5.1
Filename, size File type Python version Upload date Hashes
Filename, size reverse_geocoder-1.5.1.tar.gz (2.2 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page