@googlemaps/routing 2.1.0 → 2.2.0

package/README.md

@@ -1,24 +1,24 @@
 [//]: # "This README.md file is auto-generated, all changes to this file will be lost."
-[//]: # "To regenerate it, use `python -m synthtool`."
+[//]: # "The comments you see below are used to generate those parts of the template in later states."
 <img src="https://avatars2.githubusercontent.com/u/2810941?v=3&s=96" alt="Google Cloud Platform logo" title="Google Cloud Platform" align="right" height="96" width="96"/>
 
-# [Google Maps Routing: Node.js Client](https://github.com/googleapis/google-cloud-node/tree/main/packages/google-maps-routing)
-
-[![release level](https://img.shields.io/badge/release%20level-preview-yellow.svg?style=flat)](https://cloud.google.com/terms/launch-stages)
-[![npm version](https://img.shields.io/npm/v/@googlemaps/routing.svg)](https://www.npmjs.org/package/@googlemaps/routing)
-
+# [Routes API: Nodejs Client][homepage]
 
+This library is considered to be in **preview**. This means it is still a
+work-in-progress and under active development. Any release is subject to
+backwards-incompatible changes at any time.
 
+[![npm version](https://img.shields.io/npm/v/@googlemaps/routing.svg)](https://www.npmjs.org/package/@googlemaps/routing)
 
- client for Node.js
+Routes API client for Node.js
 
+[//]: # "partials.introduction"
 
 A comprehensive list of changes in each version may be found in
-[the CHANGELOG](https://github.com/googleapis/google-cloud-node/tree/main/packages/google-maps-routing/CHANGELOG.md).
+[the CHANGELOG][homepage_changelog].
 
-* [Google Maps Routing Node.js Client API Reference][client-docs]
+* [Routes API Nodejs Client API Reference](https://cloud.google.com/nodejs/docs/reference/routing/latest)
 
-* [github.com/googleapis/google-cloud-node/packages/google-maps-routing](https://github.com/googleapis/google-cloud-node/tree/main/packages/google-maps-routing)
 
 Read more about the client libraries for Cloud APIs, including the older
 Google APIs Client Libraries, in [Client Libraries Explained][explained].
@@ -27,149 +27,60 @@ Google APIs Client Libraries, in [Client Libraries Explained][explained].
 
 **Table of contents:**
 
-
 * [Quickstart](#quickstart)
   * [Before you begin](#before-you-begin)
   * [Installing the client library](#installing-the-client-library)
-  * [Using the client library](#using-the-client-library)
-* [Samples](#samples)
+
 * [Versioning](#versioning)
 * [Contributing](#contributing)
 * [License](#license)
 
 ## Quickstart
-
 ### Before you begin
 
 1.  [Select or create a Cloud Platform project][projects].
 1.  [Enable billing for your project][billing].
-1.  [Enable the Google Maps Routing API][enable_api].
+1.  [Enable the Routes API API][enable_api].
 1.  [Set up authentication][auth] so you can access the
     API from your local workstation.
-
 ### Installing the client library
 
 ```bash
 npm install @googlemaps/routing
 ```
 
+## Terms of Service
 
-### Using the client library
-
-```javascript
-/**
- * This snippet has been automatically generated and should be regarded as a code template only.
- * It will require modifications to work.
- * It may require correct/in-range values for request initialization.
- * TODO(developer): Uncomment these variables before running the sample.
- */
-/**
- *  Required. Origin waypoint.
- */
-// const origin = {}
-/**
- *  Required. Destination waypoint.
- */
-// const destination = {}
-/**
- *  Optional. A set of waypoints along the route (excluding terminal points),
- *  for either stopping at or passing by. Up to 25 intermediate waypoints are
- *  supported.
- */
-// const intermediates = 1234
-/**
- *  Optional. Specifies the mode of transportation.
- */
-// const travelMode = {}
-/**
- *  Optional. Specifies how to compute the route. The server
- *  attempts to use the selected routing preference to compute the route. If
- *   the routing preference results in an error or an extra long latency, then
- *  an error is returned. In the future, we might implement a fallback
- *  mechanism to use a different option when the preferred option does not give
- *  a valid result. You can specify this option only when the `travel_mode` is
- *  `DRIVE` or `TWO_WHEELER`, otherwise the request fails.
- */
-// const routingPreference = {}
-/**
- *  Optional. Specifies your preference for the quality of the polyline.
- */
-// const polylineQuality = {}
-/**
- *  Optional. Specifies the preferred encoding for the polyline.
- */
-// const polylineEncoding = {}
-/**
- *  Optional. The departure time. If you don't set this value, then this value
- *  defaults to the time that you made the request. If you set this value to a
- *  time that has already occurred, then the request fails.
- */
-// const departureTime = {}
-/**
- *  Optional. Specifies whether to calculate alternate routes in addition to the route.
- */
-// const computeAlternativeRoutes = true
-/**
- *  Optional. A set of conditions to satisfy that affect the way routes are
- *  calculated.
- */
-// const routeModifiers = {}
-/**
- *  Optional. The BCP-47 language code, such as "en-US" or "sr-Latn". For more
- *  information, see
- *  http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. See
- *  Language Support (https://developers.google.com/maps/faq#languagesupport)
- *  for the list of supported languages. When you don't provide this value, the
- *  display language is inferred from the location of the route request.
- */
-// const languageCode = 'abc123'
-/**
- *  Optional. Specifies the units of measure for the display fields. This
- *  includes the `instruction` field in `NavigationInstruction`. The units of
- *  measure used for the route, leg, step distance, and duration are not
- *  affected by this value. If you don't provide this value, then the display
- *  units are inferred from the location of the request.
- */
-// const units = {}
-
-// Imports the Routing library
-const {RoutesClient} = require('@googlemaps/routing').v2;
-
-// Instantiates a client
-const routingClient = new RoutesClient();
-
-async function callComputeRoutes() {
-  // Construct request
-  const request = {
-    origin,
-    destination,
-  };
-
-  // Run request
-  const response = await routingClient.computeRoutes(request);
-  console.log(response);
-}
-
-callComputeRoutes();
-
-```
+`@googlemaps/routing` uses Google Maps Platform services. Use of Google
+Maps Platform services through this library is subject to the
+[Google Maps Platform Terms of Service][gmp-tos].
 
+This library is not a Google Maps Platform Core Service.
+Therefore, the Google Maps Platform Terms of Service (e.g., Technical
+Support Services, Service Level Agreements, and Deprecation Policy)
+do not apply to this library.
 
+### European Economic Area (EEA) developers
 
-## Samples
+If your billing address is in the European Economic Area, effective on
+8 July 2025, the [Google Maps Platform EEA Terms of Service][gmp-tos-eea]
+will apply to your use of the Services. Functionality varies by region.
+[Learn more][gmp-tos-eea-faq].
 
-Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/tree/main/packages/google-maps-routing/samples) directory. Each sample's `README.md` has instructions for running its sample.
+[gmp-tos]: https://cloud.google.com/maps-platform/terms
+[gmp-tos-eea]: https://cloud.google.com/terms/maps-platform/eea
+[gmp-tos-eea-faq]: https://developers.google.com/maps/comms/eea/faq
 
-| Sample                      | Source Code                       | Try it |
-| --------------------------- | --------------------------------- | ------ |
-| Routes.compute_route_matrix | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/generated/v2/routes.compute_route_matrix.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-routing/samples/generated/v2/routes.compute_route_matrix.js,packages/google-maps-routing/samples/README.md) |
-| Routes.compute_routes | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/generated/v2/routes.compute_routes.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-routing/samples/generated/v2/routes.compute_routes.js,packages/google-maps-routing/samples/README.md) |
-| Quickstart | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/quickstart.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-routing/samples/quickstart.js,packages/google-maps-routing/samples/README.md) |
+## Samples
 
+Samples are in the [`samples/`][homepage_samples] directory. Each sample's `README.md` has instructions for running its sample.
 
+| Sample                      | Source Code                       |
+| --------------------------- | --------------------------------- |
+| compute route matrix | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/generated/v2/routes.compute_route_matrix.js) |
+| compute routes | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/generated/v2/routes.compute_routes.js) |
+| maps | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/generated/v2/snippet_metadata_google.maps.routing.v2.json) |
 
-The [Google Maps Routing Node.js Client API Reference][client-docs] documentation
-also contains samples.
 
 ## Supported Node.js Versions
 
@@ -196,41 +107,29 @@ for versions compatible with Node.js 8.
 
 This library follows [Semantic Versioning](http://semver.org/).
 
-
-
-
-
-
-
-This library is considered to be in **preview**. This means it is still a
-work-in-progress and under active development. Any release is subject to
-backwards-incompatible changes at any time.
-
-
 More Information: [Google Cloud Platform Launch Stages][launch_stages]
 
 [launch_stages]: https://cloud.google.com/terms/launch-stages
 
 ## Contributing
 
-Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/google-cloud-node/blob/main/CONTRIBUTING.md).
+Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/CONTRIBUTING.md).
 
-Please note that this `README.md`, the `samples/README.md`,
+Please note that this `README.md`
 and a variety of configuration files in this repository (including `.nycrc` and `tsconfig.json`)
-are generated from a central template. To edit one of these files, make an edit
-to its templates in
-[directory](https://github.com/googleapis/synthtool).
+are generated from a central template.
 
 ## License
 
 Apache Version 2.0
 
-See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/LICENSE)
-
-[client-docs]: https://cloud.google.com/nodejs/docs/reference/routing/latest
+See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/LICENSE)
 
 [shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
 [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=routes.googleapis.com
 [auth]: https://cloud.google.com/docs/authentication/external/set-up-adc-local
+[homepage_samples]: https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples
+[homepage_changelog]: https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/CHANGELOG.md
+[homepage]: https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing

package/build/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.

package/build/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.

package/build/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.

package/build/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.

package/build/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.

package/build/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.

package/build/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.

package/build/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.

package/build/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.

package/build/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.

package/build/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.

package/build/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.

package/build/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`.

package/build/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.

package/build/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;

package/build/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;

package/build/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.

package/build/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;

package/build/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.

package/build/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.

package/build/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.

package/build/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.

package/build/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;

package/build/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

package/build/protos/protos.d.ts

@@ -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.
@@ -11267,6 +11267,9 @@ export namespace google {
                     /** Waypoint address */
                     address?: (string|null);
 
+                    /** Waypoint navigationPointToken */
+                    navigationPointToken?: (string|null);
+
                     /** Waypoint via */
                     via?: (boolean|null);
 
@@ -11295,6 +11298,9 @@ export namespace google {
                     /** Waypoint address. */
                     public address?: (string|null);
 
+                    /** Waypoint navigationPointToken. */
+                    public navigationPointToken?: (string|null);
+
                     /** Waypoint via. */
                     public via: boolean;
 
@@ -11305,7 +11311,7 @@ export namespace google {
                     public sideOfRoad: boolean;
 
                     /** Waypoint locationType. */
-                    public locationType?: ("location"|"placeId"|"address");
+                    public locationType?: ("location"|"placeId"|"address"|"navigationPointToken");
 
                     /**
                      * Creates a new Waypoint instance using the specified properties.

package/build/protos/protos.js

@@ -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.
@@ -31376,6 +31376,7 @@
                          * @property {google.maps.routing.v2.ILocation|null} [location] Waypoint location
                          * @property {string|null} [placeId] Waypoint placeId
                          * @property {string|null} [address] Waypoint address
+                         * @property {string|null} [navigationPointToken] Waypoint navigationPointToken
                          * @property {boolean|null} [via] Waypoint via
                          * @property {boolean|null} [vehicleStopover] Waypoint vehicleStopover
                          * @property {boolean|null} [sideOfRoad] Waypoint sideOfRoad
@@ -31420,6 +31421,14 @@
                          */
                         Waypoint.prototype.address = null;
     
+                        /**
+                         * Waypoint navigationPointToken.
+                         * @member {string|null|undefined} navigationPointToken
+                         * @memberof google.maps.routing.v2.Waypoint
+                         * @instance
+                         */
+                        Waypoint.prototype.navigationPointToken = null;
+    
                         /**
                          * Waypoint via.
                          * @member {boolean} via
@@ -31449,12 +31458,12 @@
     
                         /**
                          * Waypoint locationType.
-                         * @member {"location"|"placeId"|"address"|undefined} locationType
+                         * @member {"location"|"placeId"|"address"|"navigationPointToken"|undefined} locationType
                          * @memberof google.maps.routing.v2.Waypoint
                          * @instance
                          */
                         Object.defineProperty(Waypoint.prototype, "locationType", {
-                            get: $util.oneOfGetter($oneOfFields = ["location", "placeId", "address"]),
+                            get: $util.oneOfGetter($oneOfFields = ["location", "placeId", "address", "navigationPointToken"]),
                             set: $util.oneOfSetter($oneOfFields)
                         });
     
@@ -31494,6 +31503,8 @@
                                 writer.uint32(/* id 5, wireType 0 =*/40).bool(message.sideOfRoad);
                             if (message.address != null && Object.hasOwnProperty.call(message, "address"))
                                 writer.uint32(/* id 7, wireType 2 =*/58).string(message.address);
+                            if (message.navigationPointToken != null && Object.hasOwnProperty.call(message, "navigationPointToken"))
+                                writer.uint32(/* id 8, wireType 2 =*/66).string(message.navigationPointToken);
                             return writer;
                         };
     
@@ -31542,6 +31553,10 @@
                                         message.address = reader.string();
                                         break;
                                     }
+                                case 8: {
+                                        message.navigationPointToken = reader.string();
+                                        break;
+                                    }
                                 case 3: {
                                         message.via = reader.bool();
                                         break;
@@ -31612,6 +31627,13 @@
                                 if (!$util.isString(message.address))
                                     return "address: string expected";
                             }
+                            if (message.navigationPointToken != null && message.hasOwnProperty("navigationPointToken")) {
+                                if (properties.locationType === 1)
+                                    return "locationType: multiple values";
+                                properties.locationType = 1;
+                                if (!$util.isString(message.navigationPointToken))
+                                    return "navigationPointToken: string expected";
+                            }
                             if (message.via != null && message.hasOwnProperty("via"))
                                 if (typeof message.via !== "boolean")
                                     return "via: boolean expected";
@@ -31645,6 +31667,8 @@
                                 message.placeId = String(object.placeId);
                             if (object.address != null)
                                 message.address = String(object.address);
+                            if (object.navigationPointToken != null)
+                                message.navigationPointToken = String(object.navigationPointToken);
                             if (object.via != null)
                                 message.via = Boolean(object.via);
                             if (object.vehicleStopover != null)
@@ -31693,6 +31717,11 @@
                                 if (options.oneofs)
                                     object.locationType = "address";
                             }
+                            if (message.navigationPointToken != null && message.hasOwnProperty("navigationPointToken")) {
+                                object.navigationPointToken = message.navigationPointToken;
+                                if (options.oneofs)
+                                    object.locationType = "navigationPointToken";
+                            }
                             return object;
                         };
     

package/build/protos/protos.json

@@ -1578,8 +1578,7 @@
                     "java_package": "com.google.maps.routing.v2",
                     "objc_class_prefix": "GMRV2",
                     "php_namespace": "Google\\Maps\\Routing\\V2",
-                    "ruby_package": "Google::Maps::Routing::V2",
-                    "cc_enable_arenas": true
+                    "ruby_package": "Google::Maps::Routing::V2"
                   },
                   "nested": {
                     "FallbackInfo": {
@@ -3045,7 +3044,8 @@
                           "oneof": [
                             "location",
                             "placeId",
-                            "address"
+                            "address",
+                            "navigationPointToken"
                           ]
                         }
                       },
@@ -3062,6 +3062,10 @@
                           "type": "string",
                           "id": 7
                         },
+                        "navigationPointToken": {
+                          "type": "string",
+                          "id": 8
+                        },
                         "via": {
                           "type": "bool",
                           "id": 3

package/build/src/v2/index.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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.

package/build/src/v2/routes_client.d.ts

@@ -179,8 +179,8 @@ export declare class RoutesClient {
      *   days in the future.
      * @param {google.protobuf.Timestamp} [request.arrivalTime]
      *   Optional. The arrival time.
-     *   NOTE: Can only be set when
-     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
+     *   NOTE: This field is ignored when requests specify a
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|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.
@@ -368,6 +368,7 @@ export declare class RoutesClient {
      *   traffic. This setting affects the value returned in the duration field in
      *   the {@link protos.google.maps.routing.v2.RouteMatrixElement|RouteMatrixElement} which
      *   contains the predicted time in traffic based on historical averages.
+     *   `TrafficModel` is only available for requests that have set
      *   {@link protos.google.maps.routing.v2.RoutingPreference|RoutingPreference} to
      *   `TRAFFIC_AWARE_OPTIMAL` and
      *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} to `DRIVE`.

package/build/src/v2/routes_client.js

@@ -1,5 +1,5 @@
 "use strict";
-// 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.
@@ -409,6 +409,7 @@ class RoutesClient {
      *   traffic. This setting affects the value returned in the duration field in
      *   the {@link protos.google.maps.routing.v2.RouteMatrixElement|RouteMatrixElement} which
      *   contains the predicted time in traffic based on historical averages.
+     *   `TrafficModel` is only available for requests that have set
      *   {@link protos.google.maps.routing.v2.RoutingPreference|RoutingPreference} to
      *   `TRAFFIC_AWARE_OPTIMAL` and
      *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} to `DRIVE`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@googlemaps/routing",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": " client for Node.js",
   "repository": {
     "type": "git",