@googlemaps/routing 2.2.1 → 3.1.0

package/README.md

@@ -79,7 +79,6 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
 | --------------------------- | --------------------------------- |
 | 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) |
 
 
 ## Supported Node.js Versions
@@ -113,7 +112,7 @@ More Information: [Google Cloud Platform Launch Stages][launch_stages]
 
 ## Contributing
 
-Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/CONTRIBUTING.md).
+Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/google-cloud-node/blob/main/CONTRIBUTING.md).
 
 Please note that this `README.md`
 and a variety of configuration files in this repository (including `.nycrc` and `tsconfig.json`)
@@ -123,7 +122,7 @@ are generated from a central template.
 
 Apache Version 2.0
 
-See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/LICENSE)
+See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/LICENSE)
 
 [shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
 [projects]: https://console.cloud.google.com/project

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

@@ -54,6 +54,33 @@ message PolylineDetails {
     DOES_NOT_EXIST = 2;
   }
 
+  // Encapsulates information about tunnels along the polyline.
+  message TunnelInfo {
+    // Denotes whether a tunnel exists for a given stretch of the polyline.
+    RoadFeatureState tunnel_presence = 1;
+
+    // The location of tunnel related information along the polyline.
+    PolylinePointIndex polyline_point_index = 2;
+  }
+
+  // Encapsulates information about bridges along the polyline.
+  message BridgeInfo {
+    // Denotes whether a bridge exists for a given stretch of the polyline.
+    RoadFeatureState bridge_presence = 1;
+
+    // The location of bridge related information along the polyline.
+    PolylinePointIndex polyline_point_index = 2;
+  }
+
+  // Encapsulates information about skyways along the polyline.
+  message SkywayInfo {
+    // Denotes whether a skyway exists for a given stretch of the polyline.
+    RoadFeatureState skyway_presence = 1;
+
+    // The location of skyway related information along the polyline.
+    PolylinePointIndex polyline_point_index = 2;
+  }
+
   // Encapsulates information about flyovers along the polyline.
   message FlyoverInfo {
     // Output only. Denotes whether a flyover exists for a given stretch of the
@@ -76,9 +103,21 @@ message PolylineDetails {
     PolylinePointIndex polyline_point_index = 2;
   }
 
+  // Tunnel details along the polyline. This field is populated if the request
+  // specifies the `avoid_tunnels` route modifier and the resultant route fails
+  // to avoid them, OR if `TUNNEL_INFO_ON_POLYLINE` is specified in
+  // `extra_computations` and the route contains tunnels.
+  repeated TunnelInfo tunnel_info = 8;
+
   // Flyover details along the polyline.
   repeated FlyoverInfo flyover_info = 12;
 
   // Narrow road details along the polyline.
   repeated NarrowRoadInfo narrow_road_info = 13;
+
+  // Bridge details along the polyline.
+  repeated BridgeInfo bridge_info = 14;
+
+  // Skyway details along the polyline.
+  repeated SkywayInfo skyway_info = 15;
 }

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

@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.maps.routing.v2;
 
+import "google/api/field_behavior.proto";
 import "google/maps/routing/v2/toll_passes.proto";
 import "google/maps/routing/v2/vehicle_info.proto";
 
@@ -61,4 +62,13 @@ message RouteModifiers {
   // Applies only to the `DRIVE` and `TWO_WHEELER`
   // [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
   repeated TollPass toll_passes = 6;
+
+  // Optional. When set to true, avoids tunnels where reasonable, giving
+  // preference to routes not containing tunnels. Applies only to the `DRIVE`
+  // and `TWO_WHEELER`
+  // [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
+  // [`RoutingPreference`][google.maps.routing.v2.RoutingPreference]
+  // must be set to `TRAFFIC_AWARE_OPTIMAL`.
+  // This field is not supported in ComputeRouteMatrix.
+  bool avoid_tunnels = 7 [(google.api.field_behavior) = OPTIONAL];
 }

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

@@ -162,6 +162,7 @@ message ComputeRoutesRequest {
   }
 
   // Extra computations to perform while completing the request.
+  // Additional values may be added in the future.
   enum ExtraComputation {
     // Not used. Requests containing this value will fail.
     EXTRA_COMPUTATION_UNSPECIFIED = 0;
@@ -175,7 +176,7 @@ message ComputeRoutesRequest {
     // Traffic aware polylines for the route(s).
     TRAFFIC_ON_POLYLINE = 3;
 
-    // [`NavigationInstructions`](google.maps.routing.v2.NavigationInstructions.instructions)
+    // [`NavigationInstruction`][google.maps.routing.v2.NavigationInstruction]
     // presented as a formatted HTML text string. This content
     // is meant to be read as-is. This content is for display only.
     // Do not programmatically parse it.
@@ -183,17 +184,32 @@ message ComputeRoutesRequest {
 
     // Flyover information for the route(s). The
     // `routes.polyline_details.flyover_info` fieldmask must be specified to
-    // return this information. This data will only currently be populated for
+    // return this information. This data will currently only be populated for
     // certain metros in India. This feature is experimental, and the
     // SKU/charge is subject to change.
     FLYOVER_INFO_ON_POLYLINE = 7;
 
     // Narrow road information for the route(s). The
     // `routes.polyline_details.narrow_road_info` fieldmask must be specified
-    // to return this information. This data will only currently be populated
+    // to return this information. This data will currently only be populated
     // for certain metros in India. This feature is experimental, and the
     // SKU/charge is subject to change.
     NARROW_ROAD_INFO_ON_POLYLINE = 8;
+
+    // Tunnel information for the route(s). The
+    // `routes.polyline_details.tunnel_info` fieldmask must be specified to
+    // return this information.
+    TUNNEL_INFO_ON_POLYLINE = 9;
+
+    // Bridge information for the route(s). The
+    // `routes.polyline_details.bridge_info` fieldmask must be specified to
+    // return this information.
+    BRIDGE_INFO_ON_POLYLINE = 10;
+
+    // Skyway information for the route(s). The
+    // `routes.polyline_details.skyway_info` fieldmask must be specified to
+    // return this information.
+    SKYWAY_INFO_ON_POLYLINE = 11;
   }
 
   // Required. Origin waypoint.
@@ -277,9 +293,9 @@ message ComputeRoutesRequest {
   // Optional. If set to true, the service attempts to minimize the overall cost
   // of the route by re-ordering the specified intermediate waypoints. The
   // request fails if any of the intermediate waypoints is a `via` waypoint. Use
-  // `ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index` to
+  // `ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index` to
   // find the new ordering.
-  // If `ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index` is
+  // If `ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index` is
   // not requested in the `X-Goog-FieldMask` header, the request fails.
   // If `optimize_waypoint_order` is set to false,
   // `ComputeRoutesResponse.optimized_intermediate_waypoint_index` will be

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

@@ -225,6 +225,9 @@ enum TollPass {
   // MI, USA.
   US_MI_BCPASS = 94;
 
+  // MI, USA.
+  US_MI_BREAKAWAY = 101;
+
   // MI, USA.
   US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG = 37;
 

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

@@ -44,7 +44,7 @@ message Waypoint {
     string address = 7;
 
     // A token that identifies a
-    // [`NavigationPoint`](https://developers.google.com/maps/documentation/geocoding/reference/rest/v4alpha/geocode.destinations/searchDestinations#navigationpoint),
+    // [`NavigationPoint`](/maps/documentation/geocoding/reference/rest/v4alpha/geocode.destinations/searchDestinations#navigationpoint),
     // obtained from the `SearchDestinations` method of the Geocoding API.
     string navigation_point_token = 8;
   }