feat: Automated regeneration of places v1 client (googleapis#22198)

Auto-created at 2025-03-23 10:23:20 +0000 using the toys pull request generator.

Author: yoshi-code-bot

generated/google-apis-places_v1/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-places_v1
 
+### v0.33.0 (2025-03-23)
+
+* Regenerated from discovery document revision 20250318
+
 ### v0.32.0 (2025-03-16)
 
 * Regenerated from discovery document revision 20250312

generated/google-apis-places_v1/lib/google/apis/places_v1/classes.rb

@@ -1372,16 +1372,16 @@ class GoogleMapsPlacesV1Place
         # @return [Google::Apis::PlacesV1::GoogleMapsPlacesV1PlacePlusCode]
         attr_accessor :plus_code
 
-        # Represents a postal address. For example for postal delivery or payments
-        # addresses. Given a postal address, a postal service can deliver items to a
-        # premise, P.O. Box or similar. It is not intended to model geographical
-        # locations (roads, towns, mountains). In typical usage an address would be
+        # Represents a postal address (for example, for postal delivery or payments
+        # addresses). Given a postal address, a postal service can deliver items to a
+        # premise, P.O. box or similar. It is not intended to model geographical
+        # locations (roads, towns, mountains). In typical usage, an address would be
         # created by user input or from importing existing data, depending on the type
-        # of process. Advice on address input / editing: - Use an internationalization-
-        # ready address widget such as https://github.com/google/libaddressinput) -
+        # of process. Advice on address input or editing: - Use an internationalization-
+        # ready address widget such as https://github.com/google/libaddressinput. -
         # Users should not be presented with UI elements for input or editing of fields
         # outside countries where that field is used. For more guidance on how to use
-        # this schema, see: https://support.google.com/business/answer/6397478
+        # this schema, see: https://support.google.com/business/answer/6397478.
         # Corresponds to the JSON property `postalAddress`
         # @return [Google::Apis::PlacesV1::GoogleTypePostalAddress]
         attr_accessor :postal_address
@@ -1524,7 +1524,7 @@ class GoogleMapsPlacesV1Place
         # @return [String]
         attr_accessor :short_formatted_address
 
-        # A list of sub destinations related to the place.
+        # A list of sub-destinations related to the place.
         # Corresponds to the JSON property `subDestinations`
         # @return [Array<Google::Apis::PlacesV1::GoogleMapsPlacesV1PlaceSubDestination>]
         attr_accessor :sub_destinations
@@ -2236,21 +2236,21 @@ def update!(**args)
       end
 
       # Sub-destinations are specific places associated with a main place. These
-      # provide more specific destinations for users who are searching inside a large
+      # provide more specific destinations for users who are searching within a large
       # or complex place, like an airport, national park, university, or stadium. For
       # example, sub-destinations at an airport might include associated terminals and
       # parking lots. Sub-destinations return the place ID and place resource name,
-      # which can be used in subsequent Place Details (new) requests to fetch richer
+      # which can be used in subsequent Place Details (New) requests to fetch richer
       # details, including the sub-destination's display name and location.
       class GoogleMapsPlacesV1PlaceSubDestination
         include Google::Apis::Core::Hashable
 
-        # The place id of the sub destination.
+        # The place id of the sub-destination.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
 
-        # The resource name of the sub destination.
+        # The resource name of the sub-destination.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -3257,46 +3257,46 @@ def update!(**args)
         end
       end
 
-      # Represents a postal address. For example for postal delivery or payments
-      # addresses. Given a postal address, a postal service can deliver items to a
-      # premise, P.O. Box or similar. It is not intended to model geographical
-      # locations (roads, towns, mountains). In typical usage an address would be
+      # Represents a postal address (for example, for postal delivery or payments
+      # addresses). Given a postal address, a postal service can deliver items to a
+      # premise, P.O. box or similar. It is not intended to model geographical
+      # locations (roads, towns, mountains). In typical usage, an address would be
       # created by user input or from importing existing data, depending on the type
-      # of process. Advice on address input / editing: - Use an internationalization-
-      # ready address widget such as https://github.com/google/libaddressinput) -
+      # of process. Advice on address input or editing: - Use an internationalization-
+      # ready address widget such as https://github.com/google/libaddressinput. -
       # Users should not be presented with UI elements for input or editing of fields
       # outside countries where that field is used. For more guidance on how to use
-      # this schema, see: https://support.google.com/business/answer/6397478
+      # this schema, see: https://support.google.com/business/answer/6397478.
       class GoogleTypePostalAddress
         include Google::Apis::Core::Hashable
 
         # Unstructured address lines describing the lower levels of an address. Because
-        # values in address_lines do not have type information and may sometimes contain
-        # multiple values in a single field (For example "Austin, TX"), it is important
-        # that the line order is clear. The order of address lines should be "envelope
-        # order" for the country/region of the address. In places where this can vary (
-        # For example Japan), address_language is used to make it explicit (For example "
-        # ja" for large-to-small ordering and "ja-Latn" or "en" for small-to-large).
-        # This way, the most specific line of an address can be selected based on the
-        # language. The minimum permitted structural representation of an address
-        # consists of a region_code with all remaining information placed in the
-        # address_lines. It would be possible to format such an address very
+        # values in `address_lines` do not have type information and may sometimes
+        # contain multiple values in a single field (for example, "Austin, TX"), it is
+        # important that the line order is clear. The order of address lines should be "
+        # envelope order" for the country or region of the address. In places where this
+        # can vary (for example, Japan), `address_language` is used to make it explicit (
+        # for example, "ja" for large-to-small ordering and "ja-Latn" or "en" for small-
+        # to-large). In this way, the most specific line of an address can be selected
+        # based on the language. The minimum permitted structural representation of an
+        # address consists of a `region_code` with all remaining information placed in
+        # the `address_lines`. It would be possible to format such an address very
         # approximately without geocoding, but no semantic reasoning could be made about
         # any of the address components until it was at least partially resolved.
-        # Creating an address only containing a region_code and address_lines, and then
-        # geocoding is the recommended way to handle completely unstructured addresses (
-        # as opposed to guessing which parts of the address should be localities or
-        # administrative areas).
+        # Creating an address only containing a `region_code` and `address_lines` and
+        # then geocoding is the recommended way to handle completely unstructured
+        # addresses (as opposed to guessing which parts of the address should be
+        # localities or administrative areas).
         # Corresponds to the JSON property `addressLines`
         # @return [Array<String>]
         attr_accessor :address_lines
 
         # Optional. Highest administrative subdivision which is used for postal
         # addresses of a country or region. For example, this can be a state, a province,
-        # an oblast, or a prefecture. Specifically, for Spain this is the province and
-        # not the autonomous community (For example "Barcelona" and not "Catalonia").
-        # Many countries don't use an administrative area in postal addresses. For
-        # example in Switzerland this should be left unpopulated.
+        # an oblast, or a prefecture. For Spain, this is the province and not the
+        # autonomous community (for example, "Barcelona" and not "Catalonia"). Many
+        # countries don't use an administrative area in postal addresses. For example,
+        # in Switzerland, this should be left unpopulated.
         # Corresponds to the JSON property `administrativeArea`
         # @return [String]
         attr_accessor :administrative_area
@@ -3313,10 +3313,10 @@ class GoogleTypePostalAddress
         # @return [String]
         attr_accessor :language_code
 
-        # Optional. Generally refers to the city/town portion of the address. Examples:
-        # US city, IT comune, UK post town. In regions of the world where localities are
-        # not well defined or do not fit into this structure well, leave locality empty
-        # and use address_lines.
+        # Optional. Generally refers to the city or town portion of the address.
+        # Examples: US city, IT comune, UK post town. In regions of the world where
+        # localities are not well defined or do not fit into this structure well, leave `
+        # locality` empty and use `address_lines`.
         # Corresponds to the JSON property `locality`
         # @return [String]
         attr_accessor :locality
@@ -3328,8 +3328,8 @@ class GoogleTypePostalAddress
 
         # Optional. Postal code of the address. Not all countries use or require postal
         # codes to be present, but where they are used, they may trigger additional
-        # validation with other parts of the address (For example state/zip validation
-        # in the U.S.A.).
+        # validation with other parts of the address (for example, state or zip code
+        # validation in the United States).
         # Corresponds to the JSON property `postalCode`
         # @return [String]
         attr_accessor :postal_code
@@ -3358,15 +3358,15 @@ class GoogleTypePostalAddress
 
         # Optional. Additional, country-specific, sorting code. This is not used in most
         # regions. Where it is used, the value is either a string like "CEDEX",
-        # optionally followed by a number (For example "CEDEX 7"), or just a number
+        # optionally followed by a number (for example, "CEDEX 7"), or just a number
         # alone, representing the "sector code" (Jamaica), "delivery area indicator" (
-        # Malawi) or "post office indicator" (For example Côte d'Ivoire).
+        # Malawi) or "post office indicator" (Côte d'Ivoire).
         # Corresponds to the JSON property `sortingCode`
         # @return [String]
         attr_accessor :sorting_code
 
-        # Optional. Sublocality of the address. For example, this can be neighborhoods,
-        # boroughs, districts.
+        # Optional. Sublocality of the address. For example, this can be a neighborhood,
+        # borough, or district.
         # Corresponds to the JSON property `sublocality`
         # @return [String]
         attr_accessor :sublocality

generated/google-apis-places_v1/lib/google/apis/places_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module PlacesV1
       # Version of the google-apis-places_v1 gem
-      GEM_VERSION = "0.32.0"
+      GEM_VERSION = "0.33.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.16.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20250312"
+      REVISION = "20250318"
     end
   end
 end