google_places 0.29.0 → 0.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c6cf4c3608d876073641025fdd76161b8954f1b9
-  data.tar.gz: e65004cd9f37b00077d864233f71619acb91f2cf
+  metadata.gz: 38654649db0478793fd7abe3c0b80f2ab7c25f46
+  data.tar.gz: 4871aa13e63e37b8b8a393939af98ddfe9a99871
 SHA512:
-  metadata.gz: 3858844ce1b18424f74289818e610851d146c9c31621d4a20850a4e83d4227feed2ad16d7251340fb3abbe23fed32bb0494ed6fe529e5010ddf111cb2bd27755
-  data.tar.gz: 99ae539590a67883916a154b2a79b6bc3781686737c6e1ae91d59781957c40fe323af36a658c1e104c9042bc60aabc1bb6c8de88f9425e64ac849351cd740927
+  metadata.gz: 15fb60f01e7d74b0e38eda355810377d401b44e080fbf2861fb1899e68f82b6b0f5218dae63d18d97332c6a40363be84aca46aab1c083737067c00a46158a8c4
+  data.tar.gz: 0d6e1fd84dcb5db00e31ff38813da5599f75708394d68896cea88d529f93656fc6a91070f7d51618bec020c9b92e386c672d3645a708907e1b532c120eda782a

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    google_places (0.28.0)
+    google_places (0.30.0)
       httparty (~> 0.13.1)
 
 GEM

data/google_places.gemspec

@@ -3,7 +3,7 @@ $:.push File.expand_path('../lib', __FILE__)
 
 Gem::Specification.new do |s|
   s.name        = 'google_places'
-  s.version     = '0.29.0'
+  s.version     = '0.30.0'
   s.platform    = Gem::Platform::RUBY
   s.authors     = ['Marcel de Graaf']
   s.email       = ['mail@marceldegraaf.net']

data/lib/google_places.rb

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

data/lib/google_places/client.rb

@@ -148,7 +148,42 @@ module GooglePlaces
     def spots_by_query(query, options = {})
       Spot.list_by_query(query, @api_key, @options.merge(options))
     end
-
+    # Search for Spots within a give SW|NE bounds with query
+    #
+    # @return [Array<Spot>]
+    # @param [Hash] bounds
+    # @param [String] api_key the provided api key
+    # @param [Hash] options
+    # @option bounds [String, Array] :start_point
+    #   An array that contains the lat/lng pair for the first
+    #     point in the bounds (rectangle)
+    # @option bounds [:start_point][String, Integer] :lat
+    #   The starting point coordinates latitude value
+    # @option bounds [:start_point][String, Integer] :lng
+    #   The starting point coordinates longitude value
+    # @option bounds [String, Array] :end_point
+    #   An array that contains the lat/lng pair for the end
+    #     point in the bounds (rectangle)
+    # @option bounds [:end_point][String, Integer] :lat
+    #   The end point coordinates latitude value
+    # @option bounds [:end_point][String, Integer] :lng
+    #   The end point coordinates longitude value
+    # @option options [String,Array] :query
+    #   Restricts the results to Spots matching term(s) in the specified query
+    # @option options [String] :language
+    #   The language code, indicating in which language the results should be returned, if possible.
+    # @option options [String,Array<String>] :exclude ([])
+    #   A String or an Array of <b>types</b> to exclude from results
+    # @option options [Hash] :retry_options ({})
+    #   A Hash containing parameters for search retries
+    # @option options [Object] :retry_options[:status] ([])
+    # @option options [Integer] :retry_options[:max] (0) the maximum retries
+    # @option options [Integer] :retry_options[:delay] (5) the delay between each retry in seconds
+    #
+    # @see https://developers.google.com/maps/documentation/places/supported_types List of supported types
+    def spots_by_bounds(bounds, options = {})
+      Spot.list_by_bounds(bounds, @api_key, @options.merge(options))
+    end
     # Search for Spots with a pagetoken
     #
     # @return [Array<Spot>]

data/lib/google_places/rectangle.rb

@@ -0,0 +1,13 @@
+module GooglePlaces
+  class Rectangle
+    #The start_lat/lng pair values indicate the starting point of the rectangle
+    #The end_lat/lng pair values indicate the end point of the rectangle
+    def initialize(start_lat, start_lng, end_lat, end_lng)
+      @start_point, @end_point = [ ("%.8f"%start_lat), ("%.8f"%start_lng)], [("%.8f"%end_lat), ("%.8f"%end_lng) ]
+    end
+
+    def format
+      [ @start_point.join(','), @end_point.join(',') ].join('|')
+    end
+  end
+end

data/lib/google_places/request.rb

@@ -127,6 +127,41 @@ module GooglePlaces
       request.parsed_response
     end
 
+    # Search for Spots within a give SW|NE bounds with query
+    #
+    # @return [Array<Spot>]
+    # @param [Hash] bounds
+    # @param [String] api_key the provided api key
+    # @param [Hash] options
+    # @option bounds [String, Integer] :se
+    #   the southeast lat|lng pair
+    # @option bounds [:se][String, Integer] :lat
+    #   the SE latitude
+    # @option bounds [:se][String, Integer] :lng
+    #   the SE longitude
+    # @option bounds [:se][String, Integer] :lat
+    #   the SE latitude
+    # @option bounds [:se][String, Integer] :lng
+    #   the SE longitude
+    # @option options [String,Array] :query
+    #   Restricts the results to Spots matching term(s) in the specified query
+    # @option options [String] :language
+    #   The language code, indicating in which language the results should be returned, if possible.
+    # @option options [String,Array<String>] :exclude ([])
+    #   A String or an Array of <b>types</b> to exclude from results
+    #
+    # @option options [Hash] :retry_options ({})
+    #   A Hash containing parameters for search retries
+    # @option options [Object] :retry_options[:status] ([])
+    # @option options [Integer] :retry_options[:max] (0) the maximum retries
+    # @option options [Integer] :retry_options[:delay] (5) the delay between each retry in seconds
+    #
+    # @see http://spreadsheets.google.com/pub?key=p9pdwsai2hDMsLkXsoM05KQ&gid=1 List of supported languages
+    # @see https://developers.google.com/maps/documentation/places/supported_types List of supported types
+    def self.spots_by_bounds(options = {})
+      request = new(TEXT_SEARCH_URL, options)
+      request.parsed_response
+    end
     # Search for Spots with a query
     #
     # @return [Array<Spot>]
@@ -268,7 +303,6 @@ module GooglePlaces
       retry_options[:status] ||= []
       retry_options[:max]    ||= 0
       retry_options[:delay]  ||= 5
-
       retry_options[:status] = [retry_options[:status]] unless retry_options[:status].is_a?(Array)
       @response = self.class.get(url, :query => options, :follow_redirects => follow_redirects)
 

data/lib/google_places/spot.rb

@@ -1,5 +1,4 @@
 require 'google_places/review'
-
 module GooglePlaces
   class Spot
     attr_accessor :lat, :lng, :viewport, :name, :icon, :reference, :vicinity, :types, :id, :formatted_phone_number, :international_phone_number, :formatted_address, :address_components, :street_number, :street, :city, :region, :postal_code, :country, :rating, :url, :cid, :website, :reviews, :aspects, :zagat_selected, :zagat_reviewed, :photos, :review_summary, :nextpagetoken, :price_level, :opening_hours, :events, :utc_offset, :place_id
@@ -82,7 +81,74 @@ module GooglePlaces
 
       request(:spots, multipage_request, exclude, options)
     end
+      # Search for Spots within a give SW|NE bounds with query
+      #
+      # @return [Array<Spot>]
+      # @param [Hash] bounds
+      # @param [String] api_key the provided api key
+      # @param [Hash] options
+      # @option bounds [String, Array] :start_point
+      #   An array that contains the lat/lng pair for the first
+      #     point in the bounds (rectangle)
+      # @option bounds [:start_point][String, Integer] :lat
+      #   The starting point coordinates latitude value
+      # @option bounds [:start_point][String, Integer] :lng
+      #   The starting point coordinates longitude value
+      # @option bounds [String, Array] :end_point
+      #   An array that contains the lat/lng pair for the end
+      #     point in the bounds (rectangle)
+      # @option bounds [:end_point][String, Integer] :lat
+      #   The end point coordinates latitude value
+      # @option bounds [:end_point][String, Integer] :lng
+      #   The end point coordinates longitude value
+      # @option options [String,Array] :query
+      #   Restricts the results to Spots matching term(s) in the specified query
+      # @option options [String] :language
+      #   The language code, indicating in which language the results should be returned, if possible.
+      # @option options [String,Array<String>] :exclude ([])
+      #   A String or an Array of <b>types</b> to exclude from results
+      #
+      # @option options [Hash] :retry_options ({})
+      #   A Hash containing parameters for search retries
+      # @option options [Object] :retry_options[:status] ([])
+      # @option options [Integer] :retry_options[:max] (0) the maximum retries
+      # @option options [Integer] :retry_options[:delay] (5) the delay between each retry in seconds
+      #
+      # @see https://developers.google.com/maps/documentation/places/supported_types List of supported types
+    def self.list_by_bounds(bounds, api_key, options = {})
+      start_lat = bounds[:start_point][:lat]
+      start_lng = bounds[:start_point][:lng]
+      end_lat = bounds[:end_point][:lat]
+      end_lng = bounds[:end_point][:lng]
+      rect = Rectangle.new(start_lat, start_lng, end_lat, end_lng)
+      multipage_request = !!options.delete(:multipage)
+      rankby = options.delete(:rankby)
+      query  = options.delete(:query)
+      name  = options.delete(:name)
+      language  = options.delete(:language)
+      exclude = options.delete(:exclude) || []
+      retry_options = options.delete(:retry_options) || {}
+      zagat_selected = options.delete(:zagat_selected) || false
+      exclude = [exclude] unless exclude.is_a?(Array)
+
+
+      options = {
+        :bounds => rect.format,
+        :key => api_key,
+        :language => language,
+        :retry_options => retry_options
+      }
 
+      options[:zagatselected] = zagat_selected if zagat_selected
+
+      # Accept Types as a string or array
+      if query
+        query = (query.is_a?(Array) ? query.join('|') : query)
+        options.merge!(:query => query)
+      end
+
+      request(:spots_by_bounds, multipage_request, exclude, options)
+    end
     # Search for Spots using Radar Search. Spots will only include reference and lat/lng information. You can send a Place Details request for more information about any of them.
     #
     # @return [Array<Spot>]

data/spec/google_places/client_spec.rb

@@ -29,7 +29,14 @@ describe GooglePlaces::Client do
 
     @client.spots_by_query(query)
   end
-
+  it 'should request spots by bounds' do
+    query = 'pizza'
+    bounds = {:start_point => {:lat => '36.06686213257888', :lng => '-86.94168090820312'},
+              :end_point => {:lat => '36.268635800737876', :lng => '-86.66152954101562'}}
+    @client = GooglePlaces::Client.new(api_key)
+    expect(GooglePlaces::Spot).to receive(:list_by_bounds).with(bounds, api_key, {:query => query})
+    res = @client.spots_by_bounds(bounds, :query => query)
+  end
   it 'should request spots by radar' do
     keywords = 'landmarks'
     lat, lng = '51.511627', '-0.183778'

data/spec/google_places/rectangle.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe GooglePlaces::Rectangle do
+  it 'should return two lat/lng pairs separated by a "|" based on SW and NE lat/lng bounds' do
+    expect(GooglePlaces::Rectangle.new('123', '456', '321', '654').format).to eq('123.00000000,456.00000000|321.00000000,654.00000000')
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google_places
 version: !ruby/object:Gem::Version
-  version: 0.29.0
+  version: 0.30.0
 platform: ruby
 authors:
 - Marcel de Graaf
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-02-14 00:00:00.000000000 Z
+date: 2015-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -88,6 +88,7 @@ files:
 - lib/google_places/location.rb
 - lib/google_places/photo.rb
 - lib/google_places/prediction.rb
+- lib/google_places/rectangle.rb
 - lib/google_places/request.rb
 - lib/google_places/review.rb
 - lib/google_places/spot.rb
@@ -98,6 +99,7 @@ files:
 - spec/google_places/location_spec.rb
 - spec/google_places/photo_spec.rb
 - spec/google_places/prediction_spec.rb
+- spec/google_places/rectangle.rb
 - spec/google_places/request_spec.rb
 - spec/google_places/spot_spec.rb
 - spec/spec_helper.rb
@@ -148,6 +150,7 @@ test_files:
 - spec/google_places/location_spec.rb
 - spec/google_places/photo_spec.rb
 - spec/google_places/prediction_spec.rb
+- spec/google_places/rectangle.rb
 - spec/google_places/request_spec.rb
 - spec/google_places/spot_spec.rb
 - spec/spec_helper.rb