python-geocoder 0.1

About
=====

Python-Geocoder is a simple library that uses Google Maps APIs 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 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 is a dictionary based on Google geocoding API specification
>>> 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