GpsFu
=====
This is a Location Based Services API for Ruby and for Ruby on Rails. It currently
supports translation of MyGPSId address_ids into geocoded data. Queries will return 
Hpricot documents that you can use to find address elements in the return packet. 
You can also pass those Hpricot documents to a Location object and use it instead. 

Installing
==========

    script/plugin install git://github.com/peteonrails/gps_fu.git
    
Example
=======
To turn an address id of "pete@work" into a geo-approximate location packet, do the following: 

@hpricot_doc = GPSFu::MyGPSId::Client.id_to_geocode("pete@work", :api_key=>"mykey")

# now you can find out approximately where I am: 
puts (@hpricot_doc.xml/"address/city").inner_html # "Bethesda"
puts (@hpricot_doc.xml/"address/country-code").inner_html # "US"

Or, if you'd rather not parse the Hpricot document, you can use the included Location class:

@loc = Location.new(GPSFu::MyGPSId::Client.id_to_geocode("pete@work", :api_key=>"mykey"))

puts @loc.city
puts @loc.country_code
puts @loc.lat # latitude
puts @loc.lng # longitude
puts @loc.postal_code
puts @loc.postal_district
puts @loc.state

Consideration
=============
If you like this software and use it, please consider recommending me on Working With Rails. 
I don't want donations: a simple up-vote would make my day. My profile is: 
http://www.workingwithrails.com/person/12521-peter-jackson
To go directly to the "Recommend Me" screen: 
http://www.workingwithrails.com/recommendation/new/person/12521-peter-jackson

Copyright (c) 2008 Peter Jackson, released under the MIT license