google-api-client 0.40.1 → 0.42.0

data/generated/google/apis/slides_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/slides/
     module SlidesV1
       VERSION = 'V1'
-      REVISION = '20200410'
+      REVISION = '20200611'
 
       # See, edit, create, and delete all of your Google Drive files
       AUTH_DRIVE = 'https://www.googleapis.com/auth/drive'

data/generated/google/apis/slides_v1/classes.rb

@@ -2149,6 +2149,8 @@ module Google
       
         # The description of the page element. Combined with title to display alt
         # text.
+        # The field is not supported for Group
+        # elements.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
@@ -2203,6 +2205,8 @@ module Google
       
         # The title of the page element. Combined with description to display alt
         # text.
+        # The field is not supported for Group
+        # elements.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title

data/generated/google/apis/spanner_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/spanner/
     module SpannerV1
       VERSION = 'V1'
-      REVISION = '20200526'
+      REVISION = '20200623'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/spanner_v1/classes.rb

@@ -190,10 +190,11 @@ module Google
         include Google::Apis::Core::Hashable
       
         # # Transactions
-        # Each session can have at most one active transaction at a time. After the
-        # active transaction is completed, the session can immediately be
-        # re-used for the next transaction. It is not necessary to create a
-        # new session for each transaction.
+        # Each session can have at most one active transaction at a time (note that
+        # standalone reads and queries use a transaction internally and do count
+        # towards the one transaction limit). After the active transaction is
+        # completed, the session can immediately be re-used for the next transaction.
+        # It is not necessary to create a new session for each transaction.
         # # Transaction Modes
         # Cloud Spanner supports three transaction modes:
         # 1. Locking read-write. This type of transaction is the only way
@@ -555,10 +556,11 @@ module Google
         attr_accessor :mutations
       
         # # Transactions
-        # Each session can have at most one active transaction at a time. After the
-        # active transaction is completed, the session can immediately be
-        # re-used for the next transaction. It is not necessary to create a
-        # new session for each transaction.
+        # Each session can have at most one active transaction at a time (note that
+        # standalone reads and queries use a transaction internally and do count
+        # towards the one transaction limit). After the active transaction is
+        # completed, the session can immediately be re-used for the next transaction.
+        # It is not necessary to create a new session for each transaction.
         # # Transaction Modes
         # Cloud Spanner supports three transaction modes:
         # 1. Locking read-write. This type of transaction is the only way
@@ -3519,10 +3521,11 @@ module Google
       end
       
       # # Transactions
-      # Each session can have at most one active transaction at a time. After the
-      # active transaction is completed, the session can immediately be
-      # re-used for the next transaction. It is not necessary to create a
-      # new session for each transaction.
+      # Each session can have at most one active transaction at a time (note that
+      # standalone reads and queries use a transaction internally and do count
+      # towards the one transaction limit). After the active transaction is
+      # completed, the session can immediately be re-used for the next transaction.
+      # It is not necessary to create a new session for each transaction.
       # # Transaction Modes
       # Cloud Spanner supports three transaction modes:
       # 1. Locking read-write. This type of transaction is the only way
@@ -3772,10 +3775,11 @@ module Google
         include Google::Apis::Core::Hashable
       
         # # Transactions
-        # Each session can have at most one active transaction at a time. After the
-        # active transaction is completed, the session can immediately be
-        # re-used for the next transaction. It is not necessary to create a
-        # new session for each transaction.
+        # Each session can have at most one active transaction at a time (note that
+        # standalone reads and queries use a transaction internally and do count
+        # towards the one transaction limit). After the active transaction is
+        # completed, the session can immediately be re-used for the next transaction.
+        # It is not necessary to create a new session for each transaction.
         # # Transaction Modes
         # Cloud Spanner supports three transaction modes:
         # 1. Locking read-write. This type of transaction is the only way
@@ -3997,10 +4001,11 @@ module Google
         attr_accessor :id
       
         # # Transactions
-        # Each session can have at most one active transaction at a time. After the
-        # active transaction is completed, the session can immediately be
-        # re-used for the next transaction. It is not necessary to create a
-        # new session for each transaction.
+        # Each session can have at most one active transaction at a time (note that
+        # standalone reads and queries use a transaction internally and do count
+        # towards the one transaction limit). After the active transaction is
+        # completed, the session can immediately be re-used for the next transaction.
+        # It is not necessary to create a new session for each transaction.
         # # Transaction Modes
         # Cloud Spanner supports three transaction modes:
         # 1. Locking read-write. This type of transaction is the only way

data/generated/google/apis/spanner_v1/service.rb

@@ -1299,6 +1299,8 @@ module Google
         # be queried using the Operations API.
         # @param [String] database
         #   Required. The database whose schema we wish to get.
+        #   Values are of the form
+        #   `projects/<project>/instances/<instance>/databases/<database>`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1815,6 +1817,11 @@ module Google
         # transactions. However, it can also happen for a variety of other
         # reasons. If `Commit` returns `ABORTED`, the caller should re-attempt
         # the transaction from the beginning, re-using the same session.
+        # On very rare occasions, `Commit` might return `UNKNOWN`. This can happen,
+        # for example, if the client job experiences a 1+ hour networking failure.
+        # At that point, Cloud Spanner has lost track of the transaction outcome and
+        # we recommend that you perform another read from the database to see the
+        # state of things as they are now.
         # @param [String] session
         #   Required. The session in which the transaction to be committed is running.
         # @param [Google::Apis::SpannerV1::CommitRequest] commit_request_object

data/generated/google/apis/speech_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/speech-to-text/docs/quickstart-protocol
     module SpeechV1
       VERSION = 'V1'
-      REVISION = '20200409'
+      REVISION = '20200617'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/speech_v1p1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/speech-to-text/docs/quickstart-protocol
     module SpeechV1p1beta1
       VERSION = 'V1p1beta1'
-      REVISION = '20200502'
+      REVISION = '20200617'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/storage_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/storage/docs/json_api/
     module StorageV1
       VERSION = 'V1'
-      REVISION = '20200430'
+      REVISION = '20200611'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/storage_v1/service.rb

@@ -1617,9 +1617,8 @@ module Google
         #   Makes the operation conditional on whether the object's current metageneration
         #   matches the given value.
         # @param [String] kms_key_name
-        #   Resource name of the Cloud KMS key, of the form projects/my-project/locations/
-        #   global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the
-        #   object. Overrides the object metadata's kms_key_name value, if any.
+        #   Not currently supported. Specifying the parameter causes the request to fail
+        #   with status code 400 - Bad Request.
         # @param [String] provisional_user_project
         #   The project to be billed for this request if the target bucket is requester-
         #   pays bucket.

data/generated/google/apis/testing_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/cloud-test-lab/
     module TestingV1
       VERSION = 'V1'
-      REVISION = '20200603'
+      REVISION = '20200706'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/testing_v1/classes.rb

@@ -1528,7 +1528,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. Group of packages, classes, and/or test methods to be run for
-        # each shard. The number of shard_test_targets must be >= 1 and <= 50.
+        # each shard. When any physical devices are selected,  the number of
+        # test_targets_for_shard must be >= 1 and <= 50. When no physical devices are
+        # selected, the number must be >= 1 and <= 250.
         # Corresponds to the JSON property `testTargetsForShard`
         # @return [Array<Google::Apis::TestingV1::TestTargetsForShard>]
         attr_accessor :test_targets_for_shard
@@ -1688,10 +1690,10 @@ module Google
         attr_accessor :content
       
         # Required. Where to put the content on the device. Must be an absolute,
-        # whitelisted path. If the file exists, it will be replaced.
+        # allowlisted path. If the file exists, it will be replaced.
         # The following device-side directories and any of their subdirectories are
-        # whitelisted:
-        # <p>$`EXTERNAL_STORAGE`, or /sdcard</p>
+        # allowlisted:
+        # <p>$`EXTERNAL_STORAGE`, /sdcard, or /storage</p>
         # <p>$`ANDROID_DATA`/local/tmp, or /data/local/tmp</p>
         # <p>Specifying a path outside of these directory trees is invalid.
         # <p> The paths /sdcard and /data will be made available and treated as
@@ -2190,7 +2192,7 @@ module Google
         attr_accessor :additional_apks
       
         # List of directories on the device to upload to GCS at the end of the test;
-        # they must be absolute paths under /sdcard or /data/local/tmp.
+        # they must be absolute paths under /sdcard, /storage or /data/local/tmp.
         # Path names are restricted to characters a-z A-Z 0-9 _ - . + and /
         # Note: The paths /sdcard and /data will be made available and treated as
         # implicit path substitutions. E.g. if /sdcard on a particular device does
@@ -2200,6 +2202,12 @@ module Google
         # @return [Array<String>]
         attr_accessor :directories_to_pull
       
+        # Whether to prevent all runtime permissions to be granted at app install
+        # Corresponds to the JSON property `dontAutograntPermissions`
+        # @return [Boolean]
+        attr_accessor :dont_autogrant_permissions
+        alias_method :dont_autogrant_permissions?, :dont_autogrant_permissions
+      
         # Environment variables to set for the test (only applicable for
         # instrumentation tests).
         # Corresponds to the JSON property `environmentVariables`
@@ -2236,6 +2244,7 @@ module Google
           @account = args[:account] if args.key?(:account)
           @additional_apks = args[:additional_apks] if args.key?(:additional_apks)
           @directories_to_pull = args[:directories_to_pull] if args.key?(:directories_to_pull)
+          @dont_autogrant_permissions = args[:dont_autogrant_permissions] if args.key?(:dont_autogrant_permissions)
           @environment_variables = args[:environment_variables] if args.key?(:environment_variables)
           @files_to_push = args[:files_to_push] if args.key?(:files_to_push)
           @network_profile = args[:network_profile] if args.key?(:network_profile)
@@ -2504,7 +2513,9 @@ module Google
       class UniformSharding
         include Google::Apis::Core::Hashable
       
-        # Required. Total number of shards. The number must be >= 1 and <= 50.
+        # Required. Total number of shards. When any physical devices are selected,
+        # the number must be >= 1 and <= 50. When no physical devices are selected,
+        # the number must be >= 1 and <= 250.
         # Corresponds to the JSON property `numShards`
         # @return [Fixnum]
         attr_accessor :num_shards

data/generated/google/apis/testing_v1/representations.rb

@@ -1044,6 +1044,7 @@ module Google
           collection :additional_apks, as: 'additionalApks', class: Google::Apis::TestingV1::Apk, decorator: Google::Apis::TestingV1::Apk::Representation
       
           collection :directories_to_pull, as: 'directoriesToPull'
+          property :dont_autogrant_permissions, as: 'dontAutograntPermissions'
           collection :environment_variables, as: 'environmentVariables', class: Google::Apis::TestingV1::EnvironmentVariable, decorator: Google::Apis::TestingV1::EnvironmentVariable::Representation
       
           collection :files_to_push, as: 'filesToPush', class: Google::Apis::TestingV1::DeviceFile, decorator: Google::Apis::TestingV1::DeviceFile::Representation

data/generated/google/apis/texttospeech_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/text-to-speech/
     module TexttospeechV1
       VERSION = 'V1'
-      REVISION = '20200219'
+      REVISION = '20200619'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/texttospeech_v1/classes.rb

@@ -123,7 +123,7 @@ module Google
         # The SSML document to be synthesized. The SSML document must be valid
         # and well-formed. Otherwise the RPC will fail and return
         # google.rpc.Code.INVALID_ARGUMENT. For more information, see
-        # [SSML](/speech/text-to-speech/docs/ssml).
+        # [SSML](https://cloud.google.com/text-to-speech/docs/ssml).
         # Corresponds to the JSON property `ssml`
         # @return [String]
         attr_accessor :ssml

data/generated/google/apis/texttospeech_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/text-to-speech/
     module TexttospeechV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200219'
+      REVISION = '20200619'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/texttospeech_v1beta1/classes.rb

@@ -123,7 +123,7 @@ module Google
         # The SSML document to be synthesized. The SSML document must be valid
         # and well-formed. Otherwise the RPC will fail and return
         # google.rpc.Code.INVALID_ARGUMENT. For more information, see
-        # [SSML](/speech/text-to-speech/docs/ssml).
+        # [SSML](https://cloud.google.com/text-to-speech/docs/ssml).
         # Corresponds to the JSON property `ssml`
         # @return [String]
         attr_accessor :ssml

data/generated/google/apis/{androidpublisher_v1.rb → vectortile_v1.rb}

@@ -12,20 +12,20 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-require 'google/apis/androidpublisher_v1/service.rb'
-require 'google/apis/androidpublisher_v1/classes.rb'
-require 'google/apis/androidpublisher_v1/representations.rb'
+require 'google/apis/vectortile_v1/service.rb'
+require 'google/apis/vectortile_v1/classes.rb'
+require 'google/apis/vectortile_v1/representations.rb'
 
 module Google
   module Apis
-    # Google Play Developer API
+    # Semantic Tile API
     #
-    # Accesses Android application developers' Google Play accounts.
+    # Serves vector tiles containing geospatial data.
     #
-    # @see https://developers.google.com/android-publisher
-    module AndroidpublisherV1
+    # @see https://developers.google.com/maps/contact-sales/
+    module VectortileV1
       VERSION = 'V1'
-      REVISION = '20200428'
+      REVISION = '20200622'
     end
   end
 end

data/generated/google/apis/vectortile_v1/classes.rb

@@ -0,0 +1,881 @@
+# Copyright 2015 Google Inc.
+#
+# 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
+#
+#      http://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 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module VectortileV1
+      
+      # Represents an area. Used to represent regions such as water, parks, etc.
+      class Area
+        include Google::Apis::Core::Hashable
+      
+        # True if the polygon is not entirely internal to the feature that it belongs
+        # to: that is, some of the edges are bordering another feature.
+        # Corresponds to the JSON property `hasExternalEdges`
+        # @return [Boolean]
+        attr_accessor :has_external_edges
+        alias_method :has_external_edges?, :has_external_edges
+      
+        # When has_external_edges is true, the polygon has some edges that border
+        # another feature. This field indicates the internal edges that do not border
+        # another feature. Each value is an index into the vertices array, and
+        # denotes the start vertex of the internal edge (the next vertex in the
+        # boundary loop is the end of the edge). If the selected vertex is the last
+        # vertex in the boundary loop, then the edge between that vertex and the
+        # starting vertex of the loop is internal.
+        # This field may be used for styling. For example, building parapets could be
+        # placed only on the external edges of a building polygon, or water could be
+        # lighter colored near the external edges of a body of water.
+        # If has_external_edges is false, all edges are internal and this field will
+        # be empty.
+        # Corresponds to the JSON property `internalEdges`
+        # @return [Array<Fixnum>]
+        attr_accessor :internal_edges
+      
+        # Identifies the boundary loops of the polygon. Only set for INDEXED_TRIANGLE
+        # polygons. Each value is an index into the vertices array indicating the
+        # beginning of a loop. For instance, values of [2, 5] would indicate
+        # loop_data contained 3 loops with indices 0-1, 2-4, and 5-end.
+        # This may be used in conjunction with the internal_edges field for styling
+        # polygon boundaries. Note that an edge may be on a polygon boundary but
+        # still internal to the feature. For example, a feature split across multiple
+        # tiles will have an internal polygon boundary edge along the edge of the
+        # tile.
+        # Corresponds to the JSON property `loopBreaks`
+        # @return [Array<Fixnum>]
+        attr_accessor :loop_breaks
+      
+        # When the polygon encoding is of type INDEXED_TRIANGLES, this contains the
+        # indices of the triangle vertices in the vertex_offsets field. There are 3
+        # vertex indices per triangle.
+        # Corresponds to the JSON property `triangleIndices`
+        # @return [Array<Fixnum>]
+        attr_accessor :triangle_indices
+      
+        # The polygon encoding type used for this area.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        # 2D vertex list used for lines and areas. Each entry represents an offset from
+        # the previous one in local tile coordinates. The first entry is offset from
+        # (0, 0).
+        # For example, the list of vertices [(1,1), (2, 2), (1, 2)] would be encoded
+        # in vertex offsets as [(1, 1), (1, 1), (-1, 0)].
+        # Corresponds to the JSON property `vertexOffsets`
+        # @return [Google::Apis::VectortileV1::Vertex2DList]
+        attr_accessor :vertex_offsets
+      
+        # The z-ordering of this area. Areas with a lower z-order should be rendered
+        # beneath areas with a higher z-order. This z-ordering does not imply
+        # anything about the altitude of the line relative to the ground, but it
+        # can be used to prevent z-fighting during rendering on the client. This
+        # z-ordering can only be used to compare areas, and cannot be compared with
+        # the z_order field in the Line message.
+        # The z-order may be negative or zero.
+        # Corresponds to the JSON property `zOrder`
+        # @return [Fixnum]
+        attr_accessor :z_order
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @has_external_edges = args[:has_external_edges] if args.key?(:has_external_edges)
+          @internal_edges = args[:internal_edges] if args.key?(:internal_edges)
+          @loop_breaks = args[:loop_breaks] if args.key?(:loop_breaks)
+          @triangle_indices = args[:triangle_indices] if args.key?(:triangle_indices)
+          @type = args[:type] if args.key?(:type)
+          @vertex_offsets = args[:vertex_offsets] if args.key?(:vertex_offsets)
+          @z_order = args[:z_order] if args.key?(:z_order)
+        end
+      end
+      
+      # Represents a height-extruded area: a 3D prism with a constant X-Y plane cross
+      # section. Used to represent extruded buildings. A single building may consist
+      # of several extruded areas.
+      # The min_z and max_z fields are scaled to the size of the tile. An extruded
+      # area with a max_z value of 4096 has the same height as the width of the tile
+      # that it is on.
+      class ExtrudedArea
+        include Google::Apis::Core::Hashable
+      
+        # Represents an area. Used to represent regions such as water, parks, etc.
+        # Corresponds to the JSON property `area`
+        # @return [Google::Apis::VectortileV1::Area]
+        attr_accessor :area
+      
+        # The z-value in local tile coordinates where the extruded area ends.
+        # Corresponds to the JSON property `maxZ`
+        # @return [Fixnum]
+        attr_accessor :max_z
+      
+        # The z-value in local tile coordinates where the extruded area begins. This
+        # is non-zero for extruded areas that begin off the ground. For example, a
+        # building with a skybridge may have an extruded area component with a
+        # non-zero min_z.
+        # Corresponds to the JSON property `minZ`
+        # @return [Fixnum]
+        attr_accessor :min_z
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @area = args[:area] if args.key?(:area)
+          @max_z = args[:max_z] if args.key?(:max_z)
+          @min_z = args[:min_z] if args.key?(:min_z)
+        end
+      end
+      
+      # A feature representing a single geographic entity.
+      class Feature
+        include Google::Apis::Core::Hashable
+      
+        # The localized name of this feature. Currently only returned for roads.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # Represents the geometry of a feature, that is, the shape that it has on the
+        # map. The local tile coordinate system has the origin at the north-west
+        # (upper-left) corner of the tile, and is scaled to 4096 units across each
+        # edge. The height (Z) axis has the same scale factor: an extruded area with a
+        # max_z value of 4096 has the same height as the width of the tile that it is
+        # on.
+        # There is no clipping boundary, so it is possible that some coordinates will
+        # lie outside the tile boundaries.
+        # Corresponds to the JSON property `geometry`
+        # @return [Google::Apis::VectortileV1::Geometry]
+        attr_accessor :geometry
+      
+        # Place ID of this feature, suitable for use in Places API details
+        # requests.
+        # Corresponds to the JSON property `placeId`
+        # @return [String]
+        attr_accessor :place_id
+      
+        # Relations to other features.
+        # Corresponds to the JSON property `relations`
+        # @return [Array<Google::Apis::VectortileV1::Relation>]
+        attr_accessor :relations
+      
+        # Extra metadata relating to segments.
+        # Corresponds to the JSON property `segmentInfo`
+        # @return [Google::Apis::VectortileV1::SegmentInfo]
+        attr_accessor :segment_info
+      
+        # The type of this feature.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @geometry = args[:geometry] if args.key?(:geometry)
+          @place_id = args[:place_id] if args.key?(:place_id)
+          @relations = args[:relations] if args.key?(:relations)
+          @segment_info = args[:segment_info] if args.key?(:segment_info)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
+      # A tile containing information about the map features located in the region it
+      # covers.
+      class FeatureTile
+        include Google::Apis::Core::Hashable
+      
+        # Global tile coordinates. Global tile coordinates reference a specific tile on
+        # the map at a specific zoom level.
+        # The origin of this coordinate system is always at the northwest corner of the
+        # map, with x values increasing from west to east and y values increasing from
+        # north to south. Tiles are indexed using x, y coordinates from that origin.
+        # The zoom level containing the entire world in a tile is 0, and it increases
+        # as you zoom in. Zoom level n + 1 will contain 4 times as many tiles as zoom
+        # level n.
+        # The zoom level controls the level of detail of the data that is returned. In
+        # particular, this affects the set of feature types returned, their density,
+        # and geometry simplification. The exact tile contents may change over time,
+        # but care will be taken to keep supporting the most important use cases. For
+        # example, zoom level 15 shows roads for orientation and planning in the local
+        # neighborhood and zoom level 17 shows buildings to give users on foot a sense
+        # of situational awareness.
+        # Corresponds to the JSON property `coordinates`
+        # @return [Google::Apis::VectortileV1::TileCoordinates]
+        attr_accessor :coordinates
+      
+        # Features present on this map tile.
+        # Corresponds to the JSON property `features`
+        # @return [Array<Google::Apis::VectortileV1::Feature>]
+        attr_accessor :features
+      
+        # Resource name of the tile. The tile resource name is prefixed by its
+        # collection ID `tiles/` followed by the resource ID, which encodes the
+        # tile's global x and y coordinates and zoom level as `@<x>,<y>,<zoom>z`. For
+        # example, `tiles/@1,2,3z`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Data providers for the data contained in this tile.
+        # Corresponds to the JSON property `providers`
+        # @return [Array<Google::Apis::VectortileV1::ProviderInfo>]
+        attr_accessor :providers
+      
+        # Tile response status code to support tile caching.
+        # Corresponds to the JSON property `status`
+        # @return [String]
+        attr_accessor :status
+      
+        # An opaque value, usually less than 30 characters, that contains version
+        # info about this tile and the data that was used to generate it.
+        # The client should store this value in its tile cache and pass it back to
+        # the API in the client_tile_version_id field of subsequent tile requests in
+        # order to enable the API to detect when the new tile would be the same as
+        # the one the client already has in its cache.
+        # Also see STATUS_OK_DATA_UNCHANGED.
+        # Corresponds to the JSON property `versionId`
+        # @return [String]
+        attr_accessor :version_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @coordinates = args[:coordinates] if args.key?(:coordinates)
+          @features = args[:features] if args.key?(:features)
+          @name = args[:name] if args.key?(:name)
+          @providers = args[:providers] if args.key?(:providers)
+          @status = args[:status] if args.key?(:status)
+          @version_id = args[:version_id] if args.key?(:version_id)
+        end
+      end
+      
+      # A packed representation of a 2D grid of uniformly spaced points containing
+      # elevation data. Each point within the grid represents the altitude in
+      # meters above average sea level at that location within the tile.
+      # Elevations provided are (generally) relative to the EGM96 geoid, however
+      # some areas will be relative to NAVD88. EGM96 and NAVD88 are off by no more
+      # than 2 meters.
+      # The grid is oriented north-west to south-east, as illustrated:
+      # rows[0].a[0]      rows[0].a[m]
+      # +-----------------+
+      # |                 |
+      # |        N        |
+      # |        ^        |
+      # |        |        |
+      # |   W <-----> E   |
+      # |        |        |
+      # |        v        |
+      # |        S        |
+      # |                 |
+      # +-----------------+
+      # rows[n].a[0]      rows[n].a[m]
+      # Rather than storing the altitudes directly, we store the diffs between them
+      # as integers at some requested level of precision to take advantage of
+      # integer packing. The actual altitude values a[] can be reconstructed using
+      # the scale and each row's first_altitude and altitude_diff fields.
+      class FirstDerivativeElevationGrid
+        include Google::Apis::Core::Hashable
+      
+        # A multiplier applied to the altitude fields below to extract the actual
+        # altitudes in meters from the elevation grid.
+        # Corresponds to the JSON property `altitudeMultiplier`
+        # @return [Float]
+        attr_accessor :altitude_multiplier
+      
+        # Rows of points containing altitude data making up the elevation grid.
+        # Each row is the same length. Rows are ordered from north to south. E.g:
+        # rows[0] is the north-most row, and rows[n] is the south-most row.
+        # Corresponds to the JSON property `rows`
+        # @return [Array<Google::Apis::VectortileV1::Row>]
+        attr_accessor :rows
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @altitude_multiplier = args[:altitude_multiplier] if args.key?(:altitude_multiplier)
+          @rows = args[:rows] if args.key?(:rows)
+        end
+      end
+      
+      # Represents the geometry of a feature, that is, the shape that it has on the
+      # map. The local tile coordinate system has the origin at the north-west
+      # (upper-left) corner of the tile, and is scaled to 4096 units across each
+      # edge. The height (Z) axis has the same scale factor: an extruded area with a
+      # max_z value of 4096 has the same height as the width of the tile that it is
+      # on.
+      # There is no clipping boundary, so it is possible that some coordinates will
+      # lie outside the tile boundaries.
+      class Geometry
+        include Google::Apis::Core::Hashable
+      
+        # The areas present in this geometry.
+        # Corresponds to the JSON property `areas`
+        # @return [Array<Google::Apis::VectortileV1::Area>]
+        attr_accessor :areas
+      
+        # The extruded areas present in this geometry.
+        # Corresponds to the JSON property `extrudedAreas`
+        # @return [Array<Google::Apis::VectortileV1::ExtrudedArea>]
+        attr_accessor :extruded_areas
+      
+        # The lines present in this geometry.
+        # Corresponds to the JSON property `lines`
+        # @return [Array<Google::Apis::VectortileV1::Line>]
+        attr_accessor :lines
+      
+        # The modeled volumes present in this geometry.
+        # Corresponds to the JSON property `modeledVolumes`
+        # @return [Array<Google::Apis::VectortileV1::ModeledVolume>]
+        attr_accessor :modeled_volumes
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @areas = args[:areas] if args.key?(:areas)
+          @extruded_areas = args[:extruded_areas] if args.key?(:extruded_areas)
+          @lines = args[:lines] if args.key?(:lines)
+          @modeled_volumes = args[:modeled_volumes] if args.key?(:modeled_volumes)
+        end
+      end
+      
+      # Represents a 2D polyline. Used to represent segments such as roads, train
+      # tracks, etc.
+      class Line
+        include Google::Apis::Core::Hashable
+      
+        # 2D vertex list used for lines and areas. Each entry represents an offset from
+        # the previous one in local tile coordinates. The first entry is offset from
+        # (0, 0).
+        # For example, the list of vertices [(1,1), (2, 2), (1, 2)] would be encoded
+        # in vertex offsets as [(1, 1), (1, 1), (-1, 0)].
+        # Corresponds to the JSON property `vertexOffsets`
+        # @return [Google::Apis::VectortileV1::Vertex2DList]
+        attr_accessor :vertex_offsets
+      
+        # The z-order of the line. Lines with a lower z-order should be rendered
+        # beneath lines with a higher z-order. This z-ordering does not imply
+        # anything about the altitude of the area relative to the ground, but it
+        # can be used to prevent z-fighting during rendering on the client. In
+        # general, larger and more important road features will have a higher z-order
+        # line associated with them. This z-ordering can only be used to compare
+        # lines, and cannot be compared with the z_order field in the Area message.
+        # The z-order may be negative or zero.
+        # Corresponds to the JSON property `zOrder`
+        # @return [Fixnum]
+        attr_accessor :z_order
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @vertex_offsets = args[:vertex_offsets] if args.key?(:vertex_offsets)
+          @z_order = args[:z_order] if args.key?(:z_order)
+        end
+      end
+      
+      # Represents a modeled volume in 3D space. Used to represent 3D buildings.
+      class ModeledVolume
+        include Google::Apis::Core::Hashable
+      
+        # The triangle strips present in this mesh.
+        # Corresponds to the JSON property `strips`
+        # @return [Array<Google::Apis::VectortileV1::TriangleStrip>]
+        attr_accessor :strips
+      
+        # 3D vertex list used for modeled volumes. Each entry represents an offset from
+        # the previous one in local tile coordinates. The first coordinate is offset
+        # from (0, 0, 0).
+        # Corresponds to the JSON property `vertexOffsets`
+        # @return [Google::Apis::VectortileV1::Vertex3DList]
+        attr_accessor :vertex_offsets
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @strips = args[:strips] if args.key?(:strips)
+          @vertex_offsets = args[:vertex_offsets] if args.key?(:vertex_offsets)
+        end
+      end
+      
+      # Information about the data providers that should be included in the
+      # attribution string shown by the client.
+      class ProviderInfo
+        include Google::Apis::Core::Hashable
+      
+        # Attribution string for this provider. This string is not localized.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @description = args[:description] if args.key?(:description)
+        end
+      end
+      
+      # Represents a relation to another feature in the tile. For example, a building
+      # might be occupied by a given POI. The related feature can be retrieved using
+      # the related feature index.
+      class Relation
+        include Google::Apis::Core::Hashable
+      
+        # Zero-based index to look up the related feature from the list of features
+        # in the tile.
+        # Corresponds to the JSON property `relatedFeatureIndex`
+        # @return [Fixnum]
+        attr_accessor :related_feature_index
+      
+        # Relation type between the origin feature to the related feature.
+        # Corresponds to the JSON property `relationType`
+        # @return [String]
+        attr_accessor :relation_type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @related_feature_index = args[:related_feature_index] if args.key?(:related_feature_index)
+          @relation_type = args[:relation_type] if args.key?(:relation_type)
+        end
+      end
+      
+      # Extra metadata relating to roads.
+      class RoadInfo
+        include Google::Apis::Core::Hashable
+      
+        # Road has signage discouraging or prohibiting use by the general public.
+        # E.g., roads with signs that say "Private", or "No trespassing."
+        # Corresponds to the JSON property `isPrivate`
+        # @return [Boolean]
+        attr_accessor :is_private
+        alias_method :is_private?, :is_private
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @is_private = args[:is_private] if args.key?(:is_private)
+        end
+      end
+      
+      # A row of altitude points in the elevation grid, ordered from west to
+      # east.
+      class Row
+        include Google::Apis::Core::Hashable
+      
+        # The difference between each successive pair of altitudes, from west to
+        # east. The first, westmost point, is just the altitude rather than a
+        # diff. The units are specified by the altitude_multiplier parameter
+        # above; the value in meters is given by altitude_multiplier *
+        # altitude_diffs[n]. The altitude row (in metres above sea level) can be
+        # reconstructed with: a[0] = altitude_diffs[0] * altitude_multiplier when
+        # n > 0, a[n] = a[n-1] + altitude_diffs[n-1] * altitude_multiplier.
+        # Corresponds to the JSON property `altitudeDiffs`
+        # @return [Array<Fixnum>]
+        attr_accessor :altitude_diffs
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @altitude_diffs = args[:altitude_diffs] if args.key?(:altitude_diffs)
+        end
+      end
+      
+      # A packed representation of a 2D grid of uniformly spaced points containing
+      # elevation data. Each point within the grid represents the altitude in
+      # meters above average sea level at that location within the tile.
+      # Elevations provided are (generally) relative to the EGM96 geoid, however
+      # some areas will be relative to NAVD88. EGM96 and NAVD88 are off by no more
+      # than 2 meters.
+      # The grid is oriented north-west to south-east, as illustrated:
+      # rows[0].a[0]      rows[0].a[m]
+      # +-----------------+
+      # |                 |
+      # |        N        |
+      # |        ^        |
+      # |        |        |
+      # |   W <-----> E   |
+      # |        |        |
+      # |        v        |
+      # |        S        |
+      # |                 |
+      # +-----------------+
+      # rows[n].a[0]      rows[n].a[m]
+      # Rather than storing the altitudes directly, we store the diffs of the diffs
+      # between them as integers at some requested level of precision to take
+      # advantage of integer packing.
+      # Note that the data is packed in such a way that is fast to decode in
+      # Unity and that further optimizes wire size.
+      class SecondDerivativeElevationGrid
+        include Google::Apis::Core::Hashable
+      
+        # A multiplier applied to the elements in the encoded data to extract the
+        # actual altitudes in meters.
+        # Corresponds to the JSON property `altitudeMultiplier`
+        # @return [Float]
+        attr_accessor :altitude_multiplier
+      
+        # The number of columns included in the encoded elevation data (i.e. the
+        # horizontal resolution of the grid).
+        # Corresponds to the JSON property `columnCount`
+        # @return [Fixnum]
+        attr_accessor :column_count
+      
+        # A stream of elements each representing a point on the tile running across
+        # each row from left to right, top to bottom.
+        # There will be precisely horizontal_resolution * vertical_resolution
+        # elements in the stream.
+        # The elements are not the heights, rather the second order derivative of
+        # the values one would expect in a stream of height data.
+        # Each element is a varint with the following encoding:
+        # ------------------------------------------------------------------------|
+        # | Head Nibble                                                           |
+        # ------------------------------------------------------------------------|
+        # | Bit 0     | Bit 1        | Bits 2-3                                   |
+        # | Terminator| Sign (1=neg) | Least significant 2 bits of absolute error |
+        # ------------------------------------------------------------------------|
+        # | Tail Nibble #1                                                        |
+        # ------------------------------------------------------------------------|
+        # | Bit 0     | Bit 1-3                                                   |
+        # | Terminator| Least significant 3 bits of absolute error                |
+        # ------------------------------------------------------------------------|
+        # | ...
+        # | Tail Nibble #n                                                        |
+        # ------------------------------------------------------------------------|
+        # | Bit 0     | Bit 1-3                                                   |
+        # | Terminator| Least significant 3 bits of absolute error                |
+        # ------------------------------------------------------------------------|
+        # Corresponds to the JSON property `encodedData`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :encoded_data
+      
+        # The number of rows included in the encoded elevation data (i.e. the
+        # vertical resolution of the grid).
+        # Corresponds to the JSON property `rowCount`
+        # @return [Fixnum]
+        attr_accessor :row_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @altitude_multiplier = args[:altitude_multiplier] if args.key?(:altitude_multiplier)
+          @column_count = args[:column_count] if args.key?(:column_count)
+          @encoded_data = args[:encoded_data] if args.key?(:encoded_data)
+          @row_count = args[:row_count] if args.key?(:row_count)
+        end
+      end
+      
+      # Extra metadata relating to segments.
+      class SegmentInfo
+        include Google::Apis::Core::Hashable
+      
+        # Extra metadata relating to roads.
+        # Corresponds to the JSON property `roadInfo`
+        # @return [Google::Apis::VectortileV1::RoadInfo]
+        attr_accessor :road_info
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @road_info = args[:road_info] if args.key?(:road_info)
+        end
+      end
+      
+      # A tile containing information about the terrain located in the region it
+      # covers.
+      class TerrainTile
+        include Google::Apis::Core::Hashable
+      
+        # Global tile coordinates. Global tile coordinates reference a specific tile on
+        # the map at a specific zoom level.
+        # The origin of this coordinate system is always at the northwest corner of the
+        # map, with x values increasing from west to east and y values increasing from
+        # north to south. Tiles are indexed using x, y coordinates from that origin.
+        # The zoom level containing the entire world in a tile is 0, and it increases
+        # as you zoom in. Zoom level n + 1 will contain 4 times as many tiles as zoom
+        # level n.
+        # The zoom level controls the level of detail of the data that is returned. In
+        # particular, this affects the set of feature types returned, their density,
+        # and geometry simplification. The exact tile contents may change over time,
+        # but care will be taken to keep supporting the most important use cases. For
+        # example, zoom level 15 shows roads for orientation and planning in the local
+        # neighborhood and zoom level 17 shows buildings to give users on foot a sense
+        # of situational awareness.
+        # Corresponds to the JSON property `coordinates`
+        # @return [Google::Apis::VectortileV1::TileCoordinates]
+        attr_accessor :coordinates
+      
+        # A packed representation of a 2D grid of uniformly spaced points containing
+        # elevation data. Each point within the grid represents the altitude in
+        # meters above average sea level at that location within the tile.
+        # Elevations provided are (generally) relative to the EGM96 geoid, however
+        # some areas will be relative to NAVD88. EGM96 and NAVD88 are off by no more
+        # than 2 meters.
+        # The grid is oriented north-west to south-east, as illustrated:
+        # rows[0].a[0]      rows[0].a[m]
+        # +-----------------+
+        # |                 |
+        # |        N        |
+        # |        ^        |
+        # |        |        |
+        # |   W <-----> E   |
+        # |        |        |
+        # |        v        |
+        # |        S        |
+        # |                 |
+        # +-----------------+
+        # rows[n].a[0]      rows[n].a[m]
+        # Rather than storing the altitudes directly, we store the diffs between them
+        # as integers at some requested level of precision to take advantage of
+        # integer packing. The actual altitude values a[] can be reconstructed using
+        # the scale and each row's first_altitude and altitude_diff fields.
+        # Corresponds to the JSON property `firstDerivative`
+        # @return [Google::Apis::VectortileV1::FirstDerivativeElevationGrid]
+        attr_accessor :first_derivative
+      
+        # Resource name of the tile. The tile resource name is prefixed by its
+        # collection ID `terrain/` followed by the resource ID, which encodes the
+        # tile's global x and y coordinates and zoom level as `@<x>,<y>,<zoom>z`.
+        # For example, `terrain/@1,2,3z`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # A packed representation of a 2D grid of uniformly spaced points containing
+        # elevation data. Each point within the grid represents the altitude in
+        # meters above average sea level at that location within the tile.
+        # Elevations provided are (generally) relative to the EGM96 geoid, however
+        # some areas will be relative to NAVD88. EGM96 and NAVD88 are off by no more
+        # than 2 meters.
+        # The grid is oriented north-west to south-east, as illustrated:
+        # rows[0].a[0]      rows[0].a[m]
+        # +-----------------+
+        # |                 |
+        # |        N        |
+        # |        ^        |
+        # |        |        |
+        # |   W <-----> E   |
+        # |        |        |
+        # |        v        |
+        # |        S        |
+        # |                 |
+        # +-----------------+
+        # rows[n].a[0]      rows[n].a[m]
+        # Rather than storing the altitudes directly, we store the diffs of the diffs
+        # between them as integers at some requested level of precision to take
+        # advantage of integer packing.
+        # Note that the data is packed in such a way that is fast to decode in
+        # Unity and that further optimizes wire size.
+        # Corresponds to the JSON property `secondDerivative`
+        # @return [Google::Apis::VectortileV1::SecondDerivativeElevationGrid]
+        attr_accessor :second_derivative
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @coordinates = args[:coordinates] if args.key?(:coordinates)
+          @first_derivative = args[:first_derivative] if args.key?(:first_derivative)
+          @name = args[:name] if args.key?(:name)
+          @second_derivative = args[:second_derivative] if args.key?(:second_derivative)
+        end
+      end
+      
+      # Global tile coordinates. Global tile coordinates reference a specific tile on
+      # the map at a specific zoom level.
+      # The origin of this coordinate system is always at the northwest corner of the
+      # map, with x values increasing from west to east and y values increasing from
+      # north to south. Tiles are indexed using x, y coordinates from that origin.
+      # The zoom level containing the entire world in a tile is 0, and it increases
+      # as you zoom in. Zoom level n + 1 will contain 4 times as many tiles as zoom
+      # level n.
+      # The zoom level controls the level of detail of the data that is returned. In
+      # particular, this affects the set of feature types returned, their density,
+      # and geometry simplification. The exact tile contents may change over time,
+      # but care will be taken to keep supporting the most important use cases. For
+      # example, zoom level 15 shows roads for orientation and planning in the local
+      # neighborhood and zoom level 17 shows buildings to give users on foot a sense
+      # of situational awareness.
+      class TileCoordinates
+        include Google::Apis::Core::Hashable
+      
+        # Required. The x coordinate.
+        # Corresponds to the JSON property `x`
+        # @return [Fixnum]
+        attr_accessor :x
+      
+        # Required. The y coordinate.
+        # Corresponds to the JSON property `y`
+        # @return [Fixnum]
+        attr_accessor :y
+      
+        # Required. The Google Maps API zoom level.
+        # Corresponds to the JSON property `zoom`
+        # @return [Fixnum]
+        attr_accessor :zoom
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @x = args[:x] if args.key?(:x)
+          @y = args[:y] if args.key?(:y)
+          @zoom = args[:zoom] if args.key?(:zoom)
+        end
+      end
+      
+      # Represents a strip of triangles. Each triangle uses the last edge of the
+      # previous one. The following diagram shows an example of a triangle strip,
+      # with each vertex labeled with its index in the vertex_index array.
+      # (1)-----(3)
+      # / \     / \
+      # /   \   /   \
+      # /     \ /     \
+      # (0)-----(2)-----(4)
+      # Vertices may be in either clockwise or counter-clockwise order.
+      class TriangleStrip
+        include Google::Apis::Core::Hashable
+      
+        # Index into the vertex_offset array representing the next vertex in the
+        # triangle strip.
+        # Corresponds to the JSON property `vertexIndices`
+        # @return [Array<Fixnum>]
+        attr_accessor :vertex_indices
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @vertex_indices = args[:vertex_indices] if args.key?(:vertex_indices)
+        end
+      end
+      
+      # 2D vertex list used for lines and areas. Each entry represents an offset from
+      # the previous one in local tile coordinates. The first entry is offset from
+      # (0, 0).
+      # For example, the list of vertices [(1,1), (2, 2), (1, 2)] would be encoded
+      # in vertex offsets as [(1, 1), (1, 1), (-1, 0)].
+      class Vertex2DList
+        include Google::Apis::Core::Hashable
+      
+        # List of x-offsets in local tile coordinates.
+        # Corresponds to the JSON property `xOffsets`
+        # @return [Array<Fixnum>]
+        attr_accessor :x_offsets
+      
+        # List of y-offsets in local tile coordinates.
+        # Corresponds to the JSON property `yOffsets`
+        # @return [Array<Fixnum>]
+        attr_accessor :y_offsets
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @x_offsets = args[:x_offsets] if args.key?(:x_offsets)
+          @y_offsets = args[:y_offsets] if args.key?(:y_offsets)
+        end
+      end
+      
+      # 3D vertex list used for modeled volumes. Each entry represents an offset from
+      # the previous one in local tile coordinates. The first coordinate is offset
+      # from (0, 0, 0).
+      class Vertex3DList
+        include Google::Apis::Core::Hashable
+      
+        # List of x-offsets in local tile coordinates.
+        # Corresponds to the JSON property `xOffsets`
+        # @return [Array<Fixnum>]
+        attr_accessor :x_offsets
+      
+        # List of y-offsets in local tile coordinates.
+        # Corresponds to the JSON property `yOffsets`
+        # @return [Array<Fixnum>]
+        attr_accessor :y_offsets
+      
+        # List of z-offsets in local tile coordinates.
+        # Corresponds to the JSON property `zOffsets`
+        # @return [Array<Fixnum>]
+        attr_accessor :z_offsets
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @x_offsets = args[:x_offsets] if args.key?(:x_offsets)
+          @y_offsets = args[:y_offsets] if args.key?(:y_offsets)
+          @z_offsets = args[:z_offsets] if args.key?(:z_offsets)
+        end
+      end
+    end
+  end
+end