Overview

About

Python-Geocoder is a simple library that uses Google Maps API for geocoding.

Usage

As python library:

>>> from geocode.google import GoogleGeocoderClient

>>> geocoder = GoogleGeocoderClient(False) # must specify sensor parameter explicitely
>>> result = geocoder.geocode("massasauga park")

>>> result.is_success()
True

>>> len(result)
3

# by default all get_*() methods will fetch the first result:
>>> result.get_formatted_address()
u'The Massasauga Provincial Park, The Archipelago, ON, Canada'

# but you can also pass it an index parameter:
>>> result.get_formatted_address(2)
u'Massasauga Prairie Nature Preserve, Roseville, IL 61417, USA'

>>> result.get_location()
(Decimal('45.19526590'), Decimal('-80.05372229999999'))

>>> result.get_location_type()
u'APPROXIMATE'

# each result object is an iterator containing nested dictionaries according to
# Google geocoding specifications (http://code.google.com/apis/maps/documentation/geocoding/)
>>> for r in result: print r["formatted_address"]
The Massasauga Provincial Park, The Archipelago, ON, Canada
The Massasauga Provincial Park, RR 2, Parry Sound, ON P0G, Canada
Massasauga Prairie Nature Preserve, Berwick, IL 61417, USA

geocode/google-geocoder.py is a command line tool. A sample usage:

$ python geocode/google.py -a "massasauga park"
The Massasauga Provincial Park, The Archipelago, ON, Canada (45.19526590, -80.05372229999999) - APPROXIMATE
The Massasauga Provincial Park, RR 2, Parry Sound, ON P0G, Canada (45.1969970, -80.0398220) - APPROXIMATE
Massasauga Prairie Nature Preserve, Roseville, IL 61417, USA (40.76002530, -90.57780330) - APPROXIMATE

For more usage information run:

$ python geocode/google.py --help
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.