README.rdoc in whatser-0.5.0 vs README.rdoc in whatser-0.6.0

- old
+ new

@@ -25,11 +25,11 @@ Declare Whatser in your Gemfile: gem 'whatser', :git => "git@github.com:sogeo/whatser" -And instantiate a Whatser client as need: +And instantiate a Whatser client as needed: client = Whatser::Client.new(:api_key => 'key', :api_secret => 'secret', :oauth_token => '123abc', :logger => Rails.logger) or... @@ -64,11 +64,11 @@ Once you have an oauth token for a user, you can access the Whatser API by instantiating a Whatser client and making calls using the Whatser resource classes. e.g. client = Whatser::Client.new( :oauth_token => '123abc' ) client.authorized? - authenticated_user = client.user.me + authenticated_user = client.users.me spots = client.spots.search(:geo => "52.3665312,4.8931739", :text => "pizza", :per_page => 30).data spots.each { |spot| spot.tag('my tag') } a_spot = client.spots.find(12345).data my_spot = client.spots.create(:name => 'work', :street => 'main street', 'city' => 'metropolis').data new_spot = client.spots.new(:name => 'work', :street => 'main street', 'city' => 'metropolis') @@ -138,9 +138,16 @@ results = m.tags results = m.activity <Whatser::Poi @lng=4.0, @region="Noord Holland", @gowalla_id="123456", @lat=52.0, @tag_list=nil, @city="Amsterdam", @name="Example Spot", @country="Netherlands", @street="example street", @id=101, @postal_code="1012", @foursquare_id="123456", @created_at="2010-12-24T16:46:23Z"> +You can also lists of users who have interacted with a spot in some way, either by checking-in or by adding it to their collection. These methods can be called directly from a spot, or by the User class. + + users = my_spot.visitors( :page => 1, :per_page => 10 ) + users = my_spot.collectors( :page => 1, :per_page => 10 ) + + users = Whatser.client.users.visitors(spot_id, :page => 1, :per_page => 10 ) + users = Whatser.client.users.collectors(spot_id, :page => 1, :per_page => 10 ) === Collections A collection is a set of spots of particular interest to a user. By adding spots to their personal collection, users build a list of their favorite locations around a city.