googlemaps-services 1.3.0 → 1.3.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f9af6339c46954459057f1f720aa53f4275158c2
-  data.tar.gz: e167756c771106d77778d36284960c429cb9105f
+  metadata.gz: 9a29bf1ab90463cf58a2920a07ea63a791cf6637
+  data.tar.gz: 27203036b8394d7f9bb304864f8156fd0c454ded
 SHA512:
-  metadata.gz: dba8b6e7c27f3ddd0e90ef28d981930ab97c148a7202b3b98862a0bd18d8c80467b15df9751bb17827f596dbc3592eca30a0c988e5e7fdb31f1ce989f13d5c22
-  data.tar.gz: ab24f530bae29cf059851bfcea3682766b693909addb9dfa16e37e7d1379be0c4f8a59eecb1c271bb2cef2b0fee89ab5e5c28b2439b0ee9f5c7c5895c6f58b9e
+  metadata.gz: 5cdbce608cb68fe2b5fb418e8f4193f0c8d137f1239ec26efa9c58919e1eac2099b1c2dd261fc4e729f3a096e01d32f93bd55bff66e22404299a500899b91d75
+  data.tar.gz: 9b6422d246c467abe6d29db91239e4f11abbf48e72c10584ba55e0f54234dc18fb60e8dca44661e6c840f6168f07acdf78254409e27c99294a3bee5494ae698e

data/lib/googlemaps/services/client.rb

@@ -105,9 +105,7 @@ module GoogleMaps
       # @return [Hash, Array, nil] response body (either in JSON or XML) or nil.
       def get(url:, params:, first_request_time: nil, retry_counter: nil, base_url: DEFAULT_BASE_URL,
               accepts_clientid: true, extract_body: nil, request_headers: nil)
-        unless first_request_time
-          first_request_time = Util.current_time
-        end
+        first_request_time = Util.current_time unless first_request_time
 
         elapsed = Time.now - first_request_time
         if elapsed > self.retry_timeout
@@ -120,7 +118,7 @@ module GoogleMaps
           # at 1, so subtract that first.
           delay_seconds = 0.5 * 1.5 ** (retry_counter - 1)
           # Jitter this value by 50% and pause.
-          sleep(delay_seconds * (random.random + 0.5))
+          sleep(delay_seconds * (Random.rand + 0.5))
         end
 
         authed_url = generate_auth_url(url, params, accepts_clientid)
@@ -219,8 +217,6 @@ module GoogleMaps
 
         if body.key?('error_message')
           raise APIError.new(api_status), body['error_message']
-        else
-          raise APIError.new(api_status)
         end
       end
 
@@ -257,8 +253,6 @@ module GoogleMaps
         error_message = doc.xpath('//error_message')
         if error_message
           raise APIError.new(api_status), error_message.text
-        else
-          raise APIError.new(api_status)
         end
       end
 
@@ -304,12 +298,10 @@ module GoogleMaps
           return path + '&signature=' + sig
         end
 
-        if self.key
-          params['key'] = self.key
-          return path + '?' + Util.urlencode_params(params)
-        end
+        raise StandardError, 'Must provide API key for this API. It does not accept enterprise credentials.' unless self.key
 
-        raise StandardError, 'Must provide API key for this API. It does not accept enterprise credentials.'
+        params['key'] = self.key
+        return path + '?' + Util.urlencode_params(params)
       end
 
       private :get_json_body, :get_xml_body, :get_map_image, :get_redirection_url, :generate_auth_url

data/lib/googlemaps/services/geocoding.rb

@@ -67,7 +67,7 @@ module GoogleMaps
     # Performs requests to the Google Maps Geocoding API.
     #
     # @example
-    #   reverse_geocode = GoogleMaps::Services::ReverseGeocode(client)
+    #   reverse_geocode = GoogleMaps::Services::ReverseGeocode.new(client)
     #   result = reverse_geocode.query(latlng: {:lat => 52.520645, :lng => 13.409779}, language: "fr")
     class ReverseGeocode
       attr_accessor :client

data/lib/googlemaps/services/staticmap.rb

@@ -42,6 +42,8 @@ module GoogleMaps
       # @param [String, Array] path The single path of two or more connected points to overlay in the image at the specified locations.
       # @param [String, Array] visible One or more locations that should remain visible on the map.
       # @param [String] style A custom style to alter the presentation of a specific feature (roads, parks, and other features) of the map.
+      #
+      # @return [Hash] Hash with image URL, MIME type and its base64-encoded value.
       def query(size:, center: nil, zoom: nil, scale: 1, format: "png", maptype: "roadmap",
                 language: nil, region: nil, markers: nil, path: nil, visible: nil, style: nil)
         params = { 'size' => Convert.rectangular_dimensions(size) }

data/lib/googlemaps/services/streetview.rb

@@ -0,0 +1,73 @@
+require 'googlemaps/services/util'
+
+module GoogleMaps
+  module Services
+
+    # Performs requests to the Google Street View Map API.
+    #
+    # @example Get the street view map image
+    #   streetview = GoogleMaps::Services::StreetViewImage.new(client)
+    #   map_img = streetview.query(size: {:length=>400, :width=>400}, location: "40.714728,-73.998672", heading: 151.78, pitch: -0.76)
+    #   # {
+    #   #   :url => "https://maps.googleapis.com/maps/api/streetview?size=400x400&location=40.714728%2C-73.998672&heading=151.78&pitch=-0.76",
+    #   #   :mime_type => "image/jpeg",
+    #   #   :image_data => "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHR..."
+    #   # }
+    class StreetViewImage
+
+      # @return [Symbol] The HTTP client.
+      attr_accessor :client
+
+      def initialize(client)
+        self.client = client
+      end
+
+      # Get the street view map image.
+      #
+      # @param [Hash] size the rectangular dimensions of the street view image.
+      # @param [String, Hash] location The address or lat/lng value of the street view map.
+      # @param [String] pano A specific panorama ID.
+      # @param [Numeric] heading The compass heading of the camera. Accepted values are from 0 to 360.
+      # @param [Numeric] fov The horizontal field of view of the image. It is expressed in degrees, with a maximum allowed value of 120.
+      # @param [Numeric] pitch The up or down angle of the camera relative to the Street View vehicle.
+      #                        Positive values angle the camera up (with 90 degrees indicating straight up).
+      #                        Negative values angle the camera down (with -90 indicating straight down).
+      #
+      # @return [Hash] Hash with image URL, MIME type and its base64-encoded value.
+      def query(size:, location: nil, pano: nil, heading: nil, fov: nil, pitch: nil)
+        params = {
+          'size' => Convert.rectangular_dimensions(size)
+        }
+
+        if location
+          params['location'] = Convert.to_latlng(location)
+        end
+
+        if pano
+          params['pano'] = pano
+        end
+
+        if location && pano
+          raise StandardError, 'should not specify both location and panorama ID.'
+        end
+
+        if heading
+          raise StandardError, 'invalid compass heading value.' unless (0..360).include? heading
+          params['heading'] = heading
+        end
+
+        if fov
+          raise StandardError, 'invalid field of view (fov) value.' unless (0..120).include? fov
+          params['fov'] = fov
+        end
+
+        if pitch
+          raise StandardError, 'invalid pitch value.' unless (-90..90).include? pitch
+          params['pitch'] = pitch
+        end
+
+        self.client.get(url: "/maps/api/streetview", params: params)
+      end
+    end
+  end
+end

data/lib/googlemaps/services/version.rb

@@ -1,5 +1,5 @@
 module GoogleMaps
   module Services
-    VERSION = '1.3.0'.freeze
+    VERSION = '1.3.5'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: googlemaps-services
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.3.5
 platform: ruby
 authors:
 - Faissal Elamraoui
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-18 00:00:00.000000000 Z
+date: 2017-03-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -109,6 +109,7 @@ files:
 - lib/googlemaps/services/places.rb
 - lib/googlemaps/services/roads.rb
 - lib/googlemaps/services/staticmap.rb
+- lib/googlemaps/services/streetview.rb
 - lib/googlemaps/services/timezone.rb
 - lib/googlemaps/services/util.rb
 - lib/googlemaps/services/version.rb