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.

Source Distribution

reverse_geocoder-1.5.1.tar.gz (2.2 MB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page