Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Ruby wrapper for Yahoo!'s FireEagle
branch: master

bump version

Signed-off-by: Jesse Newland <>
latest commit b2a5e1dd38
@mojodna mojodna authored committed
Failed to load latest commit information.
config updated Manifest and deps
script rubyforge jumping jacks. github needs a gem server and automatic rdoc…
spec Added missing response elements
tasks Make spec the default Rake task
.gitignore rethinking the version number
History.txt support for OAuth 1.0a
License.txt cleanup before push to rubyforge
Manifest.txt updated Manifest and deps
README.txt document github repo
Rakefile rubyforge jumping jacks. github needs a gem server and automatic rdoc…
fireeagle.gemspec bump version
setup.rb initial import


FireEagle[] (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.

== Installation

 gem install fireeagle
== Usage

  >> require 'fireeagle'
  >> client =
    :consumer_key        => "<consumer key>",
    :consumer_secret     => "<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
  => #<FireEagle::User:0x1ca5e08 ... >
  >> user.locations
  => [#<FireEagle::Location:0x1cdd9e8 ...>, #<FireEagle::Location:0x1cc8ffc ...>, ... ]
  >> user.best_guess
  => #<FireEagle::Location:0x1cdd9e8 ...>
  => "Punta del Diablo, Uruguay"
  # lookup a location
  >> locations = client.lookup(:q => "30022")
  => [#<FireEagle::Location:0x1cdd9e8 ...>, #<FireEagle::Location:0x1cc8ffc ...>, ...]
  >> => "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

== Contributing You know what to do.

Rubyforge Project Page::
Author::    Jesse Newland ( ([])
Copyright:: Copyright (c) 2008 Jesse Newland. Portions[] Copyright (c) 2008 Yahoo!
License::   Distributed under the same terms as Ruby
Something went wrong with that request. Please try again.