@googlemaps/places 1.5.0 → 1.7.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.7.0](https://github.com/googleapis/google-cloud-node/compare/places-v1.6.0...places-v1.7.0) (2024-09-24)
+
+
+### Features
+
+* [places] add `routing_parameters` to SearchNearbyRequest and SearchTextRequest ([#5688](https://github.com/googleapis/google-cloud-node/issues/5688)) ([02aeffb](https://github.com/googleapis/google-cloud-node/commit/02aeffb9d539fb6612c53887f61f398bdd12aaab))
+
+## [1.6.0](https://github.com/googleapis/google-cloud-node/compare/places-v1.5.0...places-v1.6.0) (2024-05-23)
+
+
+### Features
+
+* [places] add `generative_summary` and `area_summary` for place summaries ([#5364](https://github.com/googleapis/google-cloud-node/issues/5364)) ([b0fbf7b](https://github.com/googleapis/google-cloud-node/commit/b0fbf7b73894284dd46aea5faa0a91f97123a194))
+
 ## [1.5.0](https://github.com/googleapis/google-cloud-node/compare/places-v1.4.0...places-v1.5.0) (2024-05-21)
 
 

package/README.md

@@ -44,7 +44,7 @@ Google APIs Client Libraries, in [Client Libraries Explained][explained].
 1.  [Select or create a Cloud Platform project][projects].
 1.  [Enable billing for your project][billing].
 1.  [Enable the Places API (New) API][enable_api].
-1.  [Set up authentication with a service account][auth] so you can access the
+1.  [Set up authentication][auth] so you can access the
     API from your local workstation.
 
 ### Installing the client library
@@ -167,4 +167,4 @@ See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/LICENSE)
 [projects]: https://console.cloud.google.com/project
 [billing]: https://support.google.com/cloud/answer/6293499#enable-billing
 [enable_api]: https://console.cloud.google.com/flows/enableapi?apiid=places.googleapis.com
-[auth]: https://cloud.google.com/docs/authentication/getting-started
+[auth]: https://cloud.google.com/docs/authentication/external/set-up-adc-local

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

@@ -0,0 +1,45 @@
+// 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.
+// 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.
+
+syntax = "proto3";
+
+package google.maps.places.v1;
+
+import "google/maps/places/v1/reference.proto";
+import "google/type/localized_text.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Places.V1";
+option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
+option java_multiple_files = true;
+option java_outer_classname = "ContentBlockProto";
+option java_package = "com.google.maps.places.v1";
+option objc_class_prefix = "GMPSV1";
+option php_namespace = "Google\\Maps\\Places\\V1";
+
+// A block of content that can be served individually.
+message ContentBlock {
+  // The topic of the content, for example "overview" or "restaurant".
+  string topic = 1;
+
+  // Content related to the topic.
+  google.type.LocalizedText content = 2;
+
+  // Experimental: See
+  // https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative
+  // for more details.
+  //
+  // References that are related to this block of content.
+  References references = 3;
+}

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

@@ -0,0 +1,120 @@
+// 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.
+// 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.
+
+syntax = "proto3";
+
+package google.maps.places.v1;
+
+import "google/maps/places/v1/photo.proto";
+import "google/maps/places/v1/review.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Places.V1";
+option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
+option java_multiple_files = true;
+option java_outer_classname = "ContextualContentProto";
+option java_package = "com.google.maps.places.v1";
+option objc_class_prefix = "GMPSV1";
+option php_namespace = "Google\\Maps\\Places\\V1";
+
+// Experimental: See
+// https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative
+// for more details.
+//
+// Content that is contextual to the place query.
+message ContextualContent {
+  // Experimental: See
+  // https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative
+  // for more details.
+  //
+  // Justifications for the place. Justifications answers the question of why a
+  // place could interest an end user.
+  message Justification {
+    // Experimental: See
+    // https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative
+    // for more details.
+    //
+    // User review justifications. This highlights a section of the user review
+    // that would interest an end user. For instance, if the search query is
+    // "firewood pizza", the review justification highlights the text relevant
+    // to the search query.
+    message ReviewJustification {
+      // The text highlighted by the justification. This is a subset of the
+      // review itself. The exact word to highlight is marked by the
+      // HighlightedTextRange. There could be several words in the text being
+      // highlighted.
+      message HighlightedText {
+        // The range of highlighted text.
+        message HighlightedTextRange {
+          int32 start_index = 1;
+
+          int32 end_index = 2;
+        }
+
+        string text = 1;
+
+        // The list of the ranges of the highlighted text.
+        repeated HighlightedTextRange highlighted_text_ranges = 2;
+      }
+
+      HighlightedText highlighted_text = 1;
+
+      // The review that the highlighted text is generated from.
+      Review review = 2;
+    }
+
+    // Experimental: See
+    // https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative
+    // for more details.
+    // BusinessAvailabilityAttributes justifications. This shows some attributes
+    // a business has that could interest an end user.
+    message BusinessAvailabilityAttributesJustification {
+      // If a place provides takeout.
+      bool takeout = 1;
+
+      // If a place provides delivery.
+      bool delivery = 2;
+
+      // If a place provides dine-in.
+      bool dine_in = 3;
+    }
+
+    oneof justification {
+      // Experimental: See
+      // https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative
+      // for more details.
+      ReviewJustification review_justification = 1;
+
+      // Experimental: See
+      // https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative
+      // for more details.
+      BusinessAvailabilityAttributesJustification
+          business_availability_attributes_justification = 2;
+    }
+  }
+
+  // List of reviews about this place, contexual to the place query.
+  repeated Review reviews = 1;
+
+  // Information (including references) about photos of this place, contexual to
+  // the place query.
+  repeated Photo photos = 2;
+
+  // Experimental: See
+  // https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative
+  // for more details.
+  //
+  // Justifications for the place.
+  repeated Justification justifications = 3;
+}

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

@@ -18,9 +18,11 @@ package google.maps.places.v1;
 
 import "google/api/resource.proto";
 import "google/geo/type/viewport.proto";
+import "google/maps/places/v1/content_block.proto";
 import "google/maps/places/v1/ev_charging.proto";
 import "google/maps/places/v1/fuel_options.proto";
 import "google/maps/places/v1/photo.proto";
+import "google/maps/places/v1/reference.proto";
 import "google/maps/places/v1/review.proto";
 import "google/type/date.proto";
 import "google/type/latlng.proto";
@@ -165,8 +167,10 @@ message Place {
       google.type.Date date = 1;
     }
 
-    // Is this place open right now?  Always present unless we lack time-of-day
-    // or timezone data for these opening hours.
+    // Whether the opening hours period is currently active. For regular opening
+    // hours and current opening hours, this field means whether the place is
+    // open. For secondary opening hours and current secondary opening hours,
+    // this field means whether the secondary hours of this place is active.
     optional bool open_now = 1;
 
     // The periods that this place is open during the week. The periods are in
@@ -283,6 +287,33 @@ message Place {
     optional bool wheelchair_accessible_seating = 4;
   }
 
+  // Experimental: See
+  // https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative
+  // for more details.
+  //
+  // AI-generated summary of the place.
+  message GenerativeSummary {
+    // The overview of the place.
+    google.type.LocalizedText overview = 1;
+
+    // The detailed description of the place.
+    google.type.LocalizedText description = 2;
+
+    // References that are used to generate the summary description.
+    References references = 3;
+  }
+
+  // Experimental: See
+  // https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative
+  // for more details.
+  //
+  // AI-generated summary of the area that the place is in.
+  message AreaSummary {
+    // Content blocks that compose the area summary. Each block has a separate
+    // topic about the area.
+    repeated ContentBlock content_blocks = 4;
+  }
+
   // This Place's resource name, in `places/{place_id}` format.  Can be used to
   // look up the Place.
   string name = 1;
@@ -517,6 +548,20 @@ message Place {
 
   // Information of ev charging options.
   EVChargeOptions ev_charge_options = 79;
+
+  // Experimental: See
+  // https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative
+  // for more details.
+  //
+  // AI-generated summary of the place.
+  GenerativeSummary generative_summary = 80;
+
+  // Experimental: See
+  // https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative
+  // for more details.
+  //
+  // AI-generated summary of the area that the place is in.
+  AreaSummary area_summary = 81;
 }
 
 // Price level of the place.

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

@@ -21,9 +21,15 @@ import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/geo/type/viewport.proto";
+import "google/maps/places/v1/contextual_content.proto";
 import "google/maps/places/v1/ev_charging.proto";
 import "google/maps/places/v1/geometry.proto";
 import "google/maps/places/v1/place.proto";
+import "google/maps/places/v1/polyline.proto";
+import "google/maps/places/v1/route_modifiers.proto";
+import "google/maps/places/v1/routing_preference.proto";
+import "google/maps/places/v1/routing_summary.proto";
+import "google/maps/places/v1/travel_mode.proto";
 import "google/type/latlng.proto";
 
 option cc_enable_arenas = true;
@@ -86,6 +92,28 @@ service Places {
   }
 }
 
+// Parameters to configure the routing calculations to the places in the
+// response, both along a route (where result ranking will be influenced) and
+// for calculating travel times on results.
+message RoutingParameters {
+  // Optional. An explicit routing origin that overrides the origin defined in
+  // the polyline. By default, the polyline origin is used.
+  google.type.LatLng origin = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The travel mode.
+  TravelMode travel_mode = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The route modifiers.
+  RouteModifiers route_modifiers = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Specifies how to compute the routing summaries. The server
+  // attempts to use the selected routing preference to compute the route. The
+  // traffic aware routing preference is only available for the `DRIVE` or
+  // `TWO_WHEELER` `travelMode`.
+  RoutingPreference routing_preference = 4
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
 // Request proto for Search Nearby.
 //
 //
@@ -221,6 +249,10 @@ message SearchNearbyRequest {
 
   // How results will be ranked in the response.
   RankPreference rank_preference = 9;
+
+  // Optional. Parameters that affect the routing to the search results.
+  RoutingParameters routing_parameters = 10
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response proto for Search Nearby.
@@ -229,6 +261,13 @@ message SearchNearbyResponse {
   // A list of places that meets user's requirements like places
   // types, number of places and specific location restriction.
   repeated Place places = 1;
+
+  // A list of routing summaries where each entry associates to the
+  // corresponding place in the same index in the places field. If the routing
+  // summary is not available for one of the places, it will contain an empty
+  // entry. This list should have as many entries as the list of places if
+  // requested.
+  repeated RoutingSummary routing_summaries = 2;
 }
 
 // Request proto for SearchText.
@@ -294,6 +333,25 @@ message SearchTextRequest {
         [(google.api.field_behavior) = OPTIONAL];
   }
 
+  // Specifies a precalculated polyline from the [Routes
+  // API](https://developers.google.com/maps/documentation/routes) defining the
+  // route to search. Searching along a route is similar to using the
+  // `locationBias` or `locationRestriction` request option to bias the search
+  // results. However, while the `locationBias` and `locationRestriction`
+  // options let you specify a region to bias the search results, this option
+  // lets you bias the results along a trip route.
+  //
+  // Results are not guaranteed to be along the route provided, but rather are
+  // ranked within the search area defined by the polyline and, optionally, by
+  // the `locationBias` or `locationRestriction` based on minimal detour times
+  // from origin to destination. The results might be along an alternate route,
+  // especially if the provided polyline does not define an optimal route from
+  // origin to destination.
+  message SearchAlongRouteParameters {
+    // Required. The route polyline.
+    Polyline polyline = 1 [(google.api.field_behavior) = REQUIRED];
+  }
+
   // Required. The text query for textual search.
   string text_query = 1 [(google.api.field_behavior) = REQUIRED];
 
@@ -364,6 +422,14 @@ message SearchTextRequest {
 
   // Optional. Set the searchable EV options of a place search request.
   EVOptions ev_options = 15 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Additional parameters for routing to results.
+  RoutingParameters routing_parameters = 16
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Additional parameters proto for searching along a route.
+  SearchAlongRouteParameters search_along_route_parameters = 17
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response proto for SearchText.
@@ -371,6 +437,26 @@ message SearchTextRequest {
 message SearchTextResponse {
   // A list of places that meet the user's text search criteria.
   repeated Place places = 1;
+
+  // A list of routing summaries where each entry associates to the
+  // corresponding place in the same index in the places field. If the routing
+  // summary is not available for one of the places, it will contain an empty
+  // entry. This list will have as many entries as the list of places if
+  // requested.
+  repeated RoutingSummary routing_summaries = 2;
+
+  // Experimental: See
+  // https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative
+  // for more details.
+  //
+  // A list of contextual contents where each entry associates to the
+  // corresponding place in the same index in the places field. The contents
+  // that are relevant to the `text_query` in the request are preferred. If the
+  // contextual content is not available for one of the places, it will return
+  // non-contextual content. It will be empty only when the content is
+  // unavailable for this place. This list will have as many entries as the
+  // list of places if requested.
+  repeated ContextualContent contextual_contents = 3;
 }
 
 // Request for fetching a photo of a place using a photo resource name.
@@ -542,11 +628,11 @@ message AutocompletePlacesRequest {
       [(google.api.field_behavior) = OPTIONAL];
 
   // 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.
+  // "gas_station") in Place Types
+  // (https://developers.google.com/maps/documentation/places/web-service/place-types),
+  // or only `(regions)`, or only `(cities)`. 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.
   repeated string included_primary_types = 4
       [(google.api.field_behavior) = OPTIONAL];
 

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

@@ -0,0 +1,47 @@
+// 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.
+// 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.
+
+syntax = "proto3";
+
+package google.maps.places.v1;
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Places.V1";
+option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
+option java_multiple_files = true;
+option java_outer_classname = "PolylineProto";
+option java_package = "com.google.maps.places.v1";
+option objc_class_prefix = "GMPSV1";
+option php_namespace = "Google\\Maps\\Places\\V1";
+
+// A route polyline.  Only supports an [encoded
+// polyline](https://developers.google.com/maps/documentation/utilities/polylinealgorithm),
+// which can be passed as a string and includes compression with minimal
+// lossiness. This is the Routes API default output.
+message Polyline {
+  // Encapsulates the type of polyline. Routes API output defaults to
+  // `encoded_polyline`.
+  oneof polyline_type {
+    // An [encoded
+    // polyline](https://developers.google.com/maps/documentation/utilities/polylinealgorithm),
+    // as returned by the [Routes API by
+    // default](https://developers.google.com/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#polylineencoding).
+    // See the
+    // [encoder](https://developers.google.com/maps/documentation/utilities/polylineutility)
+    // and
+    // [decoder](https://developers.google.com/maps/documentation/routes/polylinedecoder)
+    // tools.
+    string encoded_polyline = 1;
+  }
+}

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

@@ -0,0 +1,45 @@
+// 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.
+// 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.
+
+syntax = "proto3";
+
+package google.maps.places.v1;
+
+import "google/api/resource.proto";
+import "google/maps/places/v1/review.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Places.V1";
+option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
+option java_multiple_files = true;
+option java_outer_classname = "ReferenceProto";
+option java_package = "com.google.maps.places.v1";
+option objc_class_prefix = "GMPSV1";
+option php_namespace = "Google\\Maps\\Places\\V1";
+
+// Experimental: See
+// https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative
+// for more details.
+//
+// Reference that the generative content is related to.
+message References {
+  // Reviews that serve as references.
+  repeated Review reviews = 1;
+
+  // The list of resource names of the referenced places. This name can be used
+  // in other APIs that accept Place resource names.
+  repeated string places = 2 [
+    (google.api.resource_reference) = { type: "places.googleapis.com/Place" }
+  ];
+}

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

@@ -0,0 +1,52 @@
+// 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.
+// 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.
+
+syntax = "proto3";
+
+package google.maps.places.v1;
+
+import "google/api/field_behavior.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Places.V1";
+option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
+option java_multiple_files = true;
+option java_outer_classname = "RouteModifiersProto";
+option java_package = "com.google.maps.places.v1";
+option objc_class_prefix = "GMPSV1";
+option php_namespace = "Google\\Maps\\Places\\V1";
+
+// Encapsulates a set of optional conditions to satisfy when calculating the
+// routes.
+message RouteModifiers {
+  // Optional. When set to true, avoids toll roads where reasonable, giving
+  // preference to routes not containing toll roads. Applies only to the `DRIVE`
+  // and `TWO_WHEELER` [`TravelMode`][google.maps.places.v1.TravelMode].
+  bool avoid_tolls = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. When set to true, avoids highways where reasonable, giving
+  // preference to routes not containing highways. Applies only to the `DRIVE`
+  // and `TWO_WHEELER` [`TravelMode`][google.maps.places.v1.TravelMode].
+  bool avoid_highways = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. When set to true, avoids ferries where reasonable, giving
+  // preference to routes not containing ferries. Applies only to the `DRIVE`
+  // and `TWO_WHEELER` [`TravelMode`][google.maps.places.v1.TravelMode].
+  bool avoid_ferries = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. When set to true, avoids navigating indoors where reasonable,
+  // giving preference to routes not containing indoor navigation. Applies only
+  // to the `WALK` [`TravelMode`][google.maps.places.v1.TravelMode].
+  bool avoid_indoor = 4 [(google.api.field_behavior) = OPTIONAL];
+}

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

@@ -0,0 +1,57 @@
+// 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.
+// 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.
+
+syntax = "proto3";
+
+package google.maps.places.v1;
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Places.V1";
+option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
+option java_multiple_files = true;
+option java_outer_classname = "RoutingPreferenceProto";
+option java_package = "com.google.maps.places.v1";
+option objc_class_prefix = "GMPSV1";
+option php_namespace = "Google\\Maps\\Places\\V1";
+
+// A set of values that specify factors to take into consideration when
+// calculating the route.
+enum RoutingPreference {
+  // No routing preference specified. Default to `TRAFFIC_UNAWARE`.
+  ROUTING_PREFERENCE_UNSPECIFIED = 0;
+
+  // Computes routes without taking live traffic conditions into consideration.
+  // Suitable when traffic conditions don't matter or are not applicable.
+  // Using this value produces the lowest latency.
+  // Note: For [`TravelMode`][google.maps.places.v1.TravelMode]
+  // `DRIVE` and `TWO_WHEELER`, the route and duration chosen are based on road
+  // network and average time-independent traffic conditions, not current road
+  // conditions. Consequently, routes may include roads that are temporarily
+  // closed. Results for a given
+  // request may vary over time due to changes in the road network, updated
+  // average traffic conditions, and the distributed nature of the service.
+  // Results may also vary between nearly-equivalent routes at any time or
+  // frequency.
+  TRAFFIC_UNAWARE = 1;
+
+  // Calculates routes taking live traffic conditions into consideration.
+  // In contrast to `TRAFFIC_AWARE_OPTIMAL`, some optimizations are applied to
+  // significantly reduce latency.
+  TRAFFIC_AWARE = 2;
+
+  // Calculates the routes taking live traffic conditions into consideration,
+  // without applying most performance optimizations. Using this value produces
+  // the highest latency.
+  TRAFFIC_AWARE_OPTIMAL = 3;
+}