feat: [routing] add a new Waypoint source to accept a token that identifies a Navigation Point obtained from the SearchDestinations method of the Geocoding API (#7531)

gcf-owl-bot[bot] · quirogas · pearigee · web-flow · commit b906b3ac62ee · 2026-03-19T11:08:02.000-07:00
* feat: add a new Waypoint source to accept a token that identifies a Navigation Point obtained from the `SearchDestinations` method of the Geocoding API docs: regenerated documentation for fields PiperOrigin-RevId: 879699007 Source-Link: googleapis/googleapis@67b1168 Source-Link: googleapis/googleapis-gen@3a6dbf1 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLW1hcHMtcm91dGluZy8uT3dsQm90LnlhbWwiLCJoIjoiM2E2ZGJmMTFiYzk5NjNiNjZkYWUxZDA1N2UzNWEwMjdlYTlhNjgyNyJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com> Co-authored-by: Santiago Quiroga <22756465+quirogas@users.noreply.github.com> Co-authored-by: Gabe Pearhill <86282859+pearigee@users.noreply.github.com>
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/fallback_info.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/fallback_info.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/geocoding_results.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/geocoding_results.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/localized_time.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/localized_time.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/location.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/location.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/maneuver.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/maneuver.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/navigation_instruction.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/navigation_instruction.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/polyline.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/polyline.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/polyline_details.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/polyline_details.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/route.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/route.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -121,8 +121,8 @@ message Route {
   RouteLocalizedValues localized_values = 11;
 
   // An opaque token that can be passed to [Navigation
-  // SDK](https://developers.google.com/maps/documentation/navigation) to
-  // reconstruct the route during navigation, and, in the event of rerouting,
+  // SDK](https://developers.google.com/maps/documentation/mobility/driver-sdk/navigation)
+  // to reconstruct the route during navigation, and, in the event of rerouting,
   // honor the original intention when the route was created. Treat this token
   // as an opaque blob.  Don't compare its value across requests as its value
   // may change even if the service returns the exact same route.
@@ -141,16 +141,21 @@ message Route {
 // about, such as possible traffic zone restrictions.
 message RouteTravelAdvisory {
   // Contains information about tolls on the route. This field is only populated
-  // if tolls are expected on the route. If this field is set, but the
-  // `estimatedPrice` subfield is not populated, then the route contains tolls,
-  // but the estimated price is unknown. If this field is not set, then there
-  // are no tolls expected on the route.
+  // if tolls are expected on the route and `TOLLS` is included in the request's
+  // [ComputeRoutesRequest.extra_computations][google.maps.routing.v2.ComputeRoutesRequest.extra_computations].
+  // If this field is set, but the `estimatedPrice` subfield is not populated,
+  // then the route contains tolls, but the estimated price is unknown. If
+  // `toll_info` is not set, then there are no tolls expected on the route.
   TollInfo toll_info = 2;
 
-  // Speed reading intervals detailing traffic density. Applicable in case of
-  // `TRAFFIC_AWARE` and `TRAFFIC_AWARE_OPTIMAL` routing preferences.
-  // The intervals cover the entire polyline of the route without overlap.
-  // The start point of a specified interval is the same as the end point of the
+  // Speed reading intervals indicating traffic density. This field is only
+  // populated for requests when the request has a `TRAFFIC_AWARE` or
+  // `TRAFFIC_AWARE_OPTIMAL`
+  // [ComputeRoutesRequest.routing_preference][google.maps.routing.v2.ComputeRoutesRequest.routing_preference]
+  // value, and `TRAFFIC_ON_POLYLINE` is included in the
+  // [ComputeRoutesRequest.extra_computations][google.maps.routing.v2.ComputeRoutesRequest.extra_computations].
+  // The intervals cover the entire polyline of the route without overlap. The
+  // start point of a specified interval is the same as the end point of the
   // preceding interval.
   //
   // Example:
@@ -160,6 +165,9 @@ message RouteTravelAdvisory {
   repeated SpeedReadingInterval speed_reading_intervals = 3;
 
   // The predicted fuel consumption in microliters.
+  // This field is only populated when `FUEL_CONSUMPTION` is included in the
+  // request's
+  // [ComputeRoutesRequest.extra_computations][google.maps.routing.v2.ComputeRoutesRequest.extra_computations].
   int64 fuel_consumption_microliters = 5;
 
   // Returned route may have restrictions that are not suitable for requested
@@ -177,14 +185,20 @@ message RouteTravelAdvisory {
 message RouteLegTravelAdvisory {
   // Contains information about tolls on the specific `RouteLeg`.
   // This field is only populated if we expect there are tolls on the
-  // `RouteLeg`. If this field is set but the estimated_price subfield is not
+  // `RouteLeg` and `TOLLS` is included in the request's
+  // [ComputeRoutesRequest.extra_computations][google.maps.routing.v2.ComputeRoutesRequest.extra_computations].
+  // If this field is set but the estimated_price subfield is not
   // populated, we expect that road contains tolls but we do not know an
-  // estimated price. If this field does not exist, then there is no toll on the
-  // `RouteLeg`.
+  // estimated price. If `toll_info` does not exist, then there is no toll on
+  // the `RouteLeg`.
   TollInfo toll_info = 1;
 
-  // Speed reading intervals detailing traffic density. Applicable in case of
-  // `TRAFFIC_AWARE` and `TRAFFIC_AWARE_OPTIMAL` routing preferences.
+  // Speed reading intervals indicating traffic density. This field is only
+  // populated for requests when the request has a `TRAFFIC_AWARE` or
+  // `TRAFFIC_AWARE_OPTIMAL`
+  // [ComputeRoutesRequest.routing_preference][google.maps.routing.v2.ComputeRoutesRequest.routing_preference]
+  // value, and `TRAFFIC_ON_POLYLINE` is included in the
+  // [ComputeRoutesRequest.extra_computations][google.maps.routing.v2.ComputeRoutesRequest.extra_computations].
   // The intervals cover the entire polyline of the `RouteLeg` without overlap.
   // The start point of a specified interval is the same as the end point of the
   // preceding interval.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/route_label.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/route_label.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/route_modifiers.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/route_modifiers.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/route_travel_mode.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/route_travel_mode.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/routes_service.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/routes_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -235,8 +235,8 @@ message ComputeRoutesRequest {
       [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The arrival time.
-  // NOTE: Can only be set when
-  // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode] is set to
+  // NOTE: This field is ignored when requests specify a
+  // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode] other than
   // `TRANSIT`. You can specify either `departure_time` or `arrival_time`, but
   // not both. Transit trips are available for up to 7 days in the past or 100
   // days in the future.
@@ -431,6 +431,7 @@ message ComputeRouteMatrixRequest {
   // traffic. This setting affects the value returned in the duration field in
   // the [RouteMatrixElement][google.maps.routing.v2.RouteMatrixElement] which
   // contains the predicted time in traffic based on historical averages.
+  // `TrafficModel` is only available for requests that have set
   // [RoutingPreference][google.maps.routing.v2.RoutingPreference] to
   // `TRAFFIC_AWARE_OPTIMAL` and
   // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode] to `DRIVE`.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/routing_preference.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/routing_preference.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/speed_reading_interval.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/speed_reading_interval.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -35,13 +35,13 @@ message SpeedReadingInterval {
     // Default value. This value is unused.
     SPEED_UNSPECIFIED = 0;
 
-    // Normal speed, no slowdown is detected.
+    // Normal speed, no traffic delays.
     NORMAL = 1;
 
-    // Slowdown detected, but no traffic jam formed.
+    // Slowdown detected, medium amount of traffic.
     SLOW = 2;
 
-    // Traffic jam detected.
+    // Traffic delays.
     TRAFFIC_JAM = 3;
   }
 
@@ -51,6 +51,7 @@ message SpeedReadingInterval {
   // The ending index of this interval in the polyline.
   optional int32 end_polyline_point_index = 2;
 
+  // The type of speed in this interval.
   oneof speed_type {
     // Traffic speed in this interval.
     Speed speed = 3;
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/toll_info.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/toll_info.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,7 +18,6 @@ package google.maps.routing.v2;
 
 import "google/type/money.proto";
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Routing.V2";
 option go_package = "cloud.google.com/go/maps/routing/apiv2/routingpb;routingpb";
 option java_multiple_files = true;
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/toll_passes.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/toll_passes.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/traffic_model.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/traffic_model.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -25,10 +25,14 @@ option objc_class_prefix = "GMRV2";
 option php_namespace = "Google\\Maps\\Routing\\V2";
 option ruby_package = "Google::Maps::Routing::V2";
 
-// Specifies the assumptions to use when calculating time in traffic. This
-// setting affects the value returned in the `duration` field in the
-// response, which contains the predicted time in traffic based on historical
-// averages.
+// This field specifies one of the following assumptions to use when calculating
+// travel time in traffic conditions, shown in the enums below. Depending on the
+// enum chosen, the `duration` field of the TrafficModel response will vary. The
+// value contains the predicted time to destination in traffic, based on
+// historical averages. `TrafficModel` is only available for requests that have
+// set [`RoutingPreference`][google.maps.routing.v2.RoutingPreference] to
+// `TRAFFIC_AWARE_OPTIMAL` and
+// [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode] to `DRIVE`.
 enum TrafficModel {
   // Unused. If specified, will default to `BEST_GUESS`.
   TRAFFIC_MODEL_UNSPECIFIED = 0;
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/transit.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/transit.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/transit_preferences.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/transit_preferences.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/units.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/units.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/vehicle_emission_type.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/vehicle_emission_type.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/vehicle_info.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/vehicle_info.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,7 +18,6 @@ package google.maps.routing.v2;
 
 import "google/maps/routing/v2/vehicle_emission_type.proto";
 
-option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Routing.V2";
 option go_package = "cloud.google.com/go/maps/routing/apiv2/routingpb;routingpb";
 option java_multiple_files = true;
diff --git a/packages/google-maps-routing/protos/google/maps/routing/v2/waypoint.proto b/packages/google-maps-routing/protos/google/maps/routing/v2/waypoint.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -42,6 +42,11 @@ message Waypoint {
     // Human readable address or a plus code.
     // See https://plus.codes for details.
     string address = 7;
+
+    // A token that identifies a
+    // [`NavigationPoint`](https://developers.google.com/maps/documentation/geocoding/reference/rest/v4alpha/geocode.destinations/searchDestinations#navigationpoint),
+    // obtained from the `SearchDestinations` method of the Geocoding API.
+    string navigation_point_token = 8;
   }
 
   // Marks this waypoint as a milestone rather a stopping point. For
diff --git a/packages/google-maps-routing/protos/protos.d.ts b/packages/google-maps-routing/protos/protos.d.ts
diff --git a/packages/google-maps-routing/protos/protos.js b/packages/google-maps-routing/protos/protos.js
diff --git a/packages/google-maps-routing/protos/protos.json b/packages/google-maps-routing/protos/protos.json
diff --git a/packages/google-maps-routing/samples/generated/v2/routes.compute_route_matrix.js b/packages/google-maps-routing/samples/generated/v2/routes.compute_route_matrix.js
diff --git a/packages/google-maps-routing/samples/generated/v2/routes.compute_routes.js b/packages/google-maps-routing/samples/generated/v2/routes.compute_routes.js
diff --git a/packages/google-maps-routing/samples/generated/v2/snippet_metadata_google.maps.routing.v2.json b/packages/google-maps-routing/samples/generated/v2/snippet_metadata_google.maps.routing.v2.json
diff --git a/packages/google-maps-routing/src/v2/routes_client.ts b/packages/google-maps-routing/src/v2/routes_client.ts

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-// Copyright 2025 Google LLC`
	`1`	`+// Copyright 2026 Google LLC`
`2`	`2`	`//`
`3`	`3`	`// Licensed under the Apache License, Version 2.0 (the "License");`
`4`	`4`	`// you may not use this file except in compliance with the License.`