GoogleMapsGeocoder

A simple Plain Old Ruby Object wrapper for geocoding with Google Maps.

Installation

Add GoogleMapsGeocoder to your Gemfile and run bundle:

  gem 'google_maps_geocoder'

Or try it out in irb with:

  require './lib/google_maps_geocoder/google_maps_geocoder'

chez_barack = GoogleMapsGeocoder.new '1600 Pennsylvania Washington'

Get the complete, formatted address:

chez_barack.formatted_address
 => "1600 Pennsylvania Avenue Northwest, President's Park, Washington, DC 20500, USA"

...standardized name of the city:

chez_barack.city
 => "Washington"

...full name of the state or region:

chez_barack.state_long_name
 => "District of Columbia"

...standard abbreviation for the state/region:

chez_barack.state_short_name
 => "DC"

The complete, hopefully self-explanatory, API is:

To have GoogleMapsGeocoder use your Google Maps API key, set it as an environment variable:

export GOOGLE_MAPS_API_KEY=[your key]

Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
Fork the project
Start a feature/bugfix branch
Commit and push until you are happy with your contribution
Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.