google-apis-places_v1 0.16.0 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dae9cce623309bf3076dc609e860e72030c225a1d96bec1b747069fdc32ea62a
-  data.tar.gz: e3a4ed99ad9b519684833d4dd223d2f60dc65da71fae18fbddd465b316884d81
+  metadata.gz: a288cbb711d192ba6d129fb822801122d897fd1ec9486cfdbd17cc49f8da7bcf
+  data.tar.gz: e7f73fbb50c65e1f18373fb9330b9734d4c966f4ec9b3ebdd807285f009b62a7
 SHA512:
-  metadata.gz: 3dc0b9239c8abda369c973b95d234286a239a46bbf2c11b178842a0e8af44f5378339817aac5b8b0fb24c2f498afdb0e7229bb239ec17ff2cbcd53e751e4b2d0
-  data.tar.gz: e24b72ca7a1529dafa910adc9a83120ec913ffa2cb406f67085fcb1a39ad1e84793e382201c29e7cf86fe19baf7e904587eb9d27562cc10f62318e8c9fc7fa42
+  metadata.gz: 66bae08b1bae6b581f24fc7b03a8d66b870067f25131677df0737f343219a3b533b7ed3e4ffb2e1bfc939382f5395c9db77280c739c1e9659cb9dcad56ab46ec
+  data.tar.gz: 5e1640ee18fe4406f2af652ee9ae2f6800a643003fa9c2dd64a461f833acec66903198220f8462d9be5fba94d67cb8dcd3efdd6b8367ad0231f7e7fc2b6d4d35

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Release history for google-apis-places_v1
 
+### v0.18.0 (2024-02-24)
+
+* Regenerated from discovery document revision 20240219
+* Regenerated using generator version 0.14.0
+
+### v0.17.0 (2024-01-23)
+
+* Regenerated from discovery document revision 20240114
+* Regenerated using generator version 0.13.0
+
 ### v0.16.0 (2023-12-10)
 
 * Regenerated from discovery document revision 20231205

data/OVERVIEW.md

@@ -83,9 +83,9 @@ The [product documentation](https://mapsplatform.google.com/maps-products/#place
 
 ## Supported Ruby versions
 
-This library is supported on Ruby 2.5+.
+This library is supported on Ruby 2.7+.
 
-Google provides official support for Ruby versions that are actively supported by Ruby Core -- that is, Ruby versions that are either in normal maintenance or in security maintenance, and not end of life. Currently, this means Ruby 2.5 and later. Older versions of Ruby _may_ still work, but are unsupported and not recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby support schedule.
+Google provides official support for Ruby versions that are actively supported by Ruby Core -- that is, Ruby versions that are either in normal maintenance or in security maintenance, and not end of life. Older versions of Ruby _may_ still work, but are unsupported and not recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby support schedule.
 
 ## License
 

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

@@ -99,6 +99,424 @@ module Google
         end
       end
       
+      # Request proto for AutocompletePlaces.
+      class GoogleMapsPlacesV1AutocompletePlacesRequest
+        include Google::Apis::Core::Hashable
+      
+        # Optional. If true, the response will include both Place and query predictions.
+        # Otherwise the response will only return Place predictions.
+        # Corresponds to the JSON property `includeQueryPredictions`
+        # @return [Boolean]
+        attr_accessor :include_query_predictions
+        alias_method :include_query_predictions?, :include_query_predictions
+      
+        # Optional. Included primary Place type (for example, "restaurant" or "
+        # gas_station") from https://developers.google.com/maps/documentation/places/web-
+        # service/place-types. A Place is only returned if its primary type is included
+        # in this list. Up to 5 values can be specified. If no types are specified, all
+        # Place types are returned.
+        # Corresponds to the JSON property `includedPrimaryTypes`
+        # @return [Array<String>]
+        attr_accessor :included_primary_types
+      
+        # Optional. Only include results in the specified regions, specified as up to 15
+        # CLDR two-character region codes. An empty set will not restrict the results.
+        # If both `location_restriction` and `included_region_codes` are set, the
+        # results will be located in the area of intersection.
+        # Corresponds to the JSON property `includedRegionCodes`
+        # @return [Array<String>]
+        attr_accessor :included_region_codes
+      
+        # Required. The text string on which to search.
+        # Corresponds to the JSON property `input`
+        # @return [String]
+        attr_accessor :input
+      
+        # Optional. A zero-based Unicode character offset of `input` indicating the
+        # cursor position in `input`. The cursor position may influence what predictions
+        # are returned. If empty, defaults to the length of `input`.
+        # Corresponds to the JSON property `inputOffset`
+        # @return [Fixnum]
+        attr_accessor :input_offset
+      
+        # Optional. The language in which to return results. Defaults to en-US. The
+        # results may be in mixed languages if the language used in `input` is different
+        # from `language_code` or if the returned Place does not have a translation from
+        # the local language to `language_code`.
+        # Corresponds to the JSON property `languageCode`
+        # @return [String]
+        attr_accessor :language_code
+      
+        # The region to search. The results may be biased around the specified region.
+        # Corresponds to the JSON property `locationBias`
+        # @return [Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesRequestLocationBias]
+        attr_accessor :location_bias
+      
+        # The region to search. The results will be restricted to the specified region.
+        # Corresponds to the JSON property `locationRestriction`
+        # @return [Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesRequestLocationRestriction]
+        attr_accessor :location_restriction
+      
+        # An object that represents a latitude/longitude pair. This is expressed as a
+        # pair of doubles to represent degrees latitude and degrees longitude. Unless
+        # specified otherwise, this object must conform to the WGS84 standard. Values
+        # must be within normalized ranges.
+        # Corresponds to the JSON property `origin`
+        # @return [Google::Apis::PlacesV1::GoogleTypeLatLng]
+        attr_accessor :origin
+      
+        # Optional. The region code, specified as a CLDR two-character region code. This
+        # affects address formatting, result ranking, and may influence what results are
+        # returned. This does not restrict results to the specified region. To restrict
+        # results to a region, use `region_code_restriction`.
+        # Corresponds to the JSON property `regionCode`
+        # @return [String]
+        attr_accessor :region_code
+      
+        # Optional. A string which identifies an Autocomplete session for billing
+        # purposes. Must be a URL and filename safe base64 string with at most 36 ASCII
+        # characters in length. Otherwise an INVALID_ARGUMENT error is returned. The
+        # session begins when the user starts typing a query, and concludes when they
+        # select a place and a call to Place Details or Address Validation is made. Each
+        # session can have multiple queries, followed by one Place Details or Address
+        # Validation request. The credentials used for each request within a session
+        # must belong to the same Google Cloud Console project. Once a session has
+        # concluded, the token is no longer valid; your app must generate a fresh token
+        # for each session. If the `session_token` parameter is omitted, or if you reuse
+        # a session token, the session is charged as if no session token was provided (
+        # each request is billed separately). We recommend the following guidelines: *
+        # Use session tokens for all Place Autocomplete calls. * Generate a fresh token
+        # for each session. Using a version 4 UUID is recommended. * Ensure that the
+        # credentials used for all Place Autocomplete, Place Details, and Address
+        # Validation requests within a session belong to the same Cloud Console project.
+        # * Be sure to pass a unique session token for each new session. Using the same
+        # token for more than one session will result in each request being billed
+        # individually.
+        # Corresponds to the JSON property `sessionToken`
+        # @return [String]
+        attr_accessor :session_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @include_query_predictions = args[:include_query_predictions] if args.key?(:include_query_predictions)
+          @included_primary_types = args[:included_primary_types] if args.key?(:included_primary_types)
+          @included_region_codes = args[:included_region_codes] if args.key?(:included_region_codes)
+          @input = args[:input] if args.key?(:input)
+          @input_offset = args[:input_offset] if args.key?(:input_offset)
+          @language_code = args[:language_code] if args.key?(:language_code)
+          @location_bias = args[:location_bias] if args.key?(:location_bias)
+          @location_restriction = args[:location_restriction] if args.key?(:location_restriction)
+          @origin = args[:origin] if args.key?(:origin)
+          @region_code = args[:region_code] if args.key?(:region_code)
+          @session_token = args[:session_token] if args.key?(:session_token)
+        end
+      end
+      
+      # The region to search. The results may be biased around the specified region.
+      class GoogleMapsPlacesV1AutocompletePlacesRequestLocationBias
+        include Google::Apis::Core::Hashable
+      
+        # Circle with a LatLng as center and radius.
+        # Corresponds to the JSON property `circle`
+        # @return [Google::Apis::PlacesV1::GoogleMapsPlacesV1Circle]
+        attr_accessor :circle
+      
+        # A latitude-longitude viewport, represented as two diagonally opposite `low`
+        # and `high` points. A viewport is considered a closed region, i.e. it includes
+        # its boundary. The latitude bounds must range between -90 to 90 degrees
+        # inclusive, and the longitude bounds must range between -180 to 180 degrees
+        # inclusive. Various cases include: - If `low` = `high`, the viewport consists
+        # of that single point. - If `low.longitude` > `high.longitude`, the longitude
+        # range is inverted (the viewport crosses the 180 degree longitude line). - If `
+        # low.longitude` = -180 degrees and `high.longitude` = 180 degrees, the viewport
+        # includes all longitudes. - If `low.longitude` = 180 degrees and `high.
+        # longitude` = -180 degrees, the longitude range is empty. - If `low.latitude` >
+        # `high.latitude`, the latitude range is empty. Both `low` and `high` must be
+        # populated, and the represented box cannot be empty (as specified by the
+        # definitions above). An empty viewport will result in an error. For example,
+        # this viewport fully encloses New York City: ` "low": ` "latitude": 40.477398, "
+        # longitude": -74.259087 `, "high": ` "latitude": 40.91618, "longitude": -73.
+        # 70018 ` `
+        # Corresponds to the JSON property `rectangle`
+        # @return [Google::Apis::PlacesV1::GoogleGeoTypeViewport]
+        attr_accessor :rectangle
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @circle = args[:circle] if args.key?(:circle)
+          @rectangle = args[:rectangle] if args.key?(:rectangle)
+        end
+      end
+      
+      # The region to search. The results will be restricted to the specified region.
+      class GoogleMapsPlacesV1AutocompletePlacesRequestLocationRestriction
+        include Google::Apis::Core::Hashable
+      
+        # Circle with a LatLng as center and radius.
+        # Corresponds to the JSON property `circle`
+        # @return [Google::Apis::PlacesV1::GoogleMapsPlacesV1Circle]
+        attr_accessor :circle
+      
+        # A latitude-longitude viewport, represented as two diagonally opposite `low`
+        # and `high` points. A viewport is considered a closed region, i.e. it includes
+        # its boundary. The latitude bounds must range between -90 to 90 degrees
+        # inclusive, and the longitude bounds must range between -180 to 180 degrees
+        # inclusive. Various cases include: - If `low` = `high`, the viewport consists
+        # of that single point. - If `low.longitude` > `high.longitude`, the longitude
+        # range is inverted (the viewport crosses the 180 degree longitude line). - If `
+        # low.longitude` = -180 degrees and `high.longitude` = 180 degrees, the viewport
+        # includes all longitudes. - If `low.longitude` = 180 degrees and `high.
+        # longitude` = -180 degrees, the longitude range is empty. - If `low.latitude` >
+        # `high.latitude`, the latitude range is empty. Both `low` and `high` must be
+        # populated, and the represented box cannot be empty (as specified by the
+        # definitions above). An empty viewport will result in an error. For example,
+        # this viewport fully encloses New York City: ` "low": ` "latitude": 40.477398, "
+        # longitude": -74.259087 `, "high": ` "latitude": 40.91618, "longitude": -73.
+        # 70018 ` `
+        # Corresponds to the JSON property `rectangle`
+        # @return [Google::Apis::PlacesV1::GoogleGeoTypeViewport]
+        attr_accessor :rectangle
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @circle = args[:circle] if args.key?(:circle)
+          @rectangle = args[:rectangle] if args.key?(:rectangle)
+        end
+      end
+      
+      # Response proto for AutocompletePlaces.
+      class GoogleMapsPlacesV1AutocompletePlacesResponse
+        include Google::Apis::Core::Hashable
+      
+        # Contains a list of suggestions, ordered in descending order of relevance.
+        # Corresponds to the JSON property `suggestions`
+        # @return [Array<Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestion>]
+        attr_accessor :suggestions
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @suggestions = args[:suggestions] if args.key?(:suggestions)
+        end
+      end
+      
+      # An Autocomplete suggestion result.
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestion
+        include Google::Apis::Core::Hashable
+      
+        # Prediction results for a Place Autocomplete prediction.
+        # Corresponds to the JSON property `placePrediction`
+        # @return [Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionPlacePrediction]
+        attr_accessor :place_prediction
+      
+        # Prediction results for a Query Autocomplete prediction.
+        # Corresponds to the JSON property `queryPrediction`
+        # @return [Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionQueryPrediction]
+        attr_accessor :query_prediction
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @place_prediction = args[:place_prediction] if args.key?(:place_prediction)
+          @query_prediction = args[:query_prediction] if args.key?(:query_prediction)
+        end
+      end
+      
+      # Text representing a Place or query prediction. The text may be used as is or
+      # formatted.
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionFormattableText
+        include Google::Apis::Core::Hashable
+      
+        # A list of string ranges identifying where the input request matched in `text`.
+        # The ranges can be used to format specific parts of `text`. The substrings may
+        # not be exact matches of `input` if the matching was determined by criteria
+        # other than string matching (for example, spell corrections or transliterations)
+        # . These values are Unicode character offsets of `text`. The ranges are
+        # guaranteed to be ordered in increasing offset values.
+        # Corresponds to the JSON property `matches`
+        # @return [Array<Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionStringRange>]
+        attr_accessor :matches
+      
+        # Text that may be used as is or formatted with `matches`.
+        # Corresponds to the JSON property `text`
+        # @return [String]
+        attr_accessor :text
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @matches = args[:matches] if args.key?(:matches)
+          @text = args[:text] if args.key?(:text)
+        end
+      end
+      
+      # Prediction results for a Place Autocomplete prediction.
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionPlacePrediction
+        include Google::Apis::Core::Hashable
+      
+        # The length of the geodesic in meters from `origin` if `origin` is specified.
+        # Certain predictions such as routes may not populate this field.
+        # Corresponds to the JSON property `distanceMeters`
+        # @return [Fixnum]
+        attr_accessor :distance_meters
+      
+        # The resource name of the suggested Place. This name can be used in other APIs
+        # that accept Place names.
+        # Corresponds to the JSON property `place`
+        # @return [String]
+        attr_accessor :place
+      
+        # The unique identifier of the suggested Place. This identifier can be used in
+        # other APIs that accept Place IDs.
+        # Corresponds to the JSON property `placeId`
+        # @return [String]
+        attr_accessor :place_id
+      
+        # Contains a breakdown of a Place or query prediction into main text and
+        # secondary text. For Place predictions, the main text contains the specific
+        # name of the Place. For query predictions, the main text contains the query.
+        # The secondary text contains additional disambiguating features (such as a city
+        # or region) to further identify the Place or refine the query.
+        # Corresponds to the JSON property `structuredFormat`
+        # @return [Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionStructuredFormat]
+        attr_accessor :structured_format
+      
+        # Text representing a Place or query prediction. The text may be used as is or
+        # formatted.
+        # Corresponds to the JSON property `text`
+        # @return [Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionFormattableText]
+        attr_accessor :text
+      
+        # List of types that apply to this Place from Table A or Table B in https://
+        # developers.google.com/maps/documentation/places/web-service/place-types. A
+        # type is a categorization of a Place. Places with shared types will share
+        # similar characteristics.
+        # Corresponds to the JSON property `types`
+        # @return [Array<String>]
+        attr_accessor :types
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @distance_meters = args[:distance_meters] if args.key?(:distance_meters)
+          @place = args[:place] if args.key?(:place)
+          @place_id = args[:place_id] if args.key?(:place_id)
+          @structured_format = args[:structured_format] if args.key?(:structured_format)
+          @text = args[:text] if args.key?(:text)
+          @types = args[:types] if args.key?(:types)
+        end
+      end
+      
+      # Prediction results for a Query Autocomplete prediction.
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionQueryPrediction
+        include Google::Apis::Core::Hashable
+      
+        # Contains a breakdown of a Place or query prediction into main text and
+        # secondary text. For Place predictions, the main text contains the specific
+        # name of the Place. For query predictions, the main text contains the query.
+        # The secondary text contains additional disambiguating features (such as a city
+        # or region) to further identify the Place or refine the query.
+        # Corresponds to the JSON property `structuredFormat`
+        # @return [Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionStructuredFormat]
+        attr_accessor :structured_format
+      
+        # Text representing a Place or query prediction. The text may be used as is or
+        # formatted.
+        # Corresponds to the JSON property `text`
+        # @return [Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionFormattableText]
+        attr_accessor :text
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @structured_format = args[:structured_format] if args.key?(:structured_format)
+          @text = args[:text] if args.key?(:text)
+        end
+      end
+      
+      # Identifies a substring within a given text.
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionStringRange
+        include Google::Apis::Core::Hashable
+      
+        # Zero-based offset of the last Unicode character (exclusive).
+        # Corresponds to the JSON property `endOffset`
+        # @return [Fixnum]
+        attr_accessor :end_offset
+      
+        # Zero-based offset of the first Unicode character of the string (inclusive).
+        # Corresponds to the JSON property `startOffset`
+        # @return [Fixnum]
+        attr_accessor :start_offset
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @end_offset = args[:end_offset] if args.key?(:end_offset)
+          @start_offset = args[:start_offset] if args.key?(:start_offset)
+        end
+      end
+      
+      # Contains a breakdown of a Place or query prediction into main text and
+      # secondary text. For Place predictions, the main text contains the specific
+      # name of the Place. For query predictions, the main text contains the query.
+      # The secondary text contains additional disambiguating features (such as a city
+      # or region) to further identify the Place or refine the query.
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionStructuredFormat
+        include Google::Apis::Core::Hashable
+      
+        # Text representing a Place or query prediction. The text may be used as is or
+        # formatted.
+        # Corresponds to the JSON property `mainText`
+        # @return [Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionFormattableText]
+        attr_accessor :main_text
+      
+        # Text representing a Place or query prediction. The text may be used as is or
+        # formatted.
+        # Corresponds to the JSON property `secondaryText`
+        # @return [Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionFormattableText]
+        attr_accessor :secondary_text
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @main_text = args[:main_text] if args.key?(:main_text)
+          @secondary_text = args[:secondary_text] if args.key?(:secondary_text)
+        end
+      end
+      
       # Circle with a LatLng as center and radius.
       class GoogleMapsPlacesV1Circle
         include Google::Apis::Core::Hashable
@@ -501,8 +919,8 @@ module Google
         attr_accessor :menu_for_children
         alias_method :menu_for_children?, :menu_for_children
       
-        # An ID representing this place which may be used to look up this place again (a.
-        # k.a. the API "resource" name: places/place_id).
+        # This Place's resource name, in `places/`place_id`` format. Can be used to look
+        # up the Place.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -529,7 +947,8 @@ module Google
         # @return [Google::Apis::PlacesV1::GoogleMapsPlacesV1PlacePaymentOptions]
         attr_accessor :payment_options
       
-        # Information (including references) about photos of this place.
+        # Information (including references) about photos of this place. A maximum of 10
+        # photos can be returned.
         # Corresponds to the JSON property `photos`
         # @return [Array<Google::Apis::PlacesV1::GoogleMapsPlacesV1Photo>]
         attr_accessor :photos
@@ -592,7 +1011,8 @@ module Google
         attr_accessor :restroom
         alias_method :restroom?, :restroom
       
-        # List of reviews about this place, sorted by relevance.
+        # List of reviews about this place, sorted by relevance. A maximum of 5 reviews
+        # can be returned.
         # Corresponds to the JSON property `reviews`
         # @return [Array<Google::Apis::PlacesV1::GoogleMapsPlacesV1Review>]
         attr_accessor :reviews

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.16.0"
+      GEM_VERSION = "0.18.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.12.0"
+      GENERATOR_VERSION = "0.14.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20231205"
+      REVISION = "20240219"
     end
   end
 end

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

@@ -34,6 +34,66 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleMapsPlacesV1AutocompletePlacesRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesRequestLocationBias
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesRequestLocationRestriction
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestion
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionFormattableText
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionPlacePrediction
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionQueryPrediction
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionStringRange
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionStructuredFormat
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleMapsPlacesV1Circle
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -239,6 +299,115 @@ module Google
         end
       end
       
+      class GoogleMapsPlacesV1AutocompletePlacesRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :include_query_predictions, as: 'includeQueryPredictions'
+          collection :included_primary_types, as: 'includedPrimaryTypes'
+          collection :included_region_codes, as: 'includedRegionCodes'
+          property :input, as: 'input'
+          property :input_offset, as: 'inputOffset'
+          property :language_code, as: 'languageCode'
+          property :location_bias, as: 'locationBias', class: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesRequestLocationBias, decorator: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesRequestLocationBias::Representation
+      
+          property :location_restriction, as: 'locationRestriction', class: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesRequestLocationRestriction, decorator: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesRequestLocationRestriction::Representation
+      
+          property :origin, as: 'origin', class: Google::Apis::PlacesV1::GoogleTypeLatLng, decorator: Google::Apis::PlacesV1::GoogleTypeLatLng::Representation
+      
+          property :region_code, as: 'regionCode'
+          property :session_token, as: 'sessionToken'
+        end
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesRequestLocationBias
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :circle, as: 'circle', class: Google::Apis::PlacesV1::GoogleMapsPlacesV1Circle, decorator: Google::Apis::PlacesV1::GoogleMapsPlacesV1Circle::Representation
+      
+          property :rectangle, as: 'rectangle', class: Google::Apis::PlacesV1::GoogleGeoTypeViewport, decorator: Google::Apis::PlacesV1::GoogleGeoTypeViewport::Representation
+      
+        end
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesRequestLocationRestriction
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :circle, as: 'circle', class: Google::Apis::PlacesV1::GoogleMapsPlacesV1Circle, decorator: Google::Apis::PlacesV1::GoogleMapsPlacesV1Circle::Representation
+      
+          property :rectangle, as: 'rectangle', class: Google::Apis::PlacesV1::GoogleGeoTypeViewport, decorator: Google::Apis::PlacesV1::GoogleGeoTypeViewport::Representation
+      
+        end
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :suggestions, as: 'suggestions', class: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestion, decorator: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestion::Representation
+      
+        end
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestion
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :place_prediction, as: 'placePrediction', class: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionPlacePrediction, decorator: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionPlacePrediction::Representation
+      
+          property :query_prediction, as: 'queryPrediction', class: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionQueryPrediction, decorator: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionQueryPrediction::Representation
+      
+        end
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionFormattableText
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :matches, as: 'matches', class: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionStringRange, decorator: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionStringRange::Representation
+      
+          property :text, as: 'text'
+        end
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionPlacePrediction
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :distance_meters, as: 'distanceMeters'
+          property :place, as: 'place'
+          property :place_id, as: 'placeId'
+          property :structured_format, as: 'structuredFormat', class: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionStructuredFormat, decorator: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionStructuredFormat::Representation
+      
+          property :text, as: 'text', class: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionFormattableText, decorator: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionFormattableText::Representation
+      
+          collection :types, as: 'types'
+        end
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionQueryPrediction
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :structured_format, as: 'structuredFormat', class: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionStructuredFormat, decorator: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionStructuredFormat::Representation
+      
+          property :text, as: 'text', class: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionFormattableText, decorator: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionFormattableText::Representation
+      
+        end
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionStringRange
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :end_offset, as: 'endOffset'
+          property :start_offset, as: 'startOffset'
+        end
+      end
+      
+      class GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionStructuredFormat
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :main_text, as: 'mainText', class: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionFormattableText, decorator: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionFormattableText::Representation
+      
+          property :secondary_text, as: 'secondaryText', class: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionFormattableText, decorator: Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponseSuggestionFormattableText::Representation
+      
+        end
+      end
+      
       class GoogleMapsPlacesV1Circle
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -32,6 +32,8 @@ module Google
       #
       # @see https://mapsplatform.google.com/maps-products/#places-section
       class MapsPlacesService < Google::Apis::Core::BaseService
+        DEFAULT_ENDPOINT_TEMPLATE = "https://places.$UNIVERSE_DOMAIN$/"
+
         # @return [String]
         #  API key. Your API key identifies your project and provides you with API access,
         #  quota, and reports. Required unless you provide an OAuth 2.0 token.
@@ -43,16 +45,46 @@ module Google
         attr_accessor :quota_user
 
         def initialize
-          super('https://places.googleapis.com/', '',
+          super(DEFAULT_ENDPOINT_TEMPLATE, '',
                 client_name: 'google-apis-places_v1',
                 client_version: Google::Apis::PlacesV1::GEM_VERSION)
           @batch_path = 'batch'
         end
         
-        # Get place details with a place id (in a name) string.
+        # Returns predictions for the given input.
+        # @param [Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesRequest] google_maps_places_v1_autocomplete_places_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def autocomplete_place(google_maps_places_v1_autocomplete_places_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/places:autocomplete', options)
+          command.request_representation = Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesRequest::Representation
+          command.request_object = google_maps_places_v1_autocomplete_places_request_object
+          command.response_representation = Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponse::Representation
+          command.response_class = Google::Apis::PlacesV1::GoogleMapsPlacesV1AutocompletePlacesResponse
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Get the details of a place based on its resource name, which is a string in
+        # the `places/`place_id`` format.
         # @param [String] name
-        #   Required. A place ID returned in a Place (with "places/" prefix), or
-        #   equivalently the name in the same Place. Format: `places/`place_id``.
+        #   Required. The resource name of a place, in the `places/`place_id`` format.
         # @param [String] language_code
         #   Optional. Place details will be displayed with the preferred language if
         #   available. Current list of supported languages: https://developers.google.com/
@@ -64,6 +96,26 @@ module Google
         #   results based on applicable law. For more information, see https://www.unicode.
         #   org/cldr/charts/latest/supplemental/territory_language_information.html. Note
         #   that 3-digit region codes are not currently supported.
+        # @param [String] session_token
+        #   Optional. A string which identifies an Autocomplete session for billing
+        #   purposes. Must be a URL and filename safe base64 string with at most 36 ASCII
+        #   characters in length. Otherwise an INVALID_ARGUMENT error is returned. The
+        #   session begins when the user starts typing a query, and concludes when they
+        #   select a place and a call to Place Details or Address Validation is made. Each
+        #   session can have multiple queries, followed by one Place Details or Address
+        #   Validation request. The credentials used for each request within a session
+        #   must belong to the same Google Cloud Console project. Once a session has
+        #   concluded, the token is no longer valid; your app must generate a fresh token
+        #   for each session. If the `session_token` parameter is omitted, or if you reuse
+        #   a session token, the session is charged as if no session token was provided (
+        #   each request is billed separately). We recommend the following guidelines: *
+        #   Use session tokens for all Place Autocomplete calls. * Generate a fresh token
+        #   for each session. Using a version 4 UUID is recommended. * Ensure that the
+        #   credentials used for all Place Autocomplete, Place Details, and Address
+        #   Validation requests within a session belong to the same Cloud Console project.
+        #   * Be sure to pass a unique session token for each new session. Using the same
+        #   token for more than one session will result in each request being billed
+        #   individually.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -81,13 +133,14 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_place(name, language_code: nil, region_code: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def get_place(name, language_code: nil, region_code: nil, session_token: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1/{+name}', options)
           command.response_representation = Google::Apis::PlacesV1::GoogleMapsPlacesV1Place::Representation
           command.response_class = Google::Apis::PlacesV1::GoogleMapsPlacesV1Place
           command.params['name'] = name unless name.nil?
           command.query['languageCode'] = language_code unless language_code.nil?
           command.query['regionCode'] = region_code unless region_code.nil?
+          command.query['sessionToken'] = session_token unless session_token.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)

data/lib/google/apis/places_v1.rb

@@ -35,6 +35,9 @@ module Google
       # Private Service: https://www.googleapis.com/auth/maps-platform.places
       AUTH_MAPS_PLATFORM_PLACES = 'https://www.googleapis.com/auth/maps-platform.places'
 
+      # Private Service: https://www.googleapis.com/auth/maps-platform.places.autocomplete
+      AUTH_MAPS_PLATFORM_PLACES_AUTOCOMPLETE = 'https://www.googleapis.com/auth/maps-platform.places.autocomplete'
+
       # Private Service: https://www.googleapis.com/auth/maps-platform.places.details
       AUTH_MAPS_PLATFORM_PLACES_DETAILS = 'https://www.googleapis.com/auth/maps-platform.places.details'
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-places_v1
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.18.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-12-10 00:00:00.000000000 Z
+date: 2024-02-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.14.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.14.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -58,7 +58,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.16.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-places_v1/v0.18.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-places_v1
 post_install_message: 
 rdoc_options: []
@@ -68,14 +68,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.6
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Places API (New) V1