Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jnewland/fireeagle

Ruby wrapper for Yahoo!'s FireEagle
https://github.com/jnewland/fireeagle

Last synced: about 1 month ago
JSON representation

Ruby wrapper for Yahoo!'s FireEagle

Awesome Lists containing this project

README

        

FireEagle[http://fireeagle.yahoo.net] (FE) is a system providing centralized
management of user location information. FE allows 3rd party developers to
pdate and/or access user's location data.

http://fireeagle.yahoo.net/developer/documentation

== Installation

gem install fireeagle

== Usage

>> require 'fireeagle'
>> client = FireEagle::Client.new(
:consumer_key => "",
:consumer_secret => "",
:access_token => "[access token]",
:access_token_secret => "[access token secret]")

==== With a User-specific OAuth Access Token

# update your location
>> client.update(:q => "punta del diablo, uruguay") # I wish
# query your location
>> user = client.user
=> #
>> user.locations
=> [#, #, ... ]
>> user.best_guess
=> #
>> user.best_guess.name
=> "Punta del Diablo, Uruguay"
# lookup a location
>> locations = client.lookup(:q => "30022")
=> [#, #, ...]
>> locations.first.name => "Alpharetta, GA 30022"
>> locations.first.place_id => "IrhZMHuYA5s1fFi4Qw"

== Authorization

Authorization is handled by OAuth. For more details about the OAuth
authorization flow and how it differs based on your application type, please
see http://fireeagle.yahoo.net/developer/documentation/authorizing

== Contributing

http://github.com/jnewland/fireeagle/tree/master. You know what to do.

Rubyforge Project Page:: http://rubyforge.org/projects/fireeagle
Author:: Jesse Newland (http://soylentfoo.jnewland.com) ([email protected][mailto:[email protected]])
Copyright:: Copyright (c) 2008 Jesse Newland. Portions[http://pastie.caboo.se/private/oevvkdzl0zrdkf8s7hetg] Copyright (c) 2008 Yahoo!
License:: Distributed under the same terms as Ruby