Skip to main content
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


If you are using Google Maps API for business pass your key and client id when
initializing GoogleGeocoderClient::

>>> geocoder = GoogleGeocoderClient(False, my_client_id, my_key)


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

Metadata

Release history Release notifications | RSS feed

This release

0.2 This release

0.1

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page