Geocoder: Simple, Consistent

Release v1.17.3. (Installation)

Simple and consistent geocoding library written in Python.

Many online providers such as Google & Bing have geocoding services, these providers do not include Python libraries and have different JSON responses between each other.

It can be very difficult sometimes to parse a particular geocoding provider since each one of them have their own JSON schema.

Here is a typical example of retrieving a Lat & Lng from Google using Python, things shouldn’t be this hard.

>>> import requests
>>> url = 'https://maps.googleapis.com/maps/api/geocode/json'
>>> params = {'sensor': 'false', 'address': 'Mountain View, CA'}
>>> r = requests.get(url, params=params)
>>> results = r.json()['results']
>>> location = results[0]['geometry']['location']
>>> location['lat'], location['lng']
(37.3860517, -122.0838511)

Now lets use Geocoder to do the same task.

>>> import geocoder
>>> g = geocoder.google('Mountain View, CA')
>>> g.latlng
(37.3860517, -122.0838511)

Testimonials

Tobias Siebenlist

Geocoder: great geocoding library by @DenisCarriere.

mcbetz

Very good companion for Geocoder. Glad to see Python getting more geo libraries for Non-GIS users.

API Documentation

If you are looking for information on a specific function, class or method, this part of the documentation is for you.

Providers

Detailed information about each individual provider that are within Geocoder.

Contributor Guide

If you want to contribute to the project, this part of the documentation is for you.