google_places 0.0.1

data/.gitignore

@@ -0,0 +1,9 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.rvmrc
+.rspec
+spec/api_key.rb
+.yardoc/
+doc/

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in google_places.gemspec
+gemspec

data/README.rdoc

@@ -0,0 +1,55 @@
+= Google Places
+
+This gem provides a Ruby wrapper around the Google Places API, using HTTParty. At this moment the gem does
+not support OAuth authentication and will only work with an API key.
+
+
+== Obtaining an API key
+
+To be able to use this gem, you'll need a Google Places API key. To request an API key, point your browser to
+https://code.google.com/apis/console and follow the instructions there. You'll find your API key on the
+*API Access* tab under *Simple API Access*.
+
+
+== Installing the gem
+
+To use this gem, install it with <tt>gem install google_places</tt> or add it to your Gemfile:
+
+  gem 'google_places'
+
+And install it with <tt>bundle install</tt>
+
+
+== Usage
+
+=== The spot
+
+Each of the API methods below returns a <tt>GooglePlaces::Spot</tt> or a collection of those. Each of these
+objects has these attributes:
+
+* *reference*: a token to query the Google Places API for more details about the spot
+* *vicinity*: the street or neighborhood of the spot
+* *lat*: the latitude of the spot
+* *lng*: the longitude of the spot
+* *name*: the name of the spot
+* *icon*: a URL to the icon of this spot
+
+=== Retrieving a list of spots
+
+First register a new Client:
+
+  @client = GooglePlaces::Client.new(API_KEY)
+
+Then retrieve a list of spots:
+
+  @client.spots(-33.8670522, 151.1957362)
+
+=== Retrieving a single spot
+
+First register a new Client:
+
+  @client = GooglePlaces::Client.new(API_KEY)
+
+Then retrieve the spot:
+
+  @client.spot('CmRYAAA...upoTH3g')

data/Rakefile

@@ -0,0 +1,7 @@
+require 'bundler'
+require 'rspec/core/rake_task'
+
+Bundler::GemHelper.install_tasks
+RSpec::Core::RakeTask.new('spec')
+
+task :default => :spec

data/google_places.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "google_places"
+  s.version     = '0.0.1'
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Marcel de Graaf"]
+  s.email       = ["mail@marceldegraaf.net"]
+  s.homepage    = "http://marceldegraaf.net"
+  s.summary     = %q{A Ruby wrapper around the Google Places API.}
+  s.description = %q{This gem provides a Ruby wrapper around the Google Places API for use in your own project. Please note that this gem does not provide OAuth authentication.}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency 'httparty'
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'fakeweb'
+  s.add_development_dependency 'vcr'
+end

data/lib/google_places.rb

@@ -0,0 +1,7 @@
+require 'rubygems'
+require 'httparty'
+
+
+%w(client location request spot).each do |file|
+  require File.join(File.dirname(__FILE__), 'google_places', file)
+end

data/lib/google_places/client.rb

@@ -0,0 +1,17 @@
+module GooglePlaces
+  class Client
+    attr_reader :api_key
+
+    def initialize(api_key)
+      @api_key = api_key
+    end
+
+    def spots(lat, lng, options = {})
+      Spot.list(lat, lng, @api_key, options)
+    end
+
+    def spot(reference, options = {})
+      Spot.find(reference, @api_key, options)
+    end
+  end
+end

data/lib/google_places/location.rb

@@ -0,0 +1,12 @@
+module GooglePlaces
+  class Location
+    def initialize(lat, lng)
+      @lat = lat
+      @lng = lng
+    end
+
+    def format
+      [ @lat, @lng ].join(',')
+    end
+  end
+end

data/lib/google_places/request.rb

@@ -0,0 +1,30 @@
+module GooglePlaces
+  class Request
+    attr_accessor :response
+
+    include ::HTTParty
+    format :json
+
+    SPOTS_LIST_URL = 'https://maps.googleapis.com/maps/api/place/search/json'
+    SPOT_URL = 'https://maps.googleapis.com/maps/api/place/details/json'
+
+    def self.spots(options = {})
+      request = new(SPOTS_LIST_URL, options)
+      request.parsed_response
+    end
+
+    def self.spot(options = {})
+      request = new(SPOT_URL, options)
+      request.parsed_response
+    end
+
+    def initialize(url, options)
+      @response = self.class.get(url, :query => options)
+    end
+
+    def parsed_response
+      @response.parsed_response
+    end
+
+  end
+end

data/lib/google_places/spot.rb

@@ -0,0 +1,44 @@
+module GooglePlaces
+  class Spot
+    attr_accessor :lat, :lng, :name, :icon, :reference, :vicinity
+
+    def self.list(lat, lng, api_key, options = {})
+      radius = options.delete(:radius) || 200
+      sensor = options.delete(:sensor) || false
+      location = Location.new(lat, lng)
+
+      response = Request.spots(
+        :location => location.format,
+        :radius => radius,
+        :sensor => sensor,
+        :key => api_key
+      )
+
+      response['results'].map do |result|
+        self.new(result)
+      end
+    end
+
+    def self.find(reference, api_key, options = {})
+      sensor = options.delete(:sensor) || false
+
+      response = Request.spot(
+        :reference => reference,
+        :sensor => sensor,
+        :key => api_key
+      )
+
+      self.new(response['result'])
+    end
+
+    def initialize(json_result_object)
+      @reference = json_result_object['reference'],
+      @vicinity  = json_result_object['vicinity'],
+      @lat       = json_result_object['geometry']['location']['lat'],
+      @lng       = json_result_object['geometry']['location']['lng'],
+      @name      = json_result_object['name'],
+      @icon      = json_result_object['icon']
+    end
+
+  end
+end

data/spec/api_key.sample.rb

@@ -0,0 +1 @@
+RSPEC_API_KEY = 'abc123'

data/spec/google_places/client_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe GooglePlaces::Client do
+
+  it 'should not initialize without an api_key' do
+    lambda { GooglePlaces::Client.new }.should raise_error
+  end
+
+  it 'should initialize with an api_key' do
+    @client = GooglePlaces::Client.new(api_key)
+    @client.api_key.should == api_key
+  end
+
+  it 'should request spots' do
+    lat, lng = '-33.8670522', '151.1957362'
+    @client = GooglePlaces::Client.new(api_key)
+    GooglePlaces::Spot.should_receive(:list).with(lat, lng, api_key, {})
+
+    @client.spots(lat, lng)
+  end
+
+  it 'should request a single spot' do
+    reference = "CoQBeAAAAO-prCRp9Atcj_rvavsLyv-DnxbGkw8QyRZb6Srm6QHOcww6lqFhIs2c7Ie6fMg3PZ4PhicfJL7ZWlaHaLDTqmRisoTQQUn61WTcSXAAiCOzcm0JDBnafqrskSpFtNUgzGAOx29WGnWSP44jmjtioIsJN9ik8yjK7UxP4buAmMPVEhBXPiCfHXk1CQ6XRuQhpztsGhQU4U6-tWjTHcLSVzjbNxoiuihbaA"
+    @client = GooglePlaces::Client.new(api_key)
+    GooglePlaces::Spot.should_receive(:find).with(reference, api_key, {})
+
+    @client.spot(reference)
+  end
+
+end

data/spec/google_places/location_spec.rb

@@ -0,0 +1,9 @@
+require 'spec_helper'
+
+describe GooglePlaces::Location do
+
+  it 'should return a location based on a lat and lng' do
+    GooglePlaces::Location.new('123', '456').format.should == '123,456'
+  end
+
+end

data/spec/google_places/request_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+describe GooglePlaces::Request do
+
+  before :each do
+    @location = GooglePlaces::Location.new('-33.8670522', '151.1957362').format
+    @radius = 200
+    @sensor = false
+    @reference = "CoQBeAAAAO-prCRp9Atcj_rvavsLyv-DnxbGkw8QyRZb6Srm6QHOcww6lqFhIs2c7Ie6fMg3PZ4PhicfJL7ZWlaHaLDTqmRisoTQQUn61WTcSXAAiCOzcm0JDBnafqrskSpFtNUgzGAOx29WGnWSP44jmjtioIsJN9ik8yjK7UxP4buAmMPVEhBXPiCfHXk1CQ6XRuQhpztsGhQU4U6-tWjTHcLSVzjbNxoiuihbaA"
+  end
+
+  context 'Listing spots' do
+    use_vcr_cassette 'list_spots'
+
+    it 'should retrieve a list of spots' do
+      response = GooglePlaces::Request.spots(
+        :location => @location,
+        :radius => @radius,
+        :sensor => @sensor,
+        :key => api_key
+      )
+
+      response['results'].should_not be_empty
+    end
+  end
+
+  context 'Spot details' do
+    use_vcr_cassette 'single_spot'
+
+    it 'should retrieve a single spot' do
+      response = GooglePlaces::Request.spots(
+        :reference => @reference,
+        :sensor => @sensor,
+        :key => api_key
+      )
+
+      response['result'].should_not be_empty
+    end
+  end
+
+end

data/spec/google_places/spot_spec.rb

@@ -0,0 +1,43 @@
+require 'spec_helper'
+
+describe GooglePlaces::Spot do
+
+  before :each do
+    @lat = '-33.8670522'
+    @lng = '151.1957362'
+    @radius = 200
+    @sensor = false
+    @reference = "CoQBeAAAAO-prCRp9Atcj_rvavsLyv-DnxbGkw8QyRZb6Srm6QHOcww6lqFhIs2c7Ie6fMg3PZ4PhicfJL7ZWlaHaLDTqmRisoTQQUn61WTcSXAAiCOzcm0JDBnafqrskSpFtNUgzGAOx29WGnWSP44jmjtioIsJN9ik8yjK7UxP4buAmMPVEhBXPiCfHXk1CQ6XRuQhpztsGhQU4U6-tWjTHcLSVzjbNxoiuihbaA"
+  end
+
+  context 'List spots' do
+    use_vcr_cassette 'list_spots'
+
+    before :each do
+      @collection = GooglePlaces::Spot.list(@lat, @lng, api_key, :radius => @radius, :sensor => @sensor)
+    end
+
+    it 'should be a collection of Spots' do
+      @collection.map(&:class).uniq.should == [GooglePlaces::Spot]
+    end
+  end
+
+  context 'Find a single spot' do
+    use_vcr_cassette 'single_spot'
+
+    before :each do
+      @spot = GooglePlaces::Spot.find(@reference, api_key, :sensor => @sensor)
+    end
+
+    it 'should be a Spot' do
+      @spot.class.should == GooglePlaces::Spot
+    end
+
+    %w(reference vicinity lat lng name icon).each do |attribute|
+      it "should have the attribute: #{attribute}" do
+        @spot.send(attribute).to_s.should_not be_empty
+      end
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,13 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'vcr_setup'
+require 'api_key'
+require 'google_places'
+
+def api_key
+  RSPEC_API_KEY
+end
+
+RSpec.configure do |config|
+  config.extend VCR::RSpec::Macros
+end

data/spec/vcr_cassettes/list_spots.yml

@@ -0,0 +1,326 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: https://maps.googleapis.com:443/maps/api/place/search/json?radius=200&sensor=false&key=AIzaSyATGBjcfrRXQtNEMMyt8Fw7tSGEY8PQwv0&location=-33.8670522%2C151.1957362
+    body: 
+    headers: 
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - application/json; charset=UTF-8
+      x-xss-protection: 
+      - 1; mode=block
+      server: 
+      - mafe
+      date: 
+      - Mon, 16 May 2011 20:56:23 GMT
+      cache-control: 
+      - private
+      vary: 
+      - Accept-Language
+    body: |
+      {
+        "status": "OK",
+        "results": [ {
+          "name": "Pyrmont",
+          "types": [ "locality", "political" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8695456,
+              "lng": 151.1945404
+            },
+            "viewport": {
+              "southwest": {
+                "lat": -33.8788097,
+                "lng": 151.1785330
+              },
+              "northeast": {
+                "lat": -33.8602805,
+                "lng": 151.2105478
+              }
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/geocode-71.png",
+          "reference": "CnRoAAAAZjKdehGj2kVxm9J7E0UoOGJo_bGXDThTlRlifDJlDlPGeEJ5yQ-2fUSofYhS3twtTZED0hhebpOYLA8b8VvR_9TkrrxfZXIg9S_UsHMYh_F5eABunplqLwAggfyWfch5YK5SqxazWa2WoQoz05H7IxIQyvxeUL8FrzZFAmdqRKrR6BoUknI6yaGcbMY6CyLuIyMRYmpdt4Y",
+          "id": "40840d476baa531e0227a353b1bef70262f66e7e"
+        }, {
+          "name": "Star City",
+          "vicinity": "Pyrmont Street, Pyrmont",
+          "types": [ "lodging", "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8682000,
+              "lng": 151.1945860
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/lodging-71.png",
+          "reference": "CnRhAAAAKjwqd8kGDNgdvMj2_VJjLqoizf80ohJLumWHxK6cY4E3MHZM92Y8lywFuFCPCo73dowC4U0vxqVTLP607XOw7ndmkexMRF22spdKNCgtfQcLVaC4tXKqUKjsjG9lALCHyIrTay4jbGNMZwcr4e2qRRIQtbUuBsA5rx65luq526M-VRoUGJUT7lIgHoSWDAk6tTG5Pv6zGTw",
+          "id": "be880205d64059c306bbf198f908b81cabb9f066"
+        }, {
+          "name": "Ripples at Sydney Wharf",
+          "vicinity": "Pirrama Road, Pyrmont",
+          "types": [ "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8667010,
+              "lng": 151.1973990
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
+          "reference": "CnRuAAAAboUpEekYUmyLEpeyN5g6dPpHB9HjZpNUJ8wQ4DVmfV0-4vyPJpBjMLXtqlH35vrVB_8Mp8Lxnw0m3mSCpbpGWg5yawiR5CKpkKhV4FGWOkFaU10U9yuN35MBPcQPZht73_TF8l_RWA4fKY293fR90BIQO_6doKC1JbNu_FoeFlSRSRoU3vuANKslG6fG_owbbMxYQll58iQ",
+          "id": "dd030d236b8ccdc525f7a40893eb492f8fc5d55d"
+        }, {
+          "name": "Google Sydney",
+          "vicinity": "Pirrama Road, Pyrmont",
+          "types": [ "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8669710,
+              "lng": 151.1958750
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
+          "reference": "CnRlAAAAvclMmIcKJtY2kLeOz_rqW3ikacM7LuFwnX1qD5PiDRrQCRO0v9cm6Mo7WYKGCIO_ngg5zoyfueoQVQxbdRPQoOHYouwI0kxI3EkzhfpI5t8lCRCu_wcx4RmG9-mQNesbfwRL7xdX9CTQKmlyzNJ3LBIQpoWWkt1UACMUMyf_u5J-wBoUF5QZuOBgOo2p_W67o10WnABV72k",
+          "id": "4f89212bf76dde31f092cfc14d7506555d85b5c7"
+        }, {
+          "name": "Signorelli Gastronomia",
+          "vicinity": "Trouton Place, Pyrmont",
+          "types": [ "restaurant", "food", "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8665470,
+              "lng": 151.1959410
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
+          "reference": "CnRuAAAA-wkpRsz-a-oCbui2nF7oE1laTV_2CGAqj4OjkpT2oi49JDG2egl89MjT7qGr59H8epStVq-Y91ZNMVZJoQXOGDrwgzdr3cFv-Q6ZSu8VQedz2sUOcehgL6-bvwbzdymfplRMgGm1wd6FMkSnEorvNxIQJJSCO5xFerHFlrHgAinPAhoU1h3gw1_Wq_WA678SKzN9u9_7hK4",
+          "id": "4d716a646c32978aa12d1057dcf9f503a20195c0"
+        }, {
+          "name": "Garden Buffet",
+          "vicinity": "Pyrmont Street, Pyrmont",
+          "types": [ "restaurant", "food", "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8681980,
+              "lng": 151.1945840
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
+          "reference": "CnRlAAAAUrboV7a3e4QO_4PUrx1SgoWrF5EBlsSYHWXea8yEY4Zj4kpHY4QrcPOYjiR6s900N-sfZk4_HjUPW9fq0TtVANyHVqnHoOZITHIYGJY9Lji640IGgRtiKod1C9hiKPxcjfdz4ENXC0dqGjiBU5lqCxIQB5r-0dXxGtLSYHga7z7sFBoUJF9uHMWgU_xDKYuLIoVqv3fh6fc",
+          "id": "eaf5d4b14ebeae84df661e1f6d593259abac83d4"
+        }, {
+          "name": "Astral",
+          "vicinity": "Pyrmont Street, Sydney",
+          "types": [ "restaurant", "food", "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8681980,
+              "lng": 151.1945840
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
+          "reference": "CmReAAAAehMqsOqjki53jOYHTSzNb3JPzx6K-hPgg2ngZajWjGCAiE4VxRRTsDX9kqx7EaRJbYNNeJSNO8L4WW81brQdxQj_cRoQyA2rG1xufcgn4UNa6d8RE2M4d_JoWhFR-qahEhD0zHl0SlHzGKtXbaU-ORSyGhRZKXSaWjD3gfzsuVp8YZLcrdD2CQ",
+          "id": "bceeb9b6d5ac2f9f2573bbed9e1b3240f1fd0e12"
+        }, {
+          "name": "Accenture",
+          "vicinity": "Pirrama Road, Pyrmont",
+          "types": [ "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8670840,
+              "lng": 151.1959500
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
+          "reference": "CoQBfgAAALEv8hs9sdLazHlXXwsxxZ2UOxL7cI5thGrPiEPzIWGzUO3kJ7AtOuFlZj1rrcohZ-IKd00HL75TI-zL-eeCjLLlQcwLJKDDEyhnxdfXpPXWKMSpctmNlFZzuc-q-5QT7zCiP_SkXD0_E8JhHiD4koirfgUaKrghycMPWF9Z4fNWEhCLxE4D2_vKwhxLy4v1qqElGhRtvU3-A-zgoHSs6um69bXj0ePdJg",
+          "id": "27e84d1acda19c14b9c7f5271242796891bc9c9e"
+        }, {
+          "name": "Fairfax Media",
+          "vicinity": "Darling Island Road, Pyrmont",
+          "types": [ "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8654620,
+              "lng": 151.1959830
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
+          "reference": "CnRlAAAA3s8dTF4shgM5feBxw8cyuuzghSaW2FcdNlAeWLh6s5JMUxF7W-oCnDczD3Q_zAxXki049KMI8nNboUNcq0FiqkfkOesd_DTt5M3XqfGJy-SA8ooF9Jg1YGp4YxnEH8OiXOba39RgNMB3fply8-CIDBIQrMlWAE9hX0WQw8F_T7EnlRoU94zo4ZY_wapa8_S3CxVv-FUYkT4",
+          "id": "3e2826e1b4b4e5cbee354260f687d14938e6068f"
+        }, {
+          "name": "Fairfax Media",
+          "vicinity": "Darling Island Road, Pyrmont",
+          "types": [ "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8652490,
+              "lng": 151.1961010
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
+          "reference": "CnRkAAAAkdvnxcBAPpeOMt3t-MmIJ0YMDqHgOrAq4RO8YcgNqcRtadnX_1Iej61nsIsgtMBeigVWBE4-Hrj7vR993RzpmmYkRqgIIXYxBqF911JkgZwMPVaQBJp6xb3MsWvBjYRKZa0LbSul89Rx14PVxdK_FhIQCWmL3fkjhn94Oz786uPF3xoUSwuum2vDZEa1EHT_cD8dNSAeHnA",
+          "id": "1f2ddcefca08ffc687247c1ecf209054336aebb8"
+        }, {
+          "name": "John Holland",
+          "vicinity": "Pirrama Rd, Pyrmont",
+          "types": [ "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8687940,
+              "lng": 151.1968300
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
+          "reference": "CnRjAAAAtKWuPt-xPqEuys5kHwscxex99t4OWVpG8s-3IDLwDCJtT72Fq9JDSMqBTtNx0Tj-jdZ_QGy80KnYbBB0wWMs3pwXXFXoGub0pivpPpBi5JpJ_lnljyscthh6vIKECl9JQtF_798os9rL8D7iWKZx7BIQ4Bex-MXFyB1ytBcB9w5H_xoUqeAM8bsU5C3t_T6xe46j_tuPdis",
+          "id": "61178ac5b42a4045c415fffdf6d474ba9b08d068"
+        }, {
+          "name": "Seans Kitchen",
+          "vicinity": "Pyrmont Street, Pyrmont",
+          "types": [ "restaurant", "food", "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8681980,
+              "lng": 151.1945840
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
+          "reference": "CnRkAAAAYCQHi4uqW9_FO82_aWfKGlJYshMRIgjhThKvGxNi0HRRn5WDMEweiz7SYjz6Bl0BlEloBDw6PJnxg88KtkoS1ItfiMOHVuJf049XPqfdoLk58CayJL8fzfzhg_F7bnD5aQLBXwJjpBrlRk63w_8W6BIQTB98PvbgYXRIP0qNBEW9VhoUbg4LBDKRUlSQncPJJaUN4V4d6RI",
+          "id": "88751426b87d7072ea1acf98f35695d02985addb"
+        }, {
+          "name": "Channel Seven",
+          "vicinity": "Pirrama Road, Pyrmont",
+          "types": [ "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8660710,
+              "lng": 151.1944390
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
+          "reference": "CnRlAAAALz1LkbIHsaliP6WoAaNxU01M6zC3kZNewLqu2R6u2zOxkpTFv5R9B0tRbDD9mly1R7NgHZzZSI2BTLXfJj8YKTBNvPTNSF-JM8BmY1YTFrXryxWThrMg172gU40ypom4o2qhNidm_fkbgUHKv-bDhxIQuAzFJvp28JqqePT8CRFWHxoUQQffs7Qp7giQZaipftWiEBglHzs",
+          "id": "19cdf89322aa1fc3523c583a74a27645b11430e8"
+        }, {
+          "name": "Avis",
+          "vicinity": "Pyrmont Street, Pyrmont",
+          "types": [ "car_rental", "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8681980,
+              "lng": 151.1945840
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
+          "reference": "CmRbAAAA1IUBZVA5jwmicTiW8zNbvLulmf2GJ-uEiDfLevJnoVy8VcczuKi3IXFEXtRtXoZuGYqq2nLa0XKQrH3dNSaV4xgwPxSVhSBRU4yevB_Z2hRifoFbVNgMTbtgPo1_A1X0EhABhJpeDfk5MbbWqC_bw9y5GhSHrreEdpex54mreNHTaIlZZc9Cgg",
+          "id": "d559b2e8e491212130cf17c4d0ac595c72b3931f"
+        }, {
+          "name": "Lotus Pond",
+          "vicinity": "Pyrmont Street, Pyrmont",
+          "types": [ "restaurant", "food", "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8681980,
+              "lng": 151.1945840
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
+          "reference": "CnRiAAAAZ4ToVtI44jrLdD_HwTqrDis69gKZR3KpPz1U7t24gj0jF-hXgeLDij8CywRTX02Ed4ttYguSqCofCakRf1K0G6l15D7ODUma7_VLBs-77i3OPBpQBNe30IhUWpAsQRSAK3B_OZF7iWY95IyhSpnZ-hIQGjvxTeK7zKnY3h23cbMR0hoUPlwdkmCZ_GQ9l897p7jdZpqx22U",
+          "id": "ca11a8721d7fa06d9ed6ce80c7e49af70f440fd8"
+        }, {
+          "name": "Bite Me Burger",
+          "vicinity": "Pyrmont Street, Pyrmont",
+          "types": [ "restaurant", "food", "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8681980,
+              "lng": 151.1945840
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
+          "reference": "CnRlAAAALDu5NYsmU6qyxiaqJt-jDB2TfH4LuKr65ETEl1MFu8BR3BzmHpOU1IhS6bLlk0IKNQCOhVxxuOlGj-NH3TLgvjxm7HMkcG3rtOKrs73VhBwOFxtcnrwKkGOaOXzfUdle0yRF8qkK_-BR1I95tfYj2BIQdyXkbNEJmJiH6uzlZtGbFhoUlde33-u74nwjYIhNNG2-fXy9N9I",
+          "id": "c59ee010f131efcf1cd728c05ef73215319e52f0"
+        }, {
+          "name": "Fairfax Digital",
+          "vicinity": "Pirrama Road, Pyrmont",
+          "types": [ "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8660710,
+              "lng": 151.1944390
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
+          "reference": "CnRnAAAA2BjS9rAagMs7a4VIWYpIyiIwYFH7zXDILVNmldtwofuuPT7fEjXUP-Vq9_SqWvGsO3bTu7_ySbjyM71g5bW3kDu53O_5n_HjWm8JuEhuA5PAn5_NxGekLMhNPGKLKtZJmdQBlYisETGUqGQ7lbPDqxIQ05yEZ568oiOIi4FYzK9d_xoUXxS7lhyjgNg1nIqoJ0hKhu0S3Q0",
+          "id": "6b3cb6af5b5bed3297d96b48aac81a96f95ead4c"
+        }, {
+          "name": "Doltone House - Darling Island Wharf",
+          "vicinity": "Pirrama Road, Pyrmont",
+          "types": [ "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8670520,
+              "lng": 151.1957360
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
+          "reference": "CoQBfAAAAIOvkBRskkkLdw2PoZpvoXJhDs9hNqdt5Emap9eDf1mNu86F92Abh8TGQrzHVGJIzQ8ZX5VAdFe6M8Gwon_Q69-19VRkkHQ0KK7WZhYYt3fH74ZYIapFr3JlYkgyxhj5yeQa4solpc2C3YA1fbYH4fJeof66_sj99S8oP-zYkBDgEhBRNNWZT8cri0UTvZPZa2K2GhRTKKbIbD4bs8S5cYhXkz7fVCYSKw",
+          "id": "3ef986cd56bb3408bc1cf394f3dad9657c1d30f6"
+        }, {
+          "name": "Domain.Com.Au",
+          "vicinity": "Pirrama Road, Pyrmont",
+          "types": [ "real_estate_agency", "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8660710,
+              "lng": 151.1944390
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
+          "reference": "CnRkAAAA_C4kyy2pAof94NA2Z-qmYafl6n4QSk3l69DN37B049DUTEGAUkGj48Z_N2w7n1z2kuTzP-8CWaFga3RX7MUgt1oMmnqjrIKbqdKGwyJsMtI-XZdBw9ZRCwJuM5Jmk1MdjTHUxLljUG6Kh4dl4Jls5BIQUwrmN7ZD-tfPC7f-ZyfhoxoUYxYye9Llb3foY5Wpj5Eo-JnO9xQ",
+          "id": "22069082ad380a2f09db4675e7474c87e8557f3d"
+        }, {
+          "name": "Fat Noodle",
+          "vicinity": "Pyrmont Street, Pyrmont",
+          "types": [ "restaurant", "food", "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8681980,
+              "lng": 151.1945840
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
+          "reference": "CnRhAAAA_QIS77PlT4aALc3BSQdII-L8WjsbqTdZXWkgQ_sbDB1eqEBqUy1MvTN3q52Yx7TJSZYpQHWahZ_31qUFt13fK0E00cwF6X6zvZpJXLGcmskfaN795mS1RZVpRzxQLihSpy066luwHDnZ5DtNeo0DJhIQO7RgNUxdMeJbA9V6LG4RQhoUX6dwl7glDhc3-VhN0LdXWM2gAto",
+          "id": "ba9494fbebdb7e40f9a646aab93379212763195c"
+        }, {
+          "name": "Blue Eye Dragon",
+          "vicinity": "Pyrmont Street, Pyrmont",
+          "types": [ "restaurant", "food", "establishment" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8676090,
+              "lng": 151.1936860
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
+          "reference": "CnRmAAAAXkho1LLdtwMiNA1qppitMrj6zyw7KaTpvUuls_UHx_xunllNxp4mfiMwzm3uv_xDrVvKm4oc1baW1qzo0ZEEsOwc73dV4kPrjaLVek8nVD1tAFLRqpCi2wOI8TKs3Y4XxdJ2SUJ-RYZ__ZgY57YAGBIQU2FOTpI5dGTP2XmstdKseRoUl4KQPjQwbd78jnUQOKdI4mNhZ1k",
+          "id": "00060cf64f16375913ec49d25cbb7829d3e08a88"
+        }, {
+          "name": "Port Jackson",
+          "types": [ "locality", "political" ],
+          "geometry": {
+            "location": {
+              "lat": -33.8517149,
+              "lng": 151.1966444
+            }
+          },
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/geocode-71.png",
+          "reference": "CnRtAAAAqPzE3Of-4UH_8Jgo3_J7zCnDf5LfoQaTEezOcV1XH3P8WtlERBzwX5LMiEnc_gUz6FnOaBWSTNgcwdb1cfXJ0Ws6kJtqjS4Y9QtcpTmTuqUq4cwtzkwpSl0Cq6Staelh_4KncPMa6uma7R0oiDWhExIQVz3GTt8Uv9kaw8z6nQ-KXRoUIPaol1HIGplToOFrTiw7L5XxSP4",
+          "id": "8dbf2c11a8cca5b1457b442e05d006a21969ce22"
+        } ],
+        "html_attributions": [ "Listings by \u003ca href=\"http://www.yellowpages.com.au/\"\u003eYellow Pages\u003c/a\u003e" ]
+      }
+
+    http_version: "1.1"

data/spec/vcr_cassettes/single_spot.yml

@@ -0,0 +1,100 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: https://maps.googleapis.com:443/maps/api/place/search/json?reference=CoQBeAAAAO-prCRp9Atcj_rvavsLyv-DnxbGkw8QyRZb6Srm6QHOcww6lqFhIs2c7Ie6fMg3PZ4PhicfJL7ZWlaHaLDTqmRisoTQQUn61WTcSXAAiCOzcm0JDBnafqrskSpFtNUgzGAOx29WGnWSP44jmjtioIsJN9ik8yjK7UxP4buAmMPVEhBXPiCfHXk1CQ6XRuQhpztsGhQU4U6-tWjTHcLSVzjbNxoiuihbaA&sensor=false&key=AIzaSyATGBjcfrRXQtNEMMyt8Fw7tSGEY8PQwv0
+    body: 
+    headers: 
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - application/json; charset=UTF-8
+      date: 
+      - Mon, 16 May 2011 20:56:23 GMT
+      server: 
+      - mafe
+      x-xss-protection: 
+      - 1; mode=block
+      vary: 
+      - Accept-Language
+      cache-control: 
+      - private
+    body: |
+      {
+        "status": "INVALID_REQUEST",
+        "results": [ ],
+        "html_attributions": [ ]
+      }
+
+    http_version: "1.1"
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: https://maps.googleapis.com:443/maps/api/place/details/json?reference=CoQBeAAAAO-prCRp9Atcj_rvavsLyv-DnxbGkw8QyRZb6Srm6QHOcww6lqFhIs2c7Ie6fMg3PZ4PhicfJL7ZWlaHaLDTqmRisoTQQUn61WTcSXAAiCOzcm0JDBnafqrskSpFtNUgzGAOx29WGnWSP44jmjtioIsJN9ik8yjK7UxP4buAmMPVEhBXPiCfHXk1CQ6XRuQhpztsGhQU4U6-tWjTHcLSVzjbNxoiuihbaA&sensor=false&key=AIzaSyATGBjcfrRXQtNEMMyt8Fw7tSGEY8PQwv0
+    body: 
+    headers: 
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - application/json; charset=UTF-8
+      x-xss-protection: 
+      - 1; mode=block
+      server: 
+      - mafe
+      date: 
+      - Mon, 16 May 2011 20:56:23 GMT
+      cache-control: 
+      - private
+      vary: 
+      - Accept-Language
+    body: |
+      {
+        "status": "OK",
+        "result": {
+          "name": "Strike Bowling Bar Darling Harbour",
+          "vicinity": "The Promenade, Sydney",
+          "types": [ "bar", "establishment" ],
+          "formatted_phone_number": "(02) 9276 7100",
+          "formatted_address": "22 The Promenade, Sydney NSW, Australia",
+          "address_components": [ {
+            "long_name": "22",
+            "short_name": "22",
+            "types": [ "street_number" ]
+          }, {
+            "long_name": "The Promenade",
+            "short_name": "The Promenade",
+            "types": [ "route" ]
+          }, {
+            "long_name": "Sydney",
+            "short_name": "Sydney",
+            "types": [ "locality", "political" ]
+          }, {
+            "long_name": "NSW",
+            "short_name": "NSW",
+            "types": [ "administrative_area_level_1", "political" ]
+          }, {
+            "long_name": "2000",
+            "short_name": "2000",
+            "types": [ "postal_code" ]
+          } ],
+          "geometry": {
+            "location": {
+              "lat": -33.8662990,
+              "lng": 151.2016580
+            }
+          },
+          "url": "http://maps.google.com/maps/place?cid=8959672613212618319",
+          "icon": "http://maps.gstatic.com/mapfiles/place_api/icons/bar-71.png",
+          "reference": "CoQBeAAAAAUMe04SUnm6RIGcuqMjKTx-Ic-IUjZvVWd7iAUix9aXSq5zc6HD1qz0eV7WpKw6OYRn8ROXtP30MbsuXA6hwDnqMZP4CCEbuM0wzYxRhQYA8w1u5PhPc68qPYpnJewYgdAn8ABQS4HsAlngvJCzoUvQ3FgvTRtE-AvWiPNfb3QiEhBQr_GLVUynpIk18yxa89eGGhSs16baRJ75DexGyna6FTtzOTS97Q",
+          "id": "0a4e24c365f4bd70080f99bb80153c5ba3faced8"
+        },
+        "html_attributions": [ ]
+      }
+
+    http_version: "1.1"

data/spec/vcr_setup.rb

@@ -0,0 +1,8 @@
+require 'vcr'
+
+VCR.config do |c|
+  c.cassette_library_dir     = 'spec/vcr_cassettes'
+  c.stub_with                  :fakeweb
+  c.ignore_localhost         = true
+  c.default_cassette_options = { :record => :new_episodes }
+end

metadata

@@ -0,0 +1,149 @@
+--- !ruby/object:Gem::Specification 
+name: google_places
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Marcel de Graaf
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-16 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: fakeweb
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: vcr
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+description: This gem provides a Ruby wrapper around the Google Places API for use in your own project. Please note that this gem does not provide OAuth authentication.
+email: 
+- mail@marceldegraaf.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.rdoc
+- Rakefile
+- google_places.gemspec
+- lib/google_places.rb
+- lib/google_places/client.rb
+- lib/google_places/location.rb
+- lib/google_places/request.rb
+- lib/google_places/spot.rb
+- spec/api_key.sample.rb
+- spec/google_places/client_spec.rb
+- spec/google_places/location_spec.rb
+- spec/google_places/request_spec.rb
+- spec/google_places/spot_spec.rb
+- spec/spec_helper.rb
+- spec/vcr_cassettes/list_spots.yml
+- spec/vcr_cassettes/single_spot.yml
+- spec/vcr_setup.rb
+has_rdoc: true
+homepage: http://marceldegraaf.net
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.5.0
+signing_key: 
+specification_version: 3
+summary: A Ruby wrapper around the Google Places API.
+test_files: 
+- spec/api_key.sample.rb
+- spec/google_places/client_spec.rb
+- spec/google_places/location_spec.rb
+- spec/google_places/request_spec.rb
+- spec/google_places/spot_spec.rb
+- spec/spec_helper.rb
+- spec/vcr_cassettes/list_spots.yml
+- spec/vcr_cassettes/single_spot.yml
+- spec/vcr_setup.rb