google-apis-places_v1 0.31.0 → 0.33.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bce7fffbeb8d079d17ada9a22f375637e07480c1ea61d51eaf23d3cf9027465b
-  data.tar.gz: 8f9f5a6853a51b2e39d05a1da485fd5f3dcfa909292ccecf4459d1abb44123dc
+  metadata.gz: 451bad0d55e9478b89aeb6cfc15ede4515b4ac73fc6833a795fcc444b659ae57
+  data.tar.gz: 992c2e06bf13930fdfe22e83b43d465ff3ef9523c18162b3318bfae5516f8943
 SHA512:
-  metadata.gz: 26cd7ed76473f0c5026b9ff6a5b1dcacde6f3d7a70eba99d86fdb828057471774e381370c25a94727c4c28285536c1e49f015bcd299c2554e7ce191cf5aba51e
-  data.tar.gz: b0fc6cbff0c2ee4a4754d38348bf90d8959b2681aac2b1ce9d85d20f0502be13febeb74b5cf21847b7dfc0c2c6058b697df74487edb32541848c3ab5943b1224
+  metadata.gz: e71048f4bdba05926fcf54ffd79b8216aeedd2f177fce95fc78298e06cf027bec8929f299d9ddbfa7a7ad7aea1281d6b5dc6b631933ad9d21b2aaf07ef5be85e
+  data.tar.gz: 3cb991c5ae08d51a0ef2b0e578eebfddee15ad317dbea9230a4f0c9207dbc6e6547239c77451b2b1cdb42b99e3f91aaf01031bafc00a4e9b557f2c082b51afe4

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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
+
 ### v0.31.0 (2025-03-09)
 
 * Regenerated from discovery document revision 20250302

data/lib/google/apis/places_v1/classes.rb

@@ -1372,6 +1372,20 @@ module Google
         # @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
+        # created by user input or from importing existing data, depending on the type
+        # 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.
+        # Corresponds to the JSON property `postalAddress`
+        # @return [Google::Apis::PlacesV1::GoogleTypePostalAddress]
+        attr_accessor :postal_address
+      
         # Price level of the place.
         # Corresponds to the JSON property `priceLevel`
         # @return [String]
@@ -1510,7 +1524,7 @@ module Google
         # @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
@@ -1618,6 +1632,7 @@ module Google
           @payment_options = args[:payment_options] if args.key?(:payment_options)
           @photos = args[:photos] if args.key?(:photos)
           @plus_code = args[:plus_code] if args.key?(:plus_code)
+          @postal_address = args[:postal_address] if args.key?(:postal_address)
           @price_level = args[:price_level] if args.key?(:price_level)
           @price_range = args[:price_range] if args.key?(:price_range)
           @primary_type = args[:primary_type] if args.key?(:primary_type)
@@ -2220,17 +2235,22 @@ module Google
         end
       end
       
-      # Place resource name and id of sub destinations that relate to the place. For
-      # example, different terminals are different destinations of an airport.
+      # Sub-destinations are specific places associated with a main place. These
+      # 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
+      # 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
@@ -3237,6 +3257,140 @@ module Google
         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
+      # created by user input or from importing existing data, depending on the type
+      # 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.
+      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 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).
+        # 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. 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
+      
+        # Optional. BCP-47 language code of the contents of this address (if known).
+        # This is often the UI language of the input form or is expected to match one of
+        # the languages used in the address' country/region, or their transliterated
+        # equivalents. This can affect formatting in certain countries, but is not
+        # critical to the correctness of the data and will never affect any validation
+        # or other non-formatting related operations. If this value is not known, it
+        # should be omitted (rather than specifying a possibly incorrect default).
+        # Examples: "zh-Hant", "ja", "ja-Latn", "en".
+        # Corresponds to the JSON property `languageCode`
+        # @return [String]
+        attr_accessor :language_code
+      
+        # 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
+      
+        # Optional. The name of the organization at the address.
+        # Corresponds to the JSON property `organization`
+        # @return [String]
+        attr_accessor :organization
+      
+        # 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 or zip code
+        # validation in the United States).
+        # Corresponds to the JSON property `postalCode`
+        # @return [String]
+        attr_accessor :postal_code
+      
+        # Optional. The recipient at the address. This field may, under certain
+        # circumstances, contain multiline information. For example, it might contain "
+        # care of" information.
+        # Corresponds to the JSON property `recipients`
+        # @return [Array<String>]
+        attr_accessor :recipients
+      
+        # Required. CLDR region code of the country/region of the address. This is never
+        # inferred and it is up to the user to ensure the value is correct. See https://
+        # cldr.unicode.org/ and https://www.unicode.org/cldr/charts/30/supplemental/
+        # territory_information.html for details. Example: "CH" for Switzerland.
+        # Corresponds to the JSON property `regionCode`
+        # @return [String]
+        attr_accessor :region_code
+      
+        # The schema revision of the `PostalAddress`. This must be set to 0, which is
+        # the latest revision. All new revisions **must** be backward compatible with
+        # old revisions.
+        # Corresponds to the JSON property `revision`
+        # @return [Fixnum]
+        attr_accessor :revision
+      
+        # 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
+        # alone, representing the "sector code" (Jamaica), "delivery area indicator" (
+        # 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 a neighborhood,
+        # borough, or district.
+        # Corresponds to the JSON property `sublocality`
+        # @return [String]
+        attr_accessor :sublocality
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @address_lines = args[:address_lines] if args.key?(:address_lines)
+          @administrative_area = args[:administrative_area] if args.key?(:administrative_area)
+          @language_code = args[:language_code] if args.key?(:language_code)
+          @locality = args[:locality] if args.key?(:locality)
+          @organization = args[:organization] if args.key?(:organization)
+          @postal_code = args[:postal_code] if args.key?(:postal_code)
+          @recipients = args[:recipients] if args.key?(:recipients)
+          @region_code = args[:region_code] if args.key?(:region_code)
+          @revision = args[:revision] if args.key?(:revision)
+          @sorting_code = args[:sorting_code] if args.key?(:sorting_code)
+          @sublocality = args[:sublocality] if args.key?(:sublocality)
+        end
+      end
+      
       # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/
       # time-zones).
       class GoogleTypeTimeZone

data/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.31.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 = "20250302"
+      REVISION = "20250318"
     end
   end
 end

data/lib/google/apis/places_v1/representations.rb

@@ -418,6 +418,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleTypePostalAddress
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleTypeTimeZone
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -787,6 +793,8 @@ module Google
       
           property :plus_code, as: 'plusCode', class: Google::Apis::PlacesV1::GoogleMapsPlacesV1PlacePlusCode, decorator: Google::Apis::PlacesV1::GoogleMapsPlacesV1PlacePlusCode::Representation
       
+          property :postal_address, as: 'postalAddress', class: Google::Apis::PlacesV1::GoogleTypePostalAddress, decorator: Google::Apis::PlacesV1::GoogleTypePostalAddress::Representation
+      
           property :price_level, as: 'priceLevel'
           property :price_range, as: 'priceRange', class: Google::Apis::PlacesV1::GoogleMapsPlacesV1PriceRange, decorator: Google::Apis::PlacesV1::GoogleMapsPlacesV1PriceRange::Representation
       
@@ -1212,6 +1220,23 @@ module Google
         end
       end
       
+      class GoogleTypePostalAddress
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :address_lines, as: 'addressLines'
+          property :administrative_area, as: 'administrativeArea'
+          property :language_code, as: 'languageCode'
+          property :locality, as: 'locality'
+          property :organization, as: 'organization'
+          property :postal_code, as: 'postalCode'
+          collection :recipients, as: 'recipients'
+          property :region_code, as: 'regionCode'
+          property :revision, as: 'revision'
+          property :sorting_code, as: 'sortingCode'
+          property :sublocality, as: 'sublocality'
+        end
+      end
+      
       class GoogleTypeTimeZone
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-places_v1
 version: !ruby/object:Gem::Version
-  version: 0.31.0
+  version: 0.33.0
 platform: ruby
 authors:
 - Google LLC
 bindir: bin
 cert_chain: []
-date: 2025-03-09 00:00:00.000000000 Z
+date: 2025-03-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -57,7 +57,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-places_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-places_v1/v0.31.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-places_v1/v0.33.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-places_v1
 rdoc_options: []
 require_paths: