Class: GooglePlaces::Spot

Inherits:
Object
  • Object
show all
Defined in:
lib/google_places/spot.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(json_result_object, api_key) ⇒ Spot

Returns a newly created spot.

Parameters:

  • json_result_object (JSON) —

    a JSON object to create a Spot from



342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
 
# File 'lib/google_places/spot.rb', line 342

def initialize(json_result_object, api_key)
  @reference                  = json_result_object['reference']
  @place_id                   = json_result_object['place_id']
  @vicinity                   = json_result_object['vicinity']
  @lat                        = json_result_object['geometry']['location']['lat']
  @lng                        = json_result_object['geometry']['location']['lng']
  @viewport                   = json_result_object['geometry']['viewport']
  @name                       = json_result_object['name']
  @icon                       = json_result_object['icon']
  @types                      = json_result_object['types']
  @id                         = json_result_object['id']
  @formatted_phone_number     = json_result_object['formatted_phone_number']
  @international_phone_number = json_result_object['international_phone_number']
  @formatted_address          = json_result_object['formatted_address']
  @address_components         = json_result_object['address_components']
  @street_number              = address_component(:street_number, 'short_name')
  @street                     = address_component(:route, 'long_name')
  @city                       = address_component(:locality, 'long_name')
  @region                     = address_component(:administrative_area_level_1, 'long_name')
  @postal_code                = address_component(:postal_code, 'long_name')
  @country                    = address_component(:country, 'long_name')
  @rating                     = json_result_object['rating']
  @price_level                = json_result_object['price_level']
  @opening_hours              = json_result_object['opening_hours']
  @url                        = json_result_object['url']
  @cid                        = json_result_object['url'].to_i
  @website                    = json_result_object['website']
  @zagat_reviewed             = json_result_object['zagat_reviewed']
  @zagat_selected             = json_result_object['zagat_selected']
  @aspects                    = aspects_component(json_result_object['aspects'])
  @review_summary             = json_result_object['review_summary']
  @photos                     = photos_component(json_result_object['photos'], api_key)
  @reviews                    = reviews_component(json_result_object['reviews'])
  @nextpagetoken              = json_result_object['nextpagetoken']
  @events                     = events_component(json_result_object['events'])
  @utc_offset                 = json_result_object['utc_offset']
end

Instance Attribute Details

#address_components ⇒ Object

Returns the value of attribute address_components.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def address_components
  @address_components
end

#aspects ⇒ Object

Returns the value of attribute aspects.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def aspects
  @aspects
end

#cid ⇒ Object

Returns the value of attribute cid.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def cid
  @cid
end

#city ⇒ Object

Returns the value of attribute city.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def city
  @city
end

#country ⇒ Object

Returns the value of attribute country.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def country
  @country
end

#events ⇒ Object

Returns the value of attribute events.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def events
  @events
end

#formatted_address ⇒ Object

Returns the value of attribute formatted_address.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def formatted_address
  @formatted_address
end

#formatted_phone_number ⇒ Object

Returns the value of attribute formatted_phone_number.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def formatted_phone_number
  @formatted_phone_number
end

#icon ⇒ Object

Returns the value of attribute icon.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def icon
  @icon
end

#id ⇒ Object

Returns the value of attribute id.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def id
  @id
end

#international_phone_number ⇒ Object

Returns the value of attribute international_phone_number.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def international_phone_number
  @international_phone_number
end

#lat ⇒ Object

Returns the value of attribute lat.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def lat
  @lat
end

#lng ⇒ Object

Returns the value of attribute lng.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def lng
  @lng
end

#name ⇒ Object

Returns the value of attribute name.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def name
  @name
end

#nextpagetoken ⇒ Object

Returns the value of attribute nextpagetoken.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def nextpagetoken
  @nextpagetoken
end

#opening_hours ⇒ Object

Returns the value of attribute opening_hours.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def opening_hours
  @opening_hours
end

#photos ⇒ Object

Returns the value of attribute photos.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def photos
  @photos
end

#place_id ⇒ Object

Returns the value of attribute place_id.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def place_id
  @place_id
end

#postal_code ⇒ Object

Returns the value of attribute postal_code.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def postal_code
  @postal_code
end

#price_level ⇒ Object

Returns the value of attribute price_level.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def price_level
  @price_level
end

#rating ⇒ Object

Returns the value of attribute rating.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def rating
  @rating
end

#reference ⇒ Object

Returns the value of attribute reference.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def reference
  @reference
end

#region ⇒ Object

Returns the value of attribute region.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def region
  @region
end

#review_summary ⇒ Object

Returns the value of attribute review_summary.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def review_summary
  @review_summary
end

#reviews ⇒ Object

Returns the value of attribute reviews.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def reviews
  @reviews
end

#street ⇒ Object

Returns the value of attribute street.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def street
  @street
end

#street_number ⇒ Object

Returns the value of attribute street_number.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def street_number
  @street_number
end

#types ⇒ Object

Returns the value of attribute types.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def types
  @types
end

#url ⇒ Object

Returns the value of attribute url.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def url
  @url
end

#utc_offset ⇒ Object

Returns the value of attribute utc_offset.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def utc_offset
  @utc_offset
end

#vicinity ⇒ Object

Returns the value of attribute vicinity.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def vicinity
  @vicinity
end

#viewport ⇒ Object

Returns the value of attribute viewport.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def viewport
  @viewport
end

#website ⇒ Object

Returns the value of attribute website.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def website
  @website
end

#zagat_reviewed ⇒ Object

Returns the value of attribute zagat_reviewed.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def zagat_reviewed
  @zagat_reviewed
end

#zagat_selected ⇒ Object

Returns the value of attribute zagat_selected.



5
6
7
 
# File 'lib/google_places/spot.rb', line 5

def zagat_selected
  @zagat_selected
end

Class Method Details

.find(place_id, api_key, options = {}) ⇒ Spot

Search for a Spot with a reference key

Parameters:

  • place_id (String) —

    the place_id of the spot

  • api_key (String) —

    the provided api key

  • options (Hash) (defaults to: {})

Options Hash (options):

  • :language (String) —

    The language code, indicating in which language the results should be returned, if possible.

  • :retry_options (Hash) — default: {} —

    A Hash containing parameters for search retries

  • :retry_options[:status] (Object) — default: []
  • :retry_options[:max] (Integer) — default: 0 —

    the maximum retries

  • :retry_options[:delay] (Integer) — default: 5 —

    the delay between each retry in seconds

Returns:



179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
 
# File 'lib/google_places/spot.rb', line 179

def self.find(place_id, api_key, options = {})
  language  = options.delete(:language)
  retry_options = options.delete(:retry_options) || {}
  extensions = options.delete(:review_summary) ? 'review_summary' : nil

  response = Request.spot(
    :placeid => place_id,
    :key => api_key,
    :language => language,
    :extensions => extensions,
    :retry_options => retry_options
  )

  self.new(response['result'], api_key)
end

.list(lat, lng, api_key, options = {}) ⇒ Array<Spot>

Search for Spots at the provided location

Parameters:

  • lat (String, Integer) —

    the latitude for the search

  • lng (String, Integer) —

    the longitude for the search

  • api_key (String) —

    the provided api key

  • options (Hash) (defaults to: {})

Options Hash (options):

  • :radius (Integer) — default: 1000 —

    Defines the distance (in meters) within which to return Place results. The maximum allowed radius is 50,000 meters. Note that radius must not be included if :rankby => ‘distance’ (described below) is specified. Note that this is a mandatory parameter

  • :rankby (String) —

    Specifies the order in which results are listed. Possible values are:

    • prominence (default). This option sorts results based on their importance. Ranking will favor prominent places within the specified area. Prominence can be affected by a Place’s ranking in Google’s index, the number of check-ins from your application, global popularity, and other factors.

    • distance. This option sorts results in ascending order by their distance from the specified location. Ranking results by distance will set a fixed search radius of 50km. One or more of keyword, name, or types is required.

  • :types (String, Array) —

    Restricts the results to Spots matching at least one of the specified types

  • :name (String) —

    A term to be matched against the names of Places. Results will be restricted to those containing the passed name value.

  • :keyword (String) —

    A term to be matched against all content that Google has indexed for this Spot, including but not limited to name, type, and address, as well as customer reviews and other third-party content.

  • :language (String) —

    The language code, indicating in which language the results should be returned, if possible.

  • :exclude (String, Array<String>) — default: [] —

    A String or an Array of types to exclude from results

  • :retry_options (Hash) — default: {} —

    A Hash containing parameters for search retries

  • :retry_options[:status] (Object) — default: []
  • :retry_options[:max] (Integer) — default: 0 —

    the maximum retries

  • :retry_options[:delay] (Integer) — default: 5 —

    the delay between each retry in seconds

Returns:

See Also:



50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
 
# File 'lib/google_places/spot.rb', line 50

def self.list(lat, lng, api_key, options = {})
  location = Location.new(lat, lng)
  multipage_request = !!options.delete(:multipage)
  rankby = options.delete(:rankby)
  radius = options.delete(:radius) || 1000 if rankby.nil? || rankby =~ /prominence/
  types  = options.delete(:types)
  name  = options.delete(:name)
  keyword = options.delete(:keyword)
  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 = {
    :location => location.format,
    :radius => radius,
    :rankby => rankby,
    :key => api_key,
    :name => name,
    :language => language,
    :keyword => keyword,
    :retry_options => retry_options
  }

  options[:zagatselected] = zagat_selected if zagat_selected

  # Accept Types as a string or array
  if types
    types = (types.is_a?(Array) ? types.join('|') : types)
    options.merge!(:types => types)
  end

  request(:spots, multipage_request, exclude, options)
end

.list_by_pagetoken(pagetoken, api_key, options = {}) ⇒ Array<Spot>

Search for Spots with a pagetoken

Parameters:

  • pagetoken (String) —

    the token to find next results

  • api_key (String) —

    the provided api key

  • options (Hash) (defaults to: {})

Returns:



201
202
203
204
205
206
207
208
209
210
211
 
# File 'lib/google_places/spot.rb', line 201

def self.list_by_pagetoken(pagetoken, api_key, options = {})
  exclude = options.delete(:exclude) || []
  exclude = [exclude] unless exclude.is_a?(Array)

  options = {
      :pagetoken => pagetoken,
      :key => api_key
  }

  request(:spots_by_pagetoken, false, exclude, options)
end

.list_by_query(query, api_key, options = {}) ⇒ Array<Spot>

Search for Spots with a query

Parameters:

  • query (String) —

    the query to search for

  • api_key (String) —

    the provided api key

  • options (Hash) (defaults to: {})

Options Hash (options):

  • :lat (String, Integer) —

    the latitude for the search

  • :lng (String, Integer) —

    the longitude for the search

  • :radius (Integer) — default: 1000 —

    Defines the distance (in meters) within which to return Place results. The maximum allowed radius is 50,000 meters. Note that radius must not be included if :rankby => ‘distance’ (described below) is specified. Note that this is a mandatory parameter

  • :rankby (String) —

    Specifies the order in which results are listed. Possible values are:

    • prominence (default). This option sorts results based on their importance. Ranking will favor prominent places within the specified area. Prominence can be affected by a Place’s ranking in Google’s index, the number of check-ins from your application, global popularity, and other factors.

    • distance. This option sorts results in ascending order by their distance from the specified location. Ranking results by distance will set a fixed search radius of 50km. One or more of keyword, name, or types is required.

  • :types (String, Array) —

    Restricts the results to Spots matching at least one of the specified types

  • :language (String) —

    The language code, indicating in which language the results should be returned, if possible.

  • :exclude (String, Array<String>) — default: [] —

    A String or an Array of types to exclude from results

  • :retry_options (Hash) — default: {} —

    A Hash containing parameters for search retries

  • :retry_options[:status] (Object) — default: []
  • :retry_options[:max] (Integer) — default: 0 —

    the maximum retries

  • :retry_options[:delay] (Integer) — default: 5 —

    the delay between each retry in seconds

Returns:

See Also:



252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
 
# File 'lib/google_places/spot.rb', line 252

def self.list_by_query(query, api_key, options = {})
  if options.has_key?(:lat) && options.has_key?(:lng)
    with_location = true
  else
    with_location = false
  end

  if options.has_key?(:radius)
    with_radius = true
  else
    with_radius = false
  end

  query = query
  multipage_request = !!options.delete(:multipage)
  location = Location.new(options.delete(:lat), options.delete(:lng)) if with_location
  radius = options.delete(:radius) if with_radius
  rankby = options.delete(:rankby)
  language = options.delete(:language)
  types = options.delete(:types)
  exclude = options.delete(:exclude) || []
  retry_options = options.delete(:retry_options) || {}

  exclude = [exclude] unless exclude.is_a?(Array)

  options = {
    :query => query,
    :key => api_key,
    :rankby => rankby,
    :language => language,
    :retry_options => retry_options
  }

  options[:location] = location.format if with_location
  options[:radius] = radius if with_radius

  # Accept Types as a string or array
  if types
    types = (types.is_a?(Array) ? types.join('|') : types)
    options.merge!(:types => types)
  end

  request(:spots_by_query, multipage_request, exclude, options)
end

.list_by_radar(lat, lng, api_key, options = {}) ⇒ Object

Defines the distance (in meters) within which to return Place results.

The maximum allowed radius is 50,000 meters.
<b>Note that this is a mandatory parameter</b>

Parameters:

  • options (Hash) (defaults to: {}) —

    a customizable set of options

Options Hash (options):

  • :types (String, Array) —

    Restricts the results to Spots matching at least one of the specified types

  • :name (String) —

    A term to be matched against the names of Places. Results will be restricted to those containing the passed name value.

  • :keyword (String) —

    A term to be matched against all content that Google has indexed for this Spot, including but not limited to name, type, and address, as well as customer reviews and other third-party content.

  • :minprice (Integer) —

    Restricts results to only those places within the specified price range. Valid values range between 0 (most affordable) to 4 (most expensive), inclusive.

  • :maxprice (Integer) —

    Restricts results to only those places within the specified price range. Valid values range between 0 (most affordable) to 4 (most expensive), inclusive.

  • :opennow (Boolean) —

    Retricts results to those Places that are open for business at the time the query is sent. Places that do not specify opening hours in the Google Places database will not be returned if you include this parameter in your query. Setting openNow to false has no effect.

  • :zagatselected (Boolean) —

    Restrict your search to only those locations that are Zagat selected businesses. This parameter does not require a true or false value, simply including the parameter in the request is sufficient to restrict your search. The zagatselected parameter is experimental, and only available to Places API enterprise customers.

  • :retry_options (Hash) — default: {} —

    A Hash containing parameters for search retries

  • :retry_options[:status] (Object) — default: []
  • :retry_options[:max] (Integer) — default: 0 —

    the maximum retries

  • :retry_options[:delay] (Integer) — default: 5 —

    the delay between each retry in seconds

See Also:



126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
 
# File 'lib/google_places/spot.rb', line 126

def self.list_by_radar(lat, lng, api_key, options = {})
  location = Location.new(lat, lng)
  multipage_request = !!options.delete(:multipage)
  radius = options.delete(:radius) || 1000
  types  = options.delete(:types)
  name  = options.delete(:name)
  keyword = options.delete(:keyword)
  retry_options = options.delete(:retry_options) || {}
  zagat_selected = options.delete(:zagat_selected) || false
  opennow = options.delete(:opennow) || false
  minprice = options.delete(:minprice) || false
  maxprice = options.delete(:maxprice) || false
  exclude = []

  options = {
    :location => location.format,
    :radius => radius,
    :key => api_key,
    :name => name,
    :keyword => keyword,
    :retry_options => retry_options
  }

  options[:zagatselected] = zagat_selected if zagat_selected
  options[:opennow] = opennow if opennow
  options[:minprice] = minprice if minprice
  options[:maxprice] = maxprice if maxprice

  # Accept Types as a string or array
  if types
    types = (types.is_a?(Array) ? types.join('|') : types)
    options.merge!(:types => types)
  end

  request(:spots_by_radar, multipage_request, exclude, options)
end

.multi_pages_request(method, multipage_request, options) ⇒ Object 



310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
 
# File 'lib/google_places/spot.rb', line 310

def self.multi_pages_request(method, multipage_request, options)
  begin
    response = Request.send(method, options)
    response['results'].each do |result|
      if !multipage_request && !response["next_page_token"].nil? && result == response['results'].last
        # add next page token on the last result
        result.merge!("nextpagetoken" => response["next_page_token"])
      end
      yield(result)
    end

    # request the next page if presence of a "next_page" token
    next_page = false
    if multipage_request && !response["next_page_token"].nil?
      options = {
        :pagetoken => response["next_page_token"],
        :key => options[:key]
      }

      # There is a short delay between when a next_page_token is issued, and when it will become valid.
      # If requested too early, it will result in InvalidRequestError.
      # See: https://developers.google.com/places/documentation/search#PlaceSearchPaging
      sleep(2)

      next_page = true
    end

  end while (next_page)
end

.request(method, multipage_request, exclude, options) ⇒ Object 



297
298
299
300
301
302
303
304
305
306
307
308
 
# File 'lib/google_places/spot.rb', line 297

def self.request(method, multipage_request, exclude, options)
  results = []

  self.multi_pages_request(method, multipage_request, options) do |result|
  	# Some places returned by Google do not have a 'types' property. If the user specified 'types', then
  	# this is a non-issue because those places will not be returned. However, if the user did not specify
  	# 'types', then we do not want to filter out places with a missing 'types' property from the results set.
    results << self.new(result, options[:key]) if result['types'].nil? || (result['types'] & exclude) == []
  end

  results
end

Instance Method Details

#[](key) ⇒ Object 



380
381
382
 
# File 'lib/google_places/spot.rb', line 380

def [] (key)
  send(key)
end

#address_component(address_component_type, address_component_length) ⇒ Object 



384
385
386
387
388
 
# File 'lib/google_places/spot.rb', line 384

def address_component(address_component_type, address_component_length)
  if component = address_components_of_type(address_component_type)
    component.first[address_component_length] unless component.first.nil?
  end
end

#address_components_of_type(type) ⇒ Object 



390
391
392
 
# File 'lib/google_places/spot.rb', line 390

def address_components_of_type(type)
  @address_components.select{ |c| c['types'].include?(type.to_s) } unless @address_components.nil?
end

#aspects_component(json_aspects) ⇒ Object 



410
411
412
 
# File 'lib/google_places/spot.rb', line 410

def aspects_component(json_aspects)
  json_aspects.to_a.map{ |r| { :type => r['type'], :rating => r['rating'] } }
end

#events_component(json_events) ⇒ Object 



429
430
431
 
# File 'lib/google_places/spot.rb', line 429

def events_component(json_events)
  json_events.to_a.map{ |r| {:event_id => r['event_id'], :summary => r['summary'], :url => r['url'], :start_time => r['start_time']} }
end

#photos_component(json_photos, api_key) ⇒ Object 



414
415
416
417
418
419
420
421
422
423
424
425
426
427
 
# File 'lib/google_places/spot.rb', line 414

def photos_component(json_photos, api_key)
  if json_photos
    json_photos.map{ |p|
      Photo.new(
        p['width'],
        p['height'],
        p['photo_reference'],
        p['html_attributions'],
        api_key
      )
    }
  else []
  end
end

#reviews_component(json_reviews) ⇒ Object 



394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
 
# File 'lib/google_places/spot.rb', line 394

def reviews_component(json_reviews)
  if json_reviews
    json_reviews.map { |r|
      Review.new(
          r['rating'],
          r['type'],
          r['author_name'],
          r['author_url'],
          r['text'],
          r['time'].to_i
      )
    }
  else []
  end
end