1. Samuel Martin
  2. pygeocoder




Xiao Yu Sébastien Fievet Marius Grigaitis 19/03/2010

Based on googlemaps 1.0.2 by John Kleint


This is a Python wrapper for Google Geocoding API V3

It allows you to directly convert an address to coordinates or vice versa. It also allows you to validate, format and split addresses into civic number, street name, city etc.




It has dependency on the json module, included with Python versions 2.6 and later and available for download as simplejson for earlier versions. functools is needed and included in Python 2.5. Requirement for hmac is included with Python 2.2. hashlib depends on Python 2.5. base64 depends on Python 2.4.

requests library is needed and installed by setuptools.

It is developed on Python 2.7 but should work on earlier versions. It is also compatible with Python 3.


You can install this package using pip:

sudo pip install pygeocoder

or download the source from http://code.xster.net/pygeocoder and install

python setup.py install


Please refer to http://code.xster.net/pygeocoder/wiki for help with usage

Contact Information

Author: Xiao Yu Internet: http://code.xster.net/pygeocoder

For comments, issues, requests, please contact via BitBucket at the above website


Version Another dependency fix

Version 1.2.1 Proxy support

Version setup.py dependency fix

Version Minor setup.py Python 3 fix

Version setup.py dependency fix

Version 1.2 Refactor and unit testing Changed license to BSD Python 3 compatibility Business API account support

Version 1.1.4 Fixed UTF-8 and facilitated command line usage

Version 1.1.3 Made Geocoder methods static method while backward compatible

Version 1.1.2 Added address validation

Version 1.1.1 Returns GeocoderResult by default. Result set accessible by iterator or index.

Version 1.1 Added GeocoderResult in order to ease field retrieval/result parsing.

Version 1.0 Working version an API V3.