@googlemaps/places 1.3.0 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [1.5.0](https://github.com/googleapis/google-cloud-node/compare/places-v1.4.0...places-v1.5.0) (2024-05-21)
+
+
+### Features
+
+* [Many APIs] update Nodejs generator to send API versions in headers for GAPICs ([#5351](https://github.com/googleapis/google-cloud-node/issues/5351)) ([01f48fc](https://github.com/googleapis/google-cloud-node/commit/01f48fce63ec4ddf801d59ee2b8c0db9f6fb8372))
+* [Many APIs] update Nodejs generator to send API versions in headers for GAPICs ([#5354](https://github.com/googleapis/google-cloud-node/issues/5354)) ([a9784ed](https://github.com/googleapis/google-cloud-node/commit/a9784ed3db6ee96d171762308bbbcd57390b6866))
+
+## [1.4.0](https://github.com/googleapis/google-cloud-node/compare/places-v1.3.0...places-v1.4.0) (2024-03-29)
+
+
+### Features
+
+* [Many APIs] add several fields to manage state of database encryption update ([#5193](https://github.com/googleapis/google-cloud-node/issues/5193)) ([333b409](https://github.com/googleapis/google-cloud-node/commit/333b40951a255ecfab249bd6e7ace5877270ec85))
+
 ## [1.3.0](https://github.com/googleapis/google-cloud-node/compare/places-v1.2.0...places-v1.3.0) (2024-02-22)
 
 

package/build/protos/google/geo/type/viewport.proto

@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/build/protos/google/maps/places/v1/attribution.proto

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/build/protos/google/maps/places/v1/ev_charging.proto

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/build/protos/google/maps/places/v1/fuel_options.proto

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/build/protos/google/maps/places/v1/geometry.proto

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/build/protos/google/maps/places/v1/photo.proto

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/build/protos/google/maps/places/v1/place.proto

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -295,8 +295,8 @@ message Place {
   google.type.LocalizedText display_name = 31;
 
   // A set of type tags for this result. For example, "political" and
-  // "locality".  For the complete list of possible values, see Table A and
-  // Table B at
+  // "locality". For the complete list of possible values, see Table A and Table
+  // B at
   // https://developers.google.com/maps/documentation/places/web-service/place-types
   repeated string types = 5;
 
@@ -308,8 +308,8 @@ message Place {
   string primary_type = 50;
 
   // The display name of the primary type, localized to the request language if
-  // applicable.  For the complete list of possible values, see Table A and
-  // Table B at
+  // applicable. For the complete list of possible values, see Table A and Table
+  // B at
   // https://developers.google.com/maps/documentation/places/web-service/place-types
   google.type.LocalizedText primary_type_display_name = 32;
 
@@ -362,7 +362,8 @@ message Place {
   // chain.
   string website_uri = 16;
 
-  // 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.
   repeated Review reviews = 53;
 
   // The regular hours of operation.
@@ -373,7 +374,8 @@ message Place {
   // fractions of an hour, e.g. X hours and 15 minutes.
   optional int32 utc_offset_minutes = 22;
 
-  // Information (including references) about photos of this place.
+  // Information (including references) about photos of this place. A maximum of
+  // 10 photos can be returned.
   repeated Photo photos = 54;
 
   // The place's address in adr microformat: http://microformats.org/wiki/adr.
@@ -534,6 +536,6 @@ enum PriceLevel {
   // Place provides expensive services.
   PRICE_LEVEL_EXPENSIVE = 4;
 
-  // Place provides very expensive service s.
+  // Place provides very expensive services.
   PRICE_LEVEL_VERY_EXPENSIVE = 5;
 }

package/build/protos/google/maps/places/v1/places_service.proto

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -36,11 +36,10 @@ option objc_class_prefix = "GMPSV1";
 option php_namespace = "Google\\Maps\\Places\\V1";
 
 // Service definition for the Places API.
-// Note: every request actually requires a field mask set outside of
-// the request proto (all/'*', is not assumed).  That can be set via either a
-// side channel (SystemParameterContext) over RPC, or a header
-// (X-Goog-FieldMask) over HTTP. See:
-// https://cloud.google.com/apis/docs/system-parameters
+// Note: every request (except for Autocomplete requests) requires a field mask
+// set outside of the request proto (`all/*`, is not assumed). The field mask
+// can be set via the HTTP header `X-Goog-FieldMask`. See:
+// https://developers.google.com/maps/documentation/places/web-service/choose-fields
 service Places {
   option (google.api.default_host) = "places.googleapis.com";
 
@@ -238,7 +237,9 @@ message SearchNearbyResponse {
 message SearchTextRequest {
   // How results will be ranked in the response.
   enum RankPreference {
-    // RankPreference value not set. Will default to DISTANCE.
+    // For a categorical query such as "Restaurants in New York City", RELEVANCE
+    // is the default. For non-categorical queries such as "Mountain View, CA"
+    // we recommend that you leave rankPreference unset.
     RANK_PREFERENCE_UNSPECIFIED = 0;
 
     // Ranks results by distance.
@@ -282,13 +283,13 @@ message SearchTextRequest {
 
   // Searchable EV options of a place search request.
   message EVOptions {
-    // Optional. Filtering places by minimum charging rate. Any places with
-    // charging a rate less than the minimum charging rate are filtered out.
+    // Optional. Minimum required charging rate in kilowatts. A place with a
+    // charging rate less than the specified rate is filtered out.
     double minimum_charging_rate_kw = 1
         [(google.api.field_behavior) = OPTIONAL];
 
     // Optional. The list of preferred EV connector types. A place that does not
-    // support any of the listed connector types are filter out.
+    // support any of the listed connector types is filtered out.
     repeated EVConnectorType connector_types = 2
         [(google.api.field_behavior) = OPTIONAL];
   }
@@ -465,21 +466,23 @@ message GetPlaceRequest {
   // Note that 3-digit region codes are not currently supported.
   string region_code = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. An arbitrary string which identifies an autocomplete session for
-  // billing purposes. Must be at most 36 characters in length. Otherwise an
-  // INVALID_ARGUMENT error is returned.
+  // 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
-  // selection. 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).
+  // 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.
@@ -538,8 +541,8 @@ message AutocompletePlacesRequest {
   LocationRestriction location_restriction = 3
       [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. Included primary Place type (e.g. "restaurant" or "gas_station")
-  // from
+  // 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
@@ -582,21 +585,23 @@ message AutocompletePlacesRequest {
   // predictions. Otherwise the response will only return Place predictions.
   bool include_query_predictions = 10 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. An arbitrary string which identifies an autocomplete session for
-  // billing purposes. Must be at most 36 characters in length. Otherwise an
-  // INVALID_ARGUMENT error is returned.
+  // 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
-  // selection. 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).
+  // 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.
@@ -632,7 +637,7 @@ message AutocompletePlacesResponse {
       // 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 (e.g. spell
+      // determined by criteria other than string matching (for example, spell
       // corrections or transliterations).
       //
       // These values are Unicode character offsets of `text`. The ranges are
@@ -713,7 +718,8 @@ message AutocompletePlacesResponse {
     // Prediction results for a Query Autocomplete prediction.
     message QueryPrediction {
       // The predicted text. This text does not represent a Place, but rather a
-      // text query that could be used in a search endpoint (e.g. TextSearch).
+      // text query that could be used in a search endpoint (for example,
+      // Text Search).
       //
       // `text` is recommended for developers who wish to show a single UI
       // element. Developers who wish to show two separate, but related, UI

package/build/protos/google/maps/places/v1/review.proto

@@ -1,4 +1,4 @@
-// Copyright 2023 Google LLC
+// Copyright 2024 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.