Google

Geocoding is the process of converting addresses (like “1600 Amphitheatre Parkway, Mountain View, CA”) into geographic coordinates (like latitude 37.423021 and longitude -122.083739), which you can use to place markers or position the map. Using Geocoder you can retrieve google’s geocoded data from Google Geocoding API.

Geocoding

>>> import geocoder
>>> g = geocoder.google('Mountain View, CA')
>>> g.json
...

Reverse Geocoding

>>> import geocoder
>>> g = geocoder.google([45.15, -75.14], method='reverse')
>>> g.json
...

Timezone

>>> import geocoder
>>> g = geocoder.google([45.15, -75.14], method='timezone')
>>> g.timeZoneName
'Eastern Daylight Time'
>>> g.timeZoneId
'America/Toronto'
>>> g.dstOffset
3600
>>> g.rawOffset
-18000

Component Filtering

>>> g = geocoder.google("Santa Cruz", components="country:ES")

Read me at Google’s Geocoding API

https://developers.google.com/maps/documentation/geocoding/intro#ComponentFiltering

Places

>>> import geocoder
>>> g = geocoder.google('white house', method='places')
>>> g.latlng
[38.8976763, -77.0365298]
>>> g.address
u'1600 Pennsylvania Ave NW, Washington, DC 20500, United States'
>>> g.json
...

Elevation

>>> import geocoder
>>> g = geocoder.google([45.15, -75.14], method='elevation')
>>> g.meters
71.0
>>> g.feet
232.9
>>> g.resolution
38.17580795288086

Command Line Interface

$ geocode 'Mountain View, CA' --provider google
$ geocode 'white house' --provider google --method places
$ geocode '45.15, -75.14' --provider google --method reverse
$ geocode '45.15, -75.14' --provider google --method timezone
$ geocode '45.15, -75.14' --provider google --method elevation

Environment Variables

To make sure your API key is stored safely on your computer, you can define that API key using your system’s environment variables.

$ export GOOGLE_API_KEY=<Secret API Key>
$ export GOOGLE_CLIENT=<Secret Client>
$ export GOOGLE_CLIENT_SECRET=<Secret Client Secret>

Parameters

  • location: Your search location you want geocoded.
  • key: Your Google developers free key.
  • language: 2-letter code of preferred language of returned address elements.
  • client: Google for Work client ID. Use with client_secret. Cannot use with key parameter
  • client_secret: Google for Work client secret. Use with client.
  • proximity: Search within given area (bbox, bounds, or around latlng)
  • method: (default=geocode) Use the following:
    • geocode
    • reverse
    • timezone
    • elevation
    • places