@googlemaps/places 1.6.0 → 1.8.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.8.0](https://github.com/googleapis/google-cloud-node/compare/places-v1.7.0...places-v1.8.0) (2024-11-14)
+
+
+### Features
+
+* [places] update attributes in Places API ([#5795](https://github.com/googleapis/google-cloud-node/issues/5795)) ([10a04fc](https://github.com/googleapis/google-cloud-node/commit/10a04fc297bcf2bdeb8019fb69e638b18eb2e159))
+
+## [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)
 
 

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/attribution.proto

@@ -16,7 +16,6 @@ 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;

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

@@ -19,7 +19,6 @@ 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;

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

@@ -19,7 +19,6 @@ 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;

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

@@ -18,7 +18,6 @@ package google.maps.places.v1;
 
 import "google/protobuf/timestamp.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;

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

@@ -19,7 +19,6 @@ package google.maps.places.v1;
 import "google/protobuf/timestamp.proto";
 import "google/type/money.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;

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

@@ -19,7 +19,6 @@ package google.maps.places.v1;
 import "google/api/field_behavior.proto";
 import "google/type/latlng.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;

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

@@ -20,7 +20,6 @@ import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/maps/places/v1/attribution.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;

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

@@ -22,13 +22,14 @@ 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/price_range.proto";
 import "google/maps/places/v1/reference.proto";
 import "google/maps/places/v1/review.proto";
+import "google/protobuf/timestamp.proto";
 import "google/type/date.proto";
 import "google/type/latlng.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;
@@ -167,8 +168,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
@@ -191,6 +194,16 @@ message Place {
     // current_opening_hours and current_secondary_opening_hours if there are
     // exceptional hours.
     repeated SpecialDay special_days = 5;
+
+    // The next time the current opening hours period starts up to 7 days in the
+    // future. This field is only populated if the opening hours period is not
+    // active at the time of serving the request.
+    google.protobuf.Timestamp next_open_time = 6;
+
+    // The next time the current opening hours period ends up to 7 days in the
+    // future. This field is only populated if the opening hours period is
+    // active at the time of serving the request.
+    google.protobuf.Timestamp next_close_time = 7;
   }
 
   // Business status for the place.
@@ -312,6 +325,17 @@ message Place {
     repeated ContentBlock content_blocks = 4;
   }
 
+  // Info about the place in which this place is located.
+  message ContainingPlace {
+    // The resource name of the place in which this place is located.
+    string name = 1 [
+      (google.api.resource_reference) = { type: "places.googleapis.com/Place" }
+    ];
+
+    // The place id of the place in which this place is located.
+    string id = 2;
+  }
+
   // This Place's resource name, in `places/{place_id}` format.  Can be used to
   // look up the Place.
   string name = 1;
@@ -376,7 +400,9 @@ message Place {
   // The position of this place.
   google.type.LatLng location = 12;
 
-  // A viewport suitable for displaying the place on an average-sized map.
+  // A viewport suitable for displaying the place on an average-sized map. This
+  // viewport should not be used as the physical boundary or the service area of
+  // the business.
   google.geo.type.Viewport viewport = 13;
 
   // A rating between 1.0 and 5.0, based on user reviews of this place.
@@ -410,7 +436,6 @@ message Place {
   // The place's address in adr microformat: http://microformats.org/wiki/adr.
   string adr_format_address = 24;
 
-  // The business status for the place.
   BusinessStatus business_status = 25;
 
   // Price level of the place.
@@ -560,6 +585,19 @@ message Place {
   //
   // AI-generated summary of the area that the place is in.
   AreaSummary area_summary = 81;
+
+  // List of places in which the current place is located.
+  repeated ContainingPlace containing_places = 82;
+
+  // Indicates whether the place is a pure service area business. Pure service
+  // area business is a business that visits or delivers to customers directly
+  // but does not serve customers at their business address. For example,
+  // businesses like cleaning services or plumbers. Those businesses may not
+  // have a physical address or location on Google Maps.
+  optional bool pure_service_area_business = 83;
+
+  // The price range associated with a Place.
+  PriceRange price_range = 86;
 }
 
 // Price level of the place.

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

@@ -25,9 +25,13 @@ 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;
 option csharp_namespace = "Google.Maps.Places.V1";
 option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
 option java_multiple_files = true;
@@ -87,6 +91,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.
 //
 //
@@ -222,6 +248,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.
@@ -230,6 +260,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.
@@ -295,6 +332,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];
 
@@ -365,6 +421,24 @@ 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];
+
+  // Optional. Include pure service area businesses if the field is set to true.
+  // Pure service area business is a business that visits or delivers to
+  // customers directly but does not serve customers at their business address.
+  // For example, businesses like cleaning services or plumbers. Those
+  // businesses do not have a physical address or location on Google Maps.
+  // Places will not return fields including `location`, `plus_code`, and other
+  // location related fields for these businesses.
+  bool include_pure_service_area_businesses = 20
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response proto for SearchText.
@@ -373,6 +447,13 @@ 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.
@@ -382,7 +463,7 @@ message SearchTextResponse {
   // 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 should have as many entries as the
+  // unavailable for this place. This list will have as many entries as the
   // list of places if requested.
   repeated ContextualContent contextual_contents = 3;
 }
@@ -626,6 +707,16 @@ message AutocompletePlacesRequest {
   //   same token for more than one session will result in each request being
   //   billed individually.
   string session_token = 11 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Include pure service area businesses if the field is set to true.
+  // Pure service area business is a business that visits or delivers to
+  // customers directly but does not serve customers at their business address.
+  // For example, businesses like cleaning services or plumbers. Those
+  // businesses do not have a physical address or location on Google Maps.
+  // Places will not return fields including `location`, `plus_code`, and other
+  // location related fields for these businesses.
+  bool include_pure_service_area_businesses = 12
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response proto for AutocompletePlaces.

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

@@ -0,0 +1,46 @@
+// 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 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/price_range.proto

@@ -0,0 +1,39 @@
+// 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/type/money.proto";
+
+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 = "PriceRangeProto";
+option java_package = "com.google.maps.places.v1";
+option objc_class_prefix = "GMPSV1";
+option php_namespace = "Google\\Maps\\Places\\V1";
+
+// The price range associated with a Place. `end_price` could be unset, which
+// indicates a range without upper bound (e.g. "More than $100").
+message PriceRange {
+  // The low end of the price range (inclusive). Price should be at or above
+  // this amount.
+  google.type.Money start_price = 1;
+
+  // The high end of the price range (exclusive). Price should be lower than
+  // this amount.
+  google.type.Money end_price = 2;
+}

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

@@ -19,7 +19,6 @@ 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;

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

@@ -21,7 +21,6 @@ import "google/maps/places/v1/attribution.proto";
 import "google/protobuf/timestamp.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;

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

@@ -0,0 +1,51 @@
+// 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 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,56 @@
+// 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 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;
+}

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

@@ -0,0 +1,61 @@
+// 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/protobuf/duration.proto";
+
+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 = "RoutingSummaryProto";
+option java_package = "com.google.maps.places.v1";
+option objc_class_prefix = "GMPSV1";
+option php_namespace = "Google\\Maps\\Places\\V1";
+
+// The duration and distance from the routing origin to a place in the
+// response, and a second leg from that place to the destination, if requested.
+// **Note:** Adding `routingSummaries` in the field mask without also including
+// either the `routingParameters.origin` parameter or the
+// `searchAlongRouteParameters.polyline.encodedPolyline` parameter in the
+// request causes an error.
+message RoutingSummary {
+  // A leg is a single portion of a journey from one location to another.
+  message Leg {
+    // The time it takes to complete this leg of the trip.
+    google.protobuf.Duration duration = 1;
+
+    // The distance of this leg of the trip.
+    int32 distance_meters = 2;
+  }
+
+  // The legs of the trip.
+  //
+  // When you calculate travel duration and distance from a set origin, `legs`
+  // contains a single leg containing the duration and distance from the origin
+  // to the destination.  When you do a search along route, `legs` contains two
+  // legs: one from the origin to place, and one from the place to the
+  // destination.
+  repeated Leg legs = 1;
+
+  // A link to show directions on Google Maps using the waypoints from the given
+  // routing summary. The route generated by this link is not guaranteed to be
+  // the same as the route used to generate the routing summary.
+  // The link uses information provided in the request, from fields including
+  // `routingParameters` and `searchAlongRouteParameters` when applicable, to
+  // generate the directions link.
+  string directions_uri = 2;
+}