simple_geocoder¶ ↑

Simple Ruby interface to the Google Geocoding Service API V3 code.google.com/apis/maps/documentation/geocoding/

• returns results in parsed JSON format

• API configuration in config/api.yml

require 'rubygems'
require 'simple_geocoder'
result = SimpleGeocoder::Geocoder.new.geocode('2000 28th St, Boulder, CO')
puts result['results'][0]['geometry']['location'].inspect # => {"lat"=> 40.0185510,"lng"=> -105.2582644}

Accepts optional parameters as a hash, keyed by parameter name symbols. Optional parameters include: bounds, region, language, sensor. Default region is ‘us’. Default sensor value is ‘false’

Example for region parameter:

result =  SimpleGeocoder::Geocoder.new.geocode("Toledo",{:region=>'es'})

returns location for Toledo, Spain.

Example for bounds (viewport biasing):

result =  SimpleGeocoder::Geocoder.new.geocode("Winnetka", { :bounds => "34.172684,-118.604794|34.236144,-118.500938" } )

Returns location for Winnetka in California instead of Illinois.

• JSON flori.github.com/json/doc/index.html

Copyright © 2010, 2011, 2012 Ying Tsen Hong. See LICENSE for details