google-cloud-vision 0.31.0 → 0.32.0

data/lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/text_annotation.rb

@@ -128,7 +128,7 @@ module Google
         #       |    |
         #       1----0
         #
-        #       and the vertice order will still be (0, 1, 2, 3).
+        #       and the vertex order will still be (0, 1, 2, 3).
         # @!attribute [rw] paragraphs
         #   @return [Array<Google::Cloud::Vision::V1::Paragraph>]
         #     List of paragraphs in this block (if this blocks is of type text).
@@ -181,7 +181,7 @@ module Google
         #         2----3
         #         |    |
         #         1----0
-        #         and the vertice order will still be (0, 1, 2, 3).
+        #         and the vertex order will still be (0, 1, 2, 3).
         # @!attribute [rw] words
         #   @return [Array<Google::Cloud::Vision::V1::Word>]
         #     List of words in this paragraph.
@@ -210,7 +210,7 @@ module Google
         #         2----3
         #         |    |
         #         1----0
-        #         and the vertice order will still be (0, 1, 2, 3).
+        #         and the vertex order will still be (0, 1, 2, 3).
         # @!attribute [rw] symbols
         #   @return [Array<Google::Cloud::Vision::V1::Symbol>]
         #     List of symbols in the word.

data/lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/web_detection.rb

@@ -38,7 +38,8 @@ module Google
         #     The visually similar image results.
         # @!attribute [rw] best_guess_labels
         #   @return [Array<Google::Cloud::Vision::V1::WebDetection::WebLabel>]
-        #     Best guess text labels for the request image.
+        #     The service's best guess as to the topic of the request image.
+        #     Inferred from similar images on the open web.
         class WebDetection
           # Entity deduced from similar images on the Internet.
           # @!attribute [rw] entity_id

data/lib/google/cloud/vision/{version.rb → v1/doc/google/protobuf/empty.rb}

@@ -1,4 +1,4 @@
-# Copyright 2016 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -14,9 +14,16 @@
 
 
 module Google
-  module Cloud
-    module Vision
-      VERSION = "0.31.0".freeze
-    end
+  module Protobuf
+    # A generic empty message that you can re-use to avoid defining duplicated
+    # empty messages in your APIs. A typical example is to use it as the request
+    # or the response type of an API method. For instance:
+    #
+    #     service Foo {
+    #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+    #     }
+    #
+    # The JSON representation for `Empty` is empty JSON object `{}`.
+    class Empty; end
   end
-end
+end

data/lib/google/cloud/vision/v1/doc/google/protobuf/field_mask.rb

@@ -0,0 +1,230 @@
+# Copyright 2018 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+module Google
+  module Protobuf
+    # `FieldMask` represents a set of symbolic field paths, for example:
+    #
+    #     paths: "f.a"
+    #     paths: "f.b.d"
+    #
+    # Here `f` represents a field in some root message, `a` and `b`
+    # fields in the message found in `f`, and `d` a field found in the
+    # message in `f.b`.
+    #
+    # Field masks are used to specify a subset of fields that should be
+    # returned by a get operation or modified by an update operation.
+    # Field masks also have a custom JSON encoding (see below).
+    #
+    # = Field Masks in Projections
+    #
+    # When used in the context of a projection, a response message or
+    # sub-message is filtered by the API to only contain those fields as
+    # specified in the mask. For example, if the mask in the previous
+    # example is applied to a response message as follows:
+    #
+    #     f {
+    #       a : 22
+    #       b {
+    #         d : 1
+    #         x : 2
+    #       }
+    #       y : 13
+    #     }
+    #     z: 8
+    #
+    # The result will not contain specific values for fields x,y and z
+    # (their value will be set to the default, and omitted in proto text
+    # output):
+    #
+    #
+    #     f {
+    #       a : 22
+    #       b {
+    #         d : 1
+    #       }
+    #     }
+    #
+    # A repeated field is not allowed except at the last position of a
+    # paths string.
+    #
+    # If a FieldMask object is not present in a get operation, the
+    # operation applies to all fields (as if a FieldMask of all fields
+    # had been specified).
+    #
+    # Note that a field mask does not necessarily apply to the
+    # top-level response message. In case of a REST get operation, the
+    # field mask applies directly to the response, but in case of a REST
+    # list operation, the mask instead applies to each individual message
+    # in the returned resource list. In case of a REST custom method,
+    # other definitions may be used. Where the mask applies will be
+    # clearly documented together with its declaration in the API.  In
+    # any case, the effect on the returned resource/resources is required
+    # behavior for APIs.
+    #
+    # = Field Masks in Update Operations
+    #
+    # A field mask in update operations specifies which fields of the
+    # targeted resource are going to be updated. The API is required
+    # to only change the values of the fields as specified in the mask
+    # and leave the others untouched. If a resource is passed in to
+    # describe the updated values, the API ignores the values of all
+    # fields not covered by the mask.
+    #
+    # If a repeated field is specified for an update operation, the existing
+    # repeated values in the target resource will be overwritten by the new values.
+    # Note that a repeated field is only allowed in the last position of a `paths`
+    # string.
+    #
+    # If a sub-message is specified in the last position of the field mask for an
+    # update operation, then the existing sub-message in the target resource is
+    # overwritten. Given the target message:
+    #
+    #     f {
+    #       b {
+    #         d : 1
+    #         x : 2
+    #       }
+    #       c : 1
+    #     }
+    #
+    # And an update message:
+    #
+    #     f {
+    #       b {
+    #         d : 10
+    #       }
+    #     }
+    #
+    # then if the field mask is:
+    #
+    #  paths: "f.b"
+    #
+    # then the result will be:
+    #
+    #     f {
+    #       b {
+    #         d : 10
+    #       }
+    #       c : 1
+    #     }
+    #
+    # However, if the update mask was:
+    #
+    #  paths: "f.b.d"
+    #
+    # then the result would be:
+    #
+    #     f {
+    #       b {
+    #         d : 10
+    #         x : 2
+    #       }
+    #       c : 1
+    #     }
+    #
+    # In order to reset a field's value to the default, the field must
+    # be in the mask and set to the default value in the provided resource.
+    # Hence, in order to reset all fields of a resource, provide a default
+    # instance of the resource and set all fields in the mask, or do
+    # not provide a mask as described below.
+    #
+    # If a field mask is not present on update, the operation applies to
+    # all fields (as if a field mask of all fields has been specified).
+    # Note that in the presence of schema evolution, this may mean that
+    # fields the client does not know and has therefore not filled into
+    # the request will be reset to their default. If this is unwanted
+    # behavior, a specific service may require a client to always specify
+    # a field mask, producing an error if not.
+    #
+    # As with get operations, the location of the resource which
+    # describes the updated values in the request message depends on the
+    # operation kind. In any case, the effect of the field mask is
+    # required to be honored by the API.
+    #
+    # == Considerations for HTTP REST
+    #
+    # The HTTP kind of an update operation which uses a field mask must
+    # be set to PATCH instead of PUT in order to satisfy HTTP semantics
+    # (PUT must only be used for full updates).
+    #
+    # = JSON Encoding of Field Masks
+    #
+    # In JSON, a field mask is encoded as a single string where paths are
+    # separated by a comma. Fields name in each path are converted
+    # to/from lower-camel naming conventions.
+    #
+    # As an example, consider the following message declarations:
+    #
+    #     message Profile {
+    #       User user = 1;
+    #       Photo photo = 2;
+    #     }
+    #     message User {
+    #       string display_name = 1;
+    #       string address = 2;
+    #     }
+    #
+    # In proto a field mask for `Profile` may look as such:
+    #
+    #     mask {
+    #       paths: "user.display_name"
+    #       paths: "photo"
+    #     }
+    #
+    # In JSON, the same mask is represented as below:
+    #
+    #     {
+    #       mask: "user.displayName,photo"
+    #     }
+    #
+    # = Field Masks and Oneof Fields
+    #
+    # Field masks treat fields in oneofs just as regular fields. Consider the
+    # following message:
+    #
+    #     message SampleMessage {
+    #       oneof test_oneof {
+    #         string name = 4;
+    #         SubMessage sub_message = 9;
+    #       }
+    #     }
+    #
+    # The field mask can be:
+    #
+    #     mask {
+    #       paths: "name"
+    #     }
+    #
+    # Or:
+    #
+    #     mask {
+    #       paths: "sub_message"
+    #     }
+    #
+    # Note that oneof type names ("test_oneof" in this case) cannot be used in
+    # paths.
+    #
+    # == Field Mask Verification
+    #
+    # The implementation of any API method which has a FieldMask type field in the
+    # request should verify the included field paths, and return an
+    # `INVALID_ARGUMENT` error if any path is duplicated or unmappable.
+    # @!attribute [rw] paths
+    #   @return [Array<String>]
+    #     The set of field mask paths.
+    class FieldMask; end
+  end
+end

data/lib/google/cloud/vision/v1/doc/google/protobuf/timestamp.rb

@@ -0,0 +1,109 @@
+# Copyright 2018 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+module Google
+  module Protobuf
+    # A Timestamp represents a point in time independent of any time zone
+    # or calendar, represented as seconds and fractions of seconds at
+    # nanosecond resolution in UTC Epoch time. It is encoded using the
+    # Proleptic Gregorian Calendar which extends the Gregorian calendar
+    # backwards to year one. It is encoded assuming all minutes are 60
+    # seconds long, i.e. leap seconds are "smeared" so that no leap second
+    # table is needed for interpretation. Range is from
+    # 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z.
+    # By restricting to that range, we ensure that we can convert to
+    # and from  RFC 3339 date strings.
+    # See [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
+    #
+    # = Examples
+    #
+    # Example 1: Compute Timestamp from POSIX `time()`.
+    #
+    #     Timestamp timestamp;
+    #     timestamp.set_seconds(time(NULL));
+    #     timestamp.set_nanos(0);
+    #
+    # Example 2: Compute Timestamp from POSIX `gettimeofday()`.
+    #
+    #     struct timeval tv;
+    #     gettimeofday(&tv, NULL);
+    #
+    #     Timestamp timestamp;
+    #     timestamp.set_seconds(tv.tv_sec);
+    #     timestamp.set_nanos(tv.tv_usec * 1000);
+    #
+    # Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`.
+    #
+    #     FILETIME ft;
+    #     GetSystemTimeAsFileTime(&ft);
+    #     UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;
+    #
+    #     // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z
+    #     // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.
+    #     Timestamp timestamp;
+    #     timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
+    #     timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));
+    #
+    # Example 4: Compute Timestamp from Java `System.currentTimeMillis()`.
+    #
+    #     long millis = System.currentTimeMillis();
+    #
+    #     Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
+    #         .setNanos((int) ((millis % 1000) * 1000000)).build();
+    #
+    #
+    # Example 5: Compute Timestamp from current time in Python.
+    #
+    #     timestamp = Timestamp()
+    #     timestamp.GetCurrentTime()
+    #
+    # = JSON Mapping
+    #
+    # In JSON format, the Timestamp type is encoded as a string in the
+    # [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. That is, the
+    # format is "{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z"
+    # where {year} is always expressed using four digits while {month}, {day},
+    # {hour}, {min}, and {sec} are zero-padded to two digits each. The fractional
+    # seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution),
+    # are optional. The "Z" suffix indicates the timezone ("UTC"); the timezone
+    # is required. A proto3 JSON serializer should always use UTC (as indicated by
+    # "Z") when printing the Timestamp type and a proto3 JSON parser should be
+    # able to accept both UTC and other timezones (as indicated by an offset).
+    #
+    # For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past
+    # 01:30 UTC on January 15, 2017.
+    #
+    # In JavaScript, one can convert a Date object to this format using the
+    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString]
+    # method. In Python, a standard `datetime.datetime` object can be converted
+    # to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
+    # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
+    # can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
+    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime--
+    # ) to obtain a formatter capable of generating timestamps in this format.
+    # @!attribute [rw] seconds
+    #   @return [Integer]
+    #     Represents seconds of UTC time since Unix epoch
+    #     1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
+    #     9999-12-31T23:59:59Z inclusive.
+    # @!attribute [rw] nanos
+    #   @return [Integer]
+    #     Non-negative fractions of a second at nanosecond resolution. Negative
+    #     second values with fractions must still have non-negative nanos values
+    #     that count forward in time. Must be from 0 to 999,999,999
+    #     inclusive.
+    class Timestamp; end
+  end
+end

data/lib/google/cloud/vision/v1/geometry_pb.rb

@@ -4,6 +4,7 @@
 
 require 'google/protobuf'
 
+require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.vision.v1.Vertex" do
     optional :x, :int32, 1

data/lib/google/cloud/vision/v1/helpers.rb

@@ -0,0 +1,972 @@
+# Copyright 2018 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# # limitations under the License.
+
+
+require "uri"
+
+module Google
+  module Cloud
+    module Vision
+      module V1
+        class ImageAnnotatorClient
+
+          # @param images [Array<String>, Array<File>]
+          #   An array containing files, file paths, io objects, image urls, or Google Cloud Storage urls. Can be used with or instead of image.
+          # @param image [File, String]
+          #   A file, file path, io object, url pointing to an image, or Google Cloud Storage url. Can be used with or instead of images.
+          # @param max_results [Integer]
+          #   Optional. Defaults to 10.
+          # @param options [Google::Gax::CallOptions]
+          #   Optional. Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @param async [Boolean]
+          #   Optional. Defaults to false. Specifies whether to preform the request synchronously and return a 
+          #   BatchAnnotateImagesResponse instance or to return a Google::Gax::Operation.
+          # @param mime_type [String]
+          #   Required only if async is true.
+          # @param batch_size [Integer]
+          #   Optional. Defaults to 10. When async is true, this specifies the number of input files per output json.
+          # @param destination [String]
+          #   Required only if async is true. A Google Cloud Storage location for storing the output.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Vision::V1::BatchAnnotateImagesResponse, Google::Gax::Operation]
+          # @example
+          #   require "google/cloud/vision"
+          #
+          #   image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new(version: :v1)
+          #
+          #   response = image_annotator_client.face_detection image: "path\to\image.png"
+          #   response.responses.each do |res|
+          #     puts res
+          #   end
+
+          def face_detection \
+            images: [], 
+            image: nil,
+            max_results: 10,
+            options: nil,
+            async: false,
+            mime_type: nil,
+            batch_size: 10,
+            destination: nil,
+            &blk
+
+            feature = { type: :FACE_DETECTION }
+            feature[:max_results] = max_results
+            images << image if image
+
+            formatted_images = images.map do |img|
+              formatted_image = normalize_image img
+              formatted_image[:mime_type] = mime_type if mime_type
+              formatted_image
+            end
+
+            requests = formatted_images.map do |img|
+              {
+                image: img,
+                features: [feature]
+              }
+            end
+
+            if async
+              requests.map! do |request|
+                {
+                  input_config: request[:image],
+                  features: request[:features],
+                  output_config: {
+                    gcs_destination: destination,
+                    batch_size: batch_size
+                  }
+                }
+              end
+              async_batch_annotate_files requests, options
+            else
+              batch_annotate_images requests, options, &blk
+            end
+          end
+
+          # @param images [Array<String>, Array<File>]
+          #   An array containing files, file paths, io objects, image urls, or Google Cloud Storage urls. Can be used with or instead of image.
+          # @param image [File, String]
+          #   A file, file path, io object, url pointing to an image, or Google Cloud Storage url. Can be used with or instead of images.
+          # @param max_results [Integer]
+          #   Optional. Defaults to 10.
+          # @param options [Google::Gax::CallOptions]
+          #   Optional. Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @param async [Boolean]
+          #   Optional. Defaults to false. Specifies whether to preform the request synchronously and return a 
+          #   BatchAnnotateImagesResponse instance or to return a Google::Gax::Operation.
+          # @param mime_type [String]
+          #   Required only if async is true.
+          # @param batch_size [Integer]
+          #   Optional. Defaults to 10. When async is true, this specifies the number of input files per output json.
+          # @param destination [String]
+          #   Required only if async is true. A Google Cloud Storage location for storing the output.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Vision::V1::BatchAnnotateImagesResponse, Google::Gax::Operation]
+          # @example
+          #   require "google/cloud/vision"
+          #
+          #   image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new(version: :v1)
+          #
+          #   response = image_annotator_client.landmark_detection image: "path\to\image.png"
+          #   response.responses.each do |res|
+          #     puts res
+          #   end
+
+          def landmark_detection \
+            images: [], 
+            image: nil,
+            max_results: 10,
+            options: nil,
+            async: false,
+            mime_type: nil,
+            batch_size: 10,
+            destination: nil,
+            &blk
+
+            feature = { type: :LANDMARK_DETECTION }
+            feature[:max_results] = max_results
+            images << image if image
+
+            formatted_images = images.map do |img|
+              formatted_image = normalize_image img
+              formatted_image[:mime_type] = mime_type if mime_type
+              formatted_image
+            end
+
+            requests = formatted_images.map do |img|
+              {
+                image: img,
+                features: [feature]
+              }
+            end
+
+            if async
+              requests.map! do |request|
+                {
+                  input_config: request[:image],
+                  features: request[:features],
+                  output_config: {
+                    gcs_destination: destination,
+                    batch_size: batch_size
+                  }
+                }
+              end
+              async_batch_annotate_files requests, options
+            else
+              batch_annotate_images requests, options, &blk
+            end
+          end
+
+          # @param images [Array<String>, Array<File>]
+          #   An array containing files, file paths, io objects, image urls, or Google Cloud Storage urls. Can be used with or instead of image.
+          # @param image [File, String]
+          #   A file, file path, io object, url pointing to an image, or Google Cloud Storage url. Can be used with or instead of images.
+          # @param max_results [Integer]
+          #   Optional. Defaults to 10.
+          # @param options [Google::Gax::CallOptions]
+          #   Optional. Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @param async [Boolean]
+          #   Optional. Defaults to false. Specifies whether to preform the request synchronously and return a 
+          #   BatchAnnotateImagesResponse instance or to return a Google::Gax::Operation.
+          # @param mime_type [String]
+          #   Required only if async is true.
+          # @param batch_size [Integer]
+          #   Optional. Defaults to 10. When async is true, this specifies the number of input files per output json.
+          # @param destination [String]
+          #   Required only if async is true. A Google Cloud Storage location for storing the output.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Vision::V1::BatchAnnotateImagesResponse, Google::Gax::Operation]
+          # @example
+          #   require "google/cloud/vision"
+          #
+          #   image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new(version: :v1)
+          #
+          #   response = image_annotator_client.logo_detection image: "path\to\image.png"
+          #   response.responses.each do |res|
+          #     puts res
+          #   end
+
+          def logo_detection \
+            images: [], 
+            image: nil,
+            max_results: 10,
+            options: nil,
+            async: false,
+            mime_type: nil,
+            batch_size: 10,
+            destination: nil,
+            &blk
+
+            feature = { type: :LOGO_DETECTION }
+            feature[:max_results] = max_results
+            images << image if image
+
+            formatted_images = images.map do |img|
+              formatted_image = normalize_image img
+              formatted_image[:mime_type] = mime_type if mime_type
+              formatted_image
+            end
+
+            requests = formatted_images.map do |img|
+              {
+                image: img,
+                features: [feature]
+              }
+            end
+
+            if async
+              requests.map! do |request|
+                {
+                  input_config: request[:image],
+                  features: request[:features],
+                  output_config: {
+                    gcs_destination: destination,
+                    batch_size: batch_size
+                  }
+                }
+              end
+              async_batch_annotate_files requests, options
+            else
+              batch_annotate_images requests, options, &blk
+            end
+          end
+
+          # @param images [Array<String>, Array<File>]
+          #   An array containing files, file paths, io objects, image urls, or Google Cloud Storage urls. Can be used with or instead of image.
+          # @param image [File, String]
+          #   A file, file path, io object, url pointing to an image, or Google Cloud Storage url. Can be used with or instead of images.
+          # @param max_results [Integer]
+          #   Optional. Defaults to 10.
+          # @param options [Google::Gax::CallOptions]
+          #   Optional. Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @param async [Boolean]
+          #   Optional. Defaults to false. Specifies whether to preform the request synchronously and return a 
+          #   BatchAnnotateImagesResponse instance or to return a Google::Gax::Operation.
+          # @param mime_type [String]
+          #   Required only if async is true.
+          # @param batch_size [Integer]
+          #   Optional. Defaults to 10. When async is true, this specifies the number of input files per output json.
+          # @param destination [String]
+          #   Required only if async is true. A Google Cloud Storage location for storing the output.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Vision::V1::BatchAnnotateImagesResponse, Google::Gax::Operation]
+          # @example
+          #   require "google/cloud/vision"
+          #
+          #   image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new(version: :v1)
+          #
+          #   response = image_annotator_client.label_detection image: "path\to\image.png"
+          #   response.responses.each do |res|
+          #     puts res
+          #   end
+
+          def label_detection \
+            images: [], 
+            image: nil,
+            max_results: 10,
+            options: nil,
+            async: false,
+            mime_type: nil,
+            batch_size: 10,
+            destination: nil,
+            &blk
+
+            feature = { type: :LABEL_DETECTION }
+            feature[:max_results] = max_results
+            images << image if image
+
+            formatted_images = images.map do |img|
+              formatted_image = normalize_image img
+              formatted_image[:mime_type] = mime_type if mime_type
+              formatted_image
+            end
+
+            requests = formatted_images.map do |img|
+              {
+                image: img,
+                features: [feature]
+              }
+            end
+
+            if async
+              requests.map! do |request|
+                {
+                  input_config: request[:image],
+                  features: request[:features],
+                  output_config: {
+                    gcs_destination: destination,
+                    batch_size: batch_size
+                  }
+                }
+              end
+              async_batch_annotate_files requests, options
+            else
+              batch_annotate_images requests, options, &blk
+            end
+          end
+
+          # @param images [Array<String>, Array<File>]
+          #   An array containing files, file paths, io objects, image urls, or Google Cloud Storage urls. Can be used with or instead of image.
+          # @param image [File, String]
+          #   A file, file path, io object, url pointing to an image, or Google Cloud Storage url. Can be used with or instead of images.
+          # @param max_results [Integer]
+          #   Optional. Defaults to 10.
+          # @param options [Google::Gax::CallOptions]
+          #   Optional. Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @param async [Boolean]
+          #   Optional. Defaults to false. Specifies whether to preform the request synchronously and return a 
+          #   BatchAnnotateImagesResponse instance or to return a Google::Gax::Operation.
+          # @param mime_type [String]
+          #   Required only if async is true.
+          # @param batch_size [Integer]
+          #   Optional. Defaults to 10. When async is true, this specifies the number of input files per output json.
+          # @param destination [String]
+          #   Required only if async is true. A Google Cloud Storage location for storing the output.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Vision::V1::BatchAnnotateImagesResponse, Google::Gax::Operation]
+          # @example
+          #   require "google/cloud/vision"
+          #
+          #   image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new(version: :v1)
+          #
+          #   response = image_annotator_client.text_detection image: "path\to\image.png"
+          #   response.responses.each do |res|
+          #     puts res
+          #   end
+
+          def text_detection \
+            images: [], 
+            image: nil,
+            max_results: 10,
+            options: nil,
+            async: false,
+            mime_type: nil,
+            batch_size: 10,
+            destination: nil,
+            &blk
+
+            feature = { type: :TEXT_DETECTION }
+            feature[:max_results] = max_results
+            images << image if image
+
+            formatted_images = images.map do |img|
+              formatted_image = normalize_image img
+              formatted_image[:mime_type] = mime_type if mime_type
+              formatted_image
+            end
+
+            requests = formatted_images.map do |img|
+              {
+                image: img,
+                features: [feature]
+              }
+            end
+
+            if async
+              requests.map! do |request|
+                {
+                  input_config: request[:image],
+                  features: request[:features],
+                  output_config: {
+                    gcs_destination: destination,
+                    batch_size: batch_size
+                  }
+                }
+              end
+              async_batch_annotate_files requests, options
+            else
+              batch_annotate_images requests, options, &blk
+            end
+          end
+
+          # @param images [Array<String>, Array<File>]
+          #   An array containing files, file paths, io objects, image urls, or Google Cloud Storage urls. Can be used with or instead of image.
+          # @param image [File, String]
+          #   A file, file path, io object, url pointing to an image, or Google Cloud Storage url. Can be used with or instead of images.
+          # @param max_results [Integer]
+          #   Optional. Defaults to 10.
+          # @param options [Google::Gax::CallOptions]
+          #   Optional. Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @param async [Boolean]
+          #   Optional. Defaults to false. Specifies whether to preform the request synchronously and return a 
+          #   BatchAnnotateImagesResponse instance or to return a Google::Gax::Operation.
+          # @param mime_type [String]
+          #   Required only if async is true.
+          # @param batch_size [Integer]
+          #   Optional. Defaults to 10. When async is true, this specifies the number of input files per output json.
+          # @param destination [String]
+          #   Required only if async is true. A Google Cloud Storage location for storing the output.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Vision::V1::BatchAnnotateImagesResponse, Google::Gax::Operation]
+          # @example
+          #   require "google/cloud/vision"
+          #
+          #   image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new(version: :v1)
+          #
+          #   response = image_annotator_client.document_text_detection image: "path\to\image.png"
+          #   response.responses.each do |res|
+          #     puts res
+          #   end
+
+          def document_text_detection \
+            images: [], 
+            image: nil,
+            max_results: 10,
+            options: nil,
+            async: false,
+            mime_type: nil,
+            batch_size: 10,
+            destination: nil,
+            &blk
+
+            feature = { type: :DOCUMENT_TEXT_DETECTION }
+            feature[:max_results] = max_results
+            images << image if image
+
+            formatted_images = images.map do |img|
+              formatted_image = normalize_image img
+              formatted_image[:mime_type] = mime_type if mime_type
+              formatted_image
+            end
+
+            requests = formatted_images.map do |img|
+              {
+                image: img,
+                features: [feature]
+              }
+            end
+
+            if async
+              requests.map! do |request|
+                {
+                  input_config: request[:image],
+                  features: request[:features],
+                  output_config: {
+                    gcs_destination: destination,
+                    batch_size: batch_size
+                  }
+                }
+              end
+              async_batch_annotate_files requests, options
+            else
+              batch_annotate_images requests, options, &blk
+            end
+          end
+
+          # @param images [Array<String>, Array<File>]
+          #   An array containing files, file paths, io objects, image urls, or Google Cloud Storage urls. Can be used with or instead of image.
+          # @param image [File, String]
+          #   A file, file path, io object, url pointing to an image, or Google Cloud Storage url. Can be used with or instead of images.
+          # @param max_results [Integer]
+          #   Optional. Defaults to 10.
+          # @param options [Google::Gax::CallOptions]
+          #   Optional. Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @param async [Boolean]
+          #   Optional. Defaults to false. Specifies whether to preform the request synchronously and return a 
+          #   BatchAnnotateImagesResponse instance or to return a Google::Gax::Operation.
+          # @param mime_type [String]
+          #   Required only if async is true.
+          # @param batch_size [Integer]
+          #   Optional. Defaults to 10. When async is true, this specifies the number of input files per output json.
+          # @param destination [String]
+          #   Required only if async is true. A Google Cloud Storage location for storing the output.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Vision::V1::BatchAnnotateImagesResponse, Google::Gax::Operation]
+          # @example
+          #   require "google/cloud/vision"
+          #
+          #   image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new(version: :v1)
+          #
+          #   response = image_annotator_client.safe_search_detection image: "path\to\image.png"
+          #   response.responses.each do |res|
+          #     puts res
+          #   end
+
+          def safe_search_detection \
+            images: [], 
+            image: nil,
+            max_results: 10,
+            options: nil,
+            async: false,
+            mime_type: nil,
+            batch_size: 10,
+            destination: nil,
+            &blk
+
+            feature = { type: :SAFE_SEARCH_DETECTION }
+            feature[:max_results] = max_results
+            images << image if image
+
+            formatted_images = images.map do |img|
+              formatted_image = normalize_image img
+              formatted_image[:mime_type] = mime_type if mime_type
+              formatted_image
+            end
+
+            requests = formatted_images.map do |img|
+              {
+                image: img,
+                features: [feature]
+              }
+            end
+
+            if async
+              requests.map! do |request|
+                {
+                  input_config: request[:image],
+                  features: request[:features],
+                  output_config: {
+                    gcs_destination: destination,
+                    batch_size: batch_size
+                  }
+                }
+              end
+              async_batch_annotate_files requests, options
+            else
+              batch_annotate_images requests, options, &blk
+            end
+          end
+
+          # @param images [Array<String>, Array<File>]
+          #   An array containing files, file paths, io objects, image urls, or Google Cloud Storage urls. Can be used with or instead of image.
+          # @param image [File, String]
+          #   A file, file path, io object, url pointing to an image, or Google Cloud Storage url. Can be used with or instead of images.
+          # @param max_results [Integer]
+          #   Optional. Defaults to 10.
+          # @param options [Google::Gax::CallOptions]
+          #   Optional. Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @param async [Boolean]
+          #   Optional. Defaults to false. Specifies whether to preform the request synchronously and return a 
+          #   BatchAnnotateImagesResponse instance or to return a Google::Gax::Operation.
+          # @param mime_type [String]
+          #   Required only if async is true.
+          # @param batch_size [Integer]
+          #   Optional. Defaults to 10. When async is true, this specifies the number of input files per output json.
+          # @param destination [String]
+          #   Required only if async is true. A Google Cloud Storage location for storing the output.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Vision::V1::BatchAnnotateImagesResponse, Google::Gax::Operation]
+          # @example
+          #   require "google/cloud/vision"
+          #
+          #   image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new(version: :v1)
+          #
+          #   response = image_annotator_client.image_properties_detection image: "path\to\image.png"
+          #   response.responses.each do |res|
+          #     puts res
+          #   end
+
+          def image_properties_detection \
+            images: [], 
+            image: nil,
+            max_results: 10,
+            options: nil,
+            async: false,
+            mime_type: nil,
+            batch_size: 10,
+            destination: nil,
+            &blk
+
+            feature = { type: :IMAGE_PROPERTIES }
+            feature[:max_results] = max_results
+            images << image if image
+
+            formatted_images = images.map do |img|
+              formatted_image = normalize_image img
+              formatted_image[:mime_type] = mime_type if mime_type
+              formatted_image
+            end
+
+            requests = formatted_images.map do |img|
+              {
+                image: img,
+                features: [feature]
+              }
+            end
+
+            if async
+              requests.map! do |request|
+                {
+                  input_config: request[:image],
+                  features: request[:features],
+                  output_config: {
+                    gcs_destination: destination,
+                    batch_size: batch_size
+                  }
+                }
+              end
+              async_batch_annotate_files requests, options
+            else
+              batch_annotate_images requests, options, &blk
+            end
+          end
+
+          # @param images [Array<String>, Array<File>]
+          #   An array containing files, file paths, io objects, image urls, or Google Cloud Storage urls. Can be used with or instead of image.
+          # @param image [File, String]
+          #   A file, file path, io object, url pointing to an image, or Google Cloud Storage url. Can be used with or instead of images.
+          # @param max_results [Integer]
+          #   Optional. Defaults to 10.
+          # @param options [Google::Gax::CallOptions]
+          #   Optional. Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @param async [Boolean]
+          #   Optional. Defaults to false. Specifies whether to preform the request synchronously and return a 
+          #   BatchAnnotateImagesResponse instance or to return a Google::Gax::Operation.
+          # @param mime_type [String]
+          #   Required only if async is true.
+          # @param batch_size [Integer]
+          #   Optional. Defaults to 10. When async is true, this specifies the number of input files per output json.
+          # @param destination [String]
+          #   Required only if async is true. A Google Cloud Storage location for storing the output.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Vision::V1::BatchAnnotateImagesResponse, Google::Gax::Operation]
+          # @example
+          #   require "google/cloud/vision"
+          #
+          #   image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new(version: :v1)
+          #
+          #   response = image_annotator_client.crop_hints_detection image: "path\to\image.png"
+          #   response.responses.each do |res|
+          #     puts res
+          #   end
+
+          def crop_hints_detection \
+            images: [], 
+            image: nil,
+            max_results: 10,
+            options: nil,
+            async: false,
+            mime_type: nil,
+            batch_size: 10,
+            destination: nil,
+            &blk
+
+            feature = { type: :CROP_HINTS }
+            feature[:max_results] = max_results
+            images << image if image
+
+            formatted_images = images.map do |img|
+              formatted_image = normalize_image img
+              formatted_image[:mime_type] = mime_type if mime_type
+              formatted_image
+            end
+
+            requests = formatted_images.map do |img|
+              {
+                image: img,
+                features: [feature]
+              }
+            end
+
+            if async
+              requests.map! do |request|
+                {
+                  input_config: request[:image],
+                  features: request[:features],
+                  output_config: {
+                    gcs_destination: destination,
+                    batch_size: batch_size
+                  }
+                }
+              end
+              async_batch_annotate_files requests, options
+            else
+              batch_annotate_images requests, options, &blk
+            end
+          end
+
+          # @param images [Array<String>, Array<File>]
+          #   An array containing files, file paths, io objects, image urls, or Google Cloud Storage urls. Can be used with or instead of image.
+          # @param image [File, String]
+          #   A file, file path, io object, url pointing to an image, or Google Cloud Storage url. Can be used with or instead of images.
+          # @param max_results [Integer]
+          #   Optional. Defaults to 10.
+          # @param options [Google::Gax::CallOptions]
+          #   Optional. Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @param async [Boolean]
+          #   Optional. Defaults to false. Specifies whether to preform the request synchronously and return a 
+          #   BatchAnnotateImagesResponse instance or to return a Google::Gax::Operation.
+          # @param mime_type [String]
+          #   Required only if async is true.
+          # @param batch_size [Integer]
+          #   Optional. Defaults to 10. When async is true, this specifies the number of input files per output json.
+          # @param destination [String]
+          #   Required only if async is true. A Google Cloud Storage location for storing the output.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Vision::V1::BatchAnnotateImagesResponse, Google::Gax::Operation]
+          # @example
+          #   require "google/cloud/vision"
+          #
+          #   image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new(version: :v1)
+          #
+          #   response = image_annotator_client.product_search_detection image: "path\to\image.png"
+          #   response.responses.each do |res|
+          #     puts res
+          #   end
+
+          def product_search_detection \
+            images: [], 
+            image: nil,
+            max_results: 10,
+            options: nil,
+            async: false,
+            mime_type: nil,
+            batch_size: 10,
+            destination: nil,
+            &blk
+
+            feature = { type: :PRODUCT_SEARCH }
+            feature[:max_results] = max_results
+            images << image if image
+
+            formatted_images = images.map do |img|
+              formatted_image = normalize_image img
+              formatted_image[:mime_type] = mime_type if mime_type
+              formatted_image
+            end
+
+            requests = formatted_images.map do |img|
+              {
+                image: img,
+                features: [feature]
+              }
+            end
+
+            if async
+              requests.map! do |request|
+                {
+                  input_config: request[:image],
+                  features: request[:features],
+                  output_config: {
+                    gcs_destination: destination,
+                    batch_size: batch_size
+                  }
+                }
+              end
+              async_batch_annotate_files requests, options
+            else
+              batch_annotate_images requests, options, &blk
+            end
+          end
+
+          # @param images [Array<String>, Array<File>]
+          #   An array containing files, file paths, io objects, image urls, or Google Cloud Storage urls. Can be used with or instead of image.
+          # @param image [File, String]
+          #   A file, file path, io object, url pointing to an image, or Google Cloud Storage url. Can be used with or instead of images.
+          # @param max_results [Integer]
+          #   Optional. Defaults to 10.
+          # @param options [Google::Gax::CallOptions]
+          #   Optional. Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @param async [Boolean]
+          #   Optional. Defaults to false. Specifies whether to preform the request synchronously and return a 
+          #   BatchAnnotateImagesResponse instance or to return a Google::Gax::Operation.
+          # @param mime_type [String]
+          #   Required only if async is true.
+          # @param batch_size [Integer]
+          #   Optional. Defaults to 10. When async is true, this specifies the number of input files per output json.
+          # @param destination [String]
+          #   Required only if async is true. A Google Cloud Storage location for storing the output.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Vision::V1::BatchAnnotateImagesResponse, Google::Gax::Operation]
+          # @example
+          #   require "google/cloud/vision"
+          #
+          #   image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new(version: :v1)
+          #
+          #   response = image_annotator_client.object_localization_detection image: "path\to\image.png"
+          #   response.responses.each do |res|
+          #     puts res
+          #   end
+
+          def object_localization_detection \
+            images: [], 
+            image: nil,
+            max_results: 10,
+            options: nil,
+            async: false,
+            mime_type: nil,
+            batch_size: 10,
+            destination: nil,
+            &blk
+
+            feature = { type: :OBJECT_LOCALIZATION }
+            feature[:max_results] = max_results
+            images << image if image
+
+            formatted_images = images.map do |img|
+              formatted_image = normalize_image img
+              formatted_image[:mime_type] = mime_type if mime_type
+              formatted_image
+            end
+
+            requests = formatted_images.map do |img|
+              {
+                image: img,
+                features: [feature]
+              }
+            end
+
+            if async
+              requests.map! do |request|
+                {
+                  input_config: request[:image],
+                  features: request[:features],
+                  output_config: {
+                    gcs_destination: destination,
+                    batch_size: batch_size
+                  }
+                }
+              end
+              async_batch_annotate_files requests, options
+            else
+              batch_annotate_images requests, options, &blk
+            end
+          end
+
+          # @param images [Array<String>, Array<File>]
+          #   An array containing files, file paths, io objects, image urls, or Google Cloud Storage urls. Can be used with or instead of image.
+          # @param image [File, String]
+          #   A file, file path, io object, url pointing to an image, or Google Cloud Storage url. Can be used with or instead of images.
+          # @param max_results [Integer]
+          #   Optional. Defaults to 10.
+          # @param options [Google::Gax::CallOptions]
+          #   Optional. Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @param async [Boolean]
+          #   Optional. Defaults to false. Specifies whether to preform the request synchronously and return a 
+          #   BatchAnnotateImagesResponse instance or to return a Google::Gax::Operation.
+          # @param mime_type [String]
+          #   Required only if async is true.
+          # @param batch_size [Integer]
+          #   Optional. Defaults to 10. When async is true, this specifies the number of input files per output json.
+          # @param destination [String]
+          #   Required only if async is true. A Google Cloud Storage location for storing the output.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Vision::V1::BatchAnnotateImagesResponse, Google::Gax::Operation]
+          # @example
+          #   require "google/cloud/vision"
+          #
+          #   image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new(version: :v1)
+          #
+          #   response = image_annotator_client.web_detection image: "path\to\image.png"
+          #   response.responses.each do |res|
+          #     puts res
+          #   end
+
+          def web_detection \
+            images: [], 
+            image: nil,
+            max_results: 10,
+            options: nil,
+            async: false,
+            mime_type: nil,
+            batch_size: 10,
+            destination: nil,
+            &blk
+
+            feature = { type: :WEB_DETECTION }
+            feature[:max_results] = max_results
+            images << image if image
+
+            formatted_images = images.map do |img|
+              formatted_image = normalize_image img
+              formatted_image[:mime_type] = mime_type if mime_type
+              formatted_image
+            end
+
+            requests = formatted_images.map do |img|
+              {
+                image: img,
+                features: [feature]
+              }
+            end
+
+            if async
+              requests.map! do |request|
+                {
+                  input_config: request[:image],
+                  features: request[:features],
+                  output_config: {
+                    gcs_destination: destination,
+                    batch_size: batch_size
+                  }
+                }
+              end
+              async_batch_annotate_files requests, options
+            else
+              batch_annotate_images requests, options, &blk
+            end
+          end
+
+          private
+
+          def normalize_image image
+            formatted_image =
+              if image.respond_to? :binmode
+                { content: image.binmode.read }
+              elsif image.is_a? String
+                if File.file? image
+                  { content: File.binread(image) }
+                elsif image =~ URI::DEFAULT_PARSER.make_regexp
+                  if URI(image).scheme == "gs"
+                    { source: { gcs_image_uri: image } }
+                  else
+                    { source: { image_uri: image } }
+                  end
+                end
+              end
+            raise TypeError.new("Image must be a filepath, url, or IO object") unless formatted_image
+            formatted_image
+          end
+        end
+      end
+    end
+  end
+end