@googlemaps/routing 0.3.1 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.5.0](https://github.com/googleapis/google-cloud-node/compare/routing-v0.4.0...routing-v0.5.0) (2023-03-28)
+
+
+### Features
+
+* [routing] adds support for specifying region_code in the ComputeRoutesRequest ([#4103](https://github.com/googleapis/google-cloud-node/issues/4103)) ([1106a82](https://github.com/googleapis/google-cloud-node/commit/1106a824dbddc7296f069a0a3e063b0ec9fc914f))
+* [routing] moved speed in SpeedReadingInterval into a oneof speed_type, this is a breaking change for Go client libraries ([#4121](https://github.com/googleapis/google-cloud-node/issues/4121)) ([9878d72](https://github.com/googleapis/google-cloud-node/commit/9878d722f634f356590014ea8f2f035bb1b134db))
+
+## [0.4.0](https://github.com/googleapis/google-cloud-node/compare/routing-v0.3.1...routing-v0.4.0) (2023-03-13)
+
+
+### Features
+
+* [routing] added support for specifying waypoints as addresses ([#4065](https://github.com/googleapis/google-cloud-node/issues/4065)) ([e325ac5](https://github.com/googleapis/google-cloud-node/commit/e325ac51cf2550cc9d9dba6a8145d4affe766930))
+
 ## [0.3.1](https://github.com/googleapis/google-cloud-node/compare/routing-v0.3.0...routing-v0.3.1) (2023-02-15)
 
 

package/README.md

@@ -4,7 +4,7 @@
 
 # [Google Maps Routing: Node.js Client](https://github.com/googleapis/google-cloud-node)
 
-[![release level](https://img.shields.io/badge/release%20level-beta-yellow.svg?style=flat)](https://cloud.google.com/terms/launch-stages)
+[![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)
 
 
@@ -200,13 +200,12 @@ This library follows [Semantic Versioning](http://semver.org/).
 
 
 
-This library is considered to be in **beta**. This means it is expected to be
-mostly stable while we work toward a general availability release; however,
-complete stability is not guaranteed. We will address issues and requests
-against beta libraries with a high priority.
 
 
 
+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]

package/build/protos/google/maps/routing/v2/fallback_info.proto

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -62,11 +62,12 @@ enum FallbackRoutingMode {
   // Not used.
   FALLBACK_ROUTING_MODE_UNSPECIFIED = 0;
 
-  // Indicates the "TRAFFIC_UNAWARE" routing mode was used to compute the
-  // response.
+  // Indicates the `TRAFFIC_UNAWARE` [google.maps.routing.v2.RoutingPreference]
+  // was used to compute the response.
   FALLBACK_TRAFFIC_UNAWARE = 1;
 
-  // Indicates the "TRAFFIC_AWARE" routing mode was used to compute the
-  // response.
+  // Indicates the `TRAFFIC_AWARE`
+  // [RoutingPreference][google.maps.routing.v2.RoutingPreference] was used to
+  // compute the response.
   FALLBACK_TRAFFIC_AWARE = 2;
 }

package/build/protos/google/maps/routing/v2/geocoding_results.proto

@@ -0,0 +1,72 @@
+// Copyright 2023 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.routing.v2;
+
+import "google/rpc/status.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Routing.V2";
+option go_package = "google.golang.org/genproto/googleapis/maps/routing/v2;routing";
+option java_multiple_files = true;
+option java_outer_classname = "GeocodingResultsProto";
+option java_package = "com.google.maps.routing.v2";
+option objc_class_prefix = "GMRV2";
+option php_namespace = "Google\\Maps\\Routing\\V2";
+option ruby_package = "Google::Maps::Routing::V2";
+
+// Contains [GeocodedWaypoints][google.maps.routing.v2.GeocodedWaypoint] for
+// origin, destination and intermediate waypoints. Only populated for address
+// waypoints.
+message GeocodingResults {
+  // Origin geocoded waypoint.
+  GeocodedWaypoint origin = 1;
+
+  // Destination geocoded waypoint.
+  GeocodedWaypoint destination = 2;
+
+  // A list of intermediate geocoded waypoints each containing an index field
+  // that corresponds to the zero-based position of the waypoint in the order
+  // they were specified in the request.
+  repeated GeocodedWaypoint intermediates = 3;
+}
+
+// Details about the locations used as waypoints. Only populated for address
+// waypoints. Includes details about the geocoding results for the purposes of
+// determining what the address was geocoded to.
+message GeocodedWaypoint {
+  // Indicates the status code resulting from the geocoding operation.
+  google.rpc.Status geocoder_status = 1;
+
+  // The index of the corresponding intermediate waypoint in the request.
+  // Only populated if the corresponding waypoint is an intermediate
+  // waypoint.
+  optional int32 intermediate_waypoint_request_index = 2;
+
+  // The type(s) of the result, in the form of zero or more type tags.
+  // Supported types:
+  // https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types
+  repeated string type = 3;
+
+  // Indicates that the geocoder did not return an exact match for the original
+  // request, though it was able to match part of the requested address. You may
+  // wish to examine the original request for misspellings and/or an incomplete
+  // address.
+  bool partial_match = 4;
+
+  // The place ID for this result.
+  string place_id = 5;
+}

package/build/protos/google/maps/routing/v2/location.proto

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -38,6 +38,7 @@ message Location {
   // This value is used to specify the side of the road to use for pickup and
   // drop-off. Heading values can be from 0 to 360, where 0 specifies a heading
   // of due North, 90 specifies a heading of due East, etc. You can use this
-  // field only for `DRIVE` and `TWO_WHEELER` travel modes.
+  // field only for `DRIVE` and `TWO_WHEELER`
+  // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
   google.protobuf.Int32Value heading = 2;
 }

package/build/protos/google/maps/routing/v2/maneuver.proto

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// Copyright 2023 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 2022 Google LLC
+// Copyright 2023 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 2022 Google LLC
+// Copyright 2023 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 2022 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -43,12 +43,12 @@ message Route {
   repeated RouteLabel route_labels = 13;
 
   // A collection of legs (path segments between waypoints) that make-up the
-  // route. Each leg corresponds to the trip between two non-`via` Waypoints.
-  // For example, a route with no intermediate waypoints has only one leg. A
-  // route that includes one non-`via` intermediate waypoint has two legs. A
-  // route that includes one `via` intermediate waypoint has one leg. The order
-  // of the legs matches the order of Waypoints from `origin` to `intermediates`
-  // to `destination`.
+  // route. Each leg corresponds to the trip between two non-`via`
+  // [Waypoints][google.maps.routing.v2.Waypoint]. For example, a route with no
+  // intermediate waypoints has only one leg. A route that includes one
+  // non-`via` intermediate waypoint has two legs. A route that includes one
+  // `via` intermediate waypoint has one leg. The order of the legs matches the
+  // order of Waypoints from `origin` to `intermediates` to `destination`.
   repeated RouteLeg legs = 1;
 
   // The travel distance of the route, in meters.
@@ -145,16 +145,7 @@ message RouteLegTravelAdvisory {
 // Encapsulates the additional information that the user should be informed
 // about, such as possible traffic zone restriction on a leg step.
 message RouteLegStepTravelAdvisory {
-  // 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 RouteLegStep without
-  // overlap. The start point of a specified interval is the same as the end
-  // point of the preceding interval.
-  //
-  // Example:
-  //
-  //     polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
-  //     speed_reading_intervals: [A,C), [C,D), [D,G).
+  // NOTE: This field is not currently populated.
   repeated SpeedReadingInterval speed_reading_intervals = 1;
 }
 
@@ -197,8 +188,9 @@ message RouteLeg {
   RouteLegTravelAdvisory travel_advisory = 8;
 }
 
-// Encapsulates a segment of a `RouteLeg`. A step corresponds to a single
-// navigation instruction. Route legs are made up of steps.
+// Encapsulates a segment of a [RouteLeg][google.maps.routing.v2.RouteLeg]. A
+// step corresponds to a single navigation instruction. Route legs are made up
+// of steps.
 message RouteLegStep {
   // The travel distance of this step, in meters. In some circumstances, this
   // field might not have a value.

package/build/protos/google/maps/routing/v2/route_label.proto

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -26,8 +26,8 @@ option objc_class_prefix = "GMRV2";
 option php_namespace = "Google\\Maps\\Routing\\V2";
 option ruby_package = "Google::Maps::Routing::V2";
 
-// Labels for the `Route` that are useful to identify specific properties
-// of the route to compare against others.
+// Labels for the [Route][google.maps.routing.v2.Route] that are useful to
+// identify specific properties of the route to compare against others.
 enum RouteLabel {
   // Default - not used.
   ROUTE_LABEL_UNSPECIFIED = 0;
@@ -36,8 +36,9 @@ enum RouteLabel {
   DEFAULT_ROUTE = 1;
 
   // An alternative to the default "best" route. Routes like this will be
-  // returned when `ComputeRoutesRequest.compute_alternative_routes` is
-  // specified.
+  // returned when
+  // [compute_alternative_routes][google.maps.routing.v2.ComputeRoutesRequest.compute_alternative_routes]
+  // is specified.
   DEFAULT_ROUTE_ALTERNATE = 2;
 
   // Fuel efficient route. Routes labeled with this value are determined to be

package/build/protos/google/maps/routing/v2/route_modifiers.proto

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -34,22 +34,24 @@ option ruby_package = "Google::Maps::Routing::V2";
 message RouteModifiers {
   // Specifies whether to avoid toll roads where reasonable. Preference will be
   // given to routes not containing toll roads. Applies only to the `DRIVE` and
-  // `TWO_WHEELER` travel modes.
+  // `TWO_WHEELER` [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
   bool avoid_tolls = 1;
 
   // Specifies whether to avoid highways where reasonable. Preference will be
   // given to routes not containing highways. Applies only to the `DRIVE` and
-  // `TWO_WHEELER` travel modes.
+  // `TWO_WHEELER` [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
   bool avoid_highways = 2;
 
   // Specifies whether to avoid ferries where reasonable. Preference will be
   // given to routes not containing travel by ferries.
-  // Applies only to the `DRIVE` and`TWO_WHEELER` travel modes.
+  // Applies only to the `DRIVE` and`TWO_WHEELER`
+  // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
   bool avoid_ferries = 3;
 
   // Specifies whether to avoid navigating indoors where reasonable. Preference
   // will be given to routes not containing indoor navigation.
-  // Applies only to the `WALK` travel mode.
+  // Applies only to the `WALK`
+  // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
   bool avoid_indoor = 4;
 
   // Specifies the vehicle information.
@@ -59,6 +61,7 @@ message RouteModifiers {
   // If toll passes are provided, the API tries to return the pass price. If
   // toll passes are not provided, the API treats the toll pass as unknown and
   // tries to return the cash price.
-  // Applies only to the DRIVE and TWO_WHEELER travel modes.
+  // Applies only to the `DRIVE` and `TWO_WHEELER`
+  // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
   repeated TollPass toll_passes = 6;
 }

package/build/protos/google/maps/routing/v2/route_travel_mode.proto

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -27,8 +27,8 @@ option php_namespace = "Google\\Maps\\Routing\\V2";
 option ruby_package = "Google::Maps::Routing::V2";
 
 // A set of values used to specify the mode of travel.
-// NOTE: WALK, BICYCLE, and TWO_WHEELER routes are in beta and might sometimes
-// be missing clear sidewalks, pedestrian paths, or bicycling paths.
+// NOTE: `WALK`, `BICYCLE`, and `TWO_WHEELER` routes are in beta and might
+// sometimes be missing clear sidewalks, pedestrian paths, or bicycling paths.
 // You must display this warning to the user for all walking, bicycling, and
 // two-wheel routes that you display in your app.
 enum RouteTravelMode {

package/build/protos/google/maps/routing/v2/routes_service.proto

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -20,6 +20,7 @@ import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/maps/routing/v2/fallback_info.proto";
+import "google/maps/routing/v2/geocoding_results.proto";
 import "google/maps/routing/v2/polyline.proto";
 import "google/maps/routing/v2/route.proto";
 import "google/maps/routing/v2/route_modifiers.proto";
@@ -194,7 +195,8 @@ message ComputeRoutesRequest {
       [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Specifies whether to calculate alternate routes in addition to
-  // the route.
+  // the route. No alternative routes are returned for requests that have
+  // intermediate waypoints.
   bool compute_alternative_routes = 8 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. A set of conditions to satisfy that affect the way routes are
@@ -209,17 +211,23 @@ message ComputeRoutesRequest {
   // display language is inferred from the location of the route request.
   string language_code = 10 [(google.api.field_behavior) = OPTIONAL];
 
+  // Optional. The region code, specified as a ccTLD ("top-level domain")
+  // two-character value. For more information see
+  // https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
+  string region_code = 16 [(google.api.field_behavior) = OPTIONAL];
+
   // 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.
+  // includes the `instruction` field in
+  // [NavigationInstruction][google.maps.routing.v2.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.
   Units units = 11 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Specifies what reference routes to calculate as part of the
   // request in addition to the default route. A reference route is a route with
   // a different route calculation objective than the default route. For example
-  // an FUEL_EFFICIENT reference route calculation takes into account various
+  // a `FUEL_EFFICIENT` reference route calculation takes into account various
   // parameters that would generate an optimal fuel efficient route.
   repeated ReferenceRoute requested_reference_routes = 14
       [(google.api.field_behavior) = OPTIONAL];
@@ -246,6 +254,9 @@ message ComputeRoutesResponse {
   // computation. When fallback mode is used, this field contains detailed info
   // about the fallback response. Otherwise this field is unset.
   FallbackInfo fallback_info = 2;
+
+  // Contains geocoding response info for waypoints specified as addresses.
+  GeocodingResults geocoding_results = 3;
 }
 
 // ComputeRouteMatrix request message
@@ -294,6 +305,19 @@ message ComputeRouteMatrixRequest {
   google.protobuf.Timestamp departure_time = 5
       [(google.api.field_behavior) = OPTIONAL];
 
+  // 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 first origin.
+  string language_code = 6 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The region code, specified as a ccTLD ("top-level domain")
+  // two-character value. For more information see
+  // https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
+  string region_code = 9 [(google.api.field_behavior) = OPTIONAL];
+
   // Optional. A list of extra computations which may be used to complete the
   // request. Note: These extra computations may return extra fields on the
   // response. These extra fields must also be specified in the field mask to be
@@ -336,10 +360,11 @@ message RouteMatrixElement {
   int32 distance_meters = 4;
 
   // The length of time needed to navigate the route. If you set the
-  // `routing_preference` to `TRAFFIC_UNAWARE`, then this value is the same as
-  // `static_duration`. If you set the `routing_preference` to either
-  // `TRAFFIC_AWARE` or `TRAFFIC_AWARE_OPTIMAL`, then this value is calculated
-  // taking traffic conditions into account.
+  // [routing_preference][google.maps.routing.v2.ComputeRouteMatrixRequest.routing_preference]
+  // to `TRAFFIC_UNAWARE`, then this value is the same as `static_duration`. If
+  // you set the `routing_preference` to either `TRAFFIC_AWARE` or
+  // `TRAFFIC_AWARE_OPTIMAL`, then this value is calculated taking traffic
+  // conditions into account.
   google.protobuf.Duration duration = 5;
 
   // The duration of traveling through the route without taking traffic

package/build/protos/google/maps/routing/v2/routing_preference.proto

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// Copyright 2023 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,12 +35,13 @@ enum RoutingPreference {
   // 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 `RouteTravelMode` DRIVE and TWO_WHEELER choice of route and
-  // duration are based on road network and average time-independent traffic
-  // conditions. 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.
+  // Note: For [RouteTravelMode][google.maps.routing.v2.RouteTravelMode] `DRIVE`
+  // and `TWO_WHEELER` choice of route and duration are based on road network
+  // and average time-independent traffic conditions. 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.

package/build/protos/google/maps/routing/v2/speed_reading_interval.proto

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -52,6 +52,8 @@ message SpeedReadingInterval {
   // The ending index of this interval in the polyline.
   optional int32 end_polyline_point_index = 2;
 
-  // Traffic speed in this interval.
-  Speed speed = 3;
+  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 2022 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -28,13 +28,15 @@ option objc_class_prefix = "GMRV2";
 option php_namespace = "Google\\Maps\\Routing\\V2";
 option ruby_package = "Google::Maps::Routing::V2";
 
-// Encapsulates toll information on a `Route` or on a `RouteLeg`.
+// Encapsulates toll information on a [Route][google.maps.routing.v2.Route] or
+// on a [RouteLeg][google.maps.routing.v2.RouteLeg].
 message TollInfo {
-  // The monetary amount of tolls for the corresponding Route or RouteLeg.
-  // This list contains a money amount for each currency that is expected
-  // to be charged by the toll stations. Typically this list will contain only
-  // one item for routes with tolls in one currency. For international trips,
-  // this list may contain multiple items to reflect tolls in different
-  // currencies.
+  // The monetary amount of tolls for the corresponding
+  // [Route][google.maps.routing.v2.Route] or
+  // [RouteLeg][google.maps.routing.v2.RouteLeg]. This list contains a money
+  // amount for each currency that is expected to be charged by the toll
+  // stations. Typically this list will contain only one item for routes with
+  // tolls in one currency. For international trips, this list may contain
+  // multiple items to reflect tolls in different currencies.
   repeated google.type.Money estimated_price = 1;
 }

package/build/protos/google/maps/routing/v2/toll_passes.proto

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -211,6 +211,9 @@ enum TollPass {
   // MI, USA.
   US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD = 36;
 
+  // MI, USA.
+  US_MI_BCPASS = 94;
+
   // MI, USA.
   US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG = 37;
 

package/build/protos/google/maps/routing/v2/units.proto

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// Copyright 2023 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 2022 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -27,9 +27,10 @@ option php_namespace = "Google\\Maps\\Routing\\V2";
 option ruby_package = "Google::Maps::Routing::V2";
 
 // A set of values describing the vehicle's emission type.
-// Applies only to the DRIVE travel mode.
+// Applies only to the `DRIVE`
+// [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
 enum VehicleEmissionType {
-  // No emission type specified. Default to GASOLINE.
+  // No emission type specified. Default to `GASOLINE`.
   VEHICLE_EMISSION_TYPE_UNSPECIFIED = 0;
 
   // Gasoline/petrol fueled vehicle.

package/build/protos/google/maps/routing/v2/vehicle_info.proto

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -32,6 +32,6 @@ option ruby_package = "Google::Maps::Routing::V2";
 // character.
 message VehicleInfo {
   // Describes the vehicle's emission type.
-  // Applies only to the DRIVE travel mode.
+  // Applies only to the `DRIVE` travel mode.
   VehicleEmissionType emission_type = 2;
 }

package/build/protos/google/maps/routing/v2/waypoint.proto

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -39,26 +39,31 @@ message Waypoint {
 
     // The POI Place ID associated with the waypoint.
     string place_id = 2;
+
+    // Human readable address or a plus code.
+    // See https://plus.codes for details.
+    string address = 7;
   }
 
   // Marks this waypoint as a milestone rather a stopping point. For
   // each non-via waypoint in the request, the response appends an entry to the
-  // `legs` array to provide the details for stopovers on that leg of the
-  // trip. Set this value to true when you want the route to pass through this
-  // waypoint without stopping over. Via waypoints don't cause an entry to be
-  // added to the `legs` array, but they do route the journey through the
-  // waypoint. You can only set this value on waypoints that are intermediates.
-  // The request fails if you set this field on terminal waypoints.
-  // If `ComputeRoutesRequest.optimize_waypoint_order`
-  // is set to true then this field cannot be set to
-  // true; otherwise, the request fails.
+  // [legs][google.maps.routing.v2.Route.legs]
+  // array to provide the details for stopovers on that leg of the trip. Set
+  // this value to true when you want the route to pass through this waypoint
+  // without stopping over. Via waypoints don't cause an entry to be added to
+  // the `legs` array, but they do route the journey through the waypoint. You
+  // can only set this value on waypoints that are intermediates. The request
+  // fails if you set this field on terminal waypoints. If
+  // `ComputeRoutesRequest.optimize_waypoint_order` is set to true then this
+  // field cannot be set to true; otherwise, the request fails.
   bool via = 3;
 
   // Indicates that the waypoint is meant for vehicles to stop at, where the
   // intention is to either pickup or drop-off. When you set this value, the
   // calculated route won't include non-`via` waypoints on roads that are
   // unsuitable for pickup and drop-off. This option works only for `DRIVE` and
-  // `TWO_WHEELER` travel modes, and when the `location_type` is `location`.
+  // `TWO_WHEELER` travel modes, and when the `location_type` is
+  // [Location][google.maps.routing.v2.Location].
   bool vehicle_stopover = 4;
 
   // Indicates that the location of this waypoint is meant to have a preference
@@ -66,6 +71,6 @@ message Waypoint {
   // value, the route will pass through the location so that the vehicle can
   // stop at the side of road that the location is biased towards from the
   // center of the road. This option works only for 'DRIVE' and 'TWO_WHEELER'
-  // travel modes.
+  // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
   bool side_of_road = 5;
 }