Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

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 https://github.com/thampiman/reverse-geocoder for performance comparison)

Supports Python 2 and 3. You can also load a custom data source. Fore more help, see https://github.com/thampiman/reverse-geocoder.

Example usage:
>>> import reverse_geocoder as rg
>>> coordinates = (51.5214588,-0.1729636),(9.936033, 76.259952),(37.38605,-122.08385)
>>> rg.search(coordinates)
[{'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 hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page