feat: Add ExtraComputations feature to ComputeRoutes and ComputeRouteMatrix (#3868)

* feat: Add ExtraComputations feature to ComputeRoutes and ComputeRouteMatrix

PiperOrigin-RevId: 503020999

Source-Link: googleapis/googleapis@23dc63c

Source-Link: googleapis/googleapis-gen@c096dac
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLW1hcHMtcm91dGluZy8uT3dsQm90LnlhbWwiLCJoIjoiYzA5NmRhYzEyM2JjNTkwMWQ4MjBiYTc4MTFmNDQ3MWFmZWY5YWQxMyJ9

* 🦉 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: sofisl <[email protected]>

Author: gcf-owl-bot[bot]

packages/google-maps-routing/protos/google/maps/routing/v2/routes_service.proto

@@ -143,6 +143,21 @@ message ComputeRoutesRequest {
     FUEL_EFFICIENT = 1;
   }
 
+  // Extra computations to perform while completing the request.
+  enum ExtraComputation {
+    // Not used. Requests containing this value will fail.
+    EXTRA_COMPUTATION_UNSPECIFIED = 0;
+
+    // Toll information for the route(s).
+    TOLLS = 1;
+
+    // Estimated fuel consumption for the route(s).
+    FUEL_CONSUMPTION = 2;
+
+    // Traffic aware polylines for the route(s).
+    TRAFFIC_ON_POLYLINE = 3;
+  }
+
   // Required. Origin waypoint.
   Waypoint origin = 1 [(google.api.field_behavior) = REQUIRED];
 
@@ -208,6 +223,13 @@ message ComputeRoutesRequest {
   // parameters that would generate an optimal fuel efficient route.
   repeated ReferenceRoute requested_reference_routes = 14
       [(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
+  // returned in the response.
+  repeated ExtraComputation extra_computations = 15
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // ComputeRoutes the response message.
@@ -228,6 +250,15 @@ message ComputeRoutesResponse {
 
 // ComputeRouteMatrix request message
 message ComputeRouteMatrixRequest {
+  // Extra computations to perform while completing the request.
+  enum ExtraComputation {
+    // Not used. Requests containing this value will fail.
+    EXTRA_COMPUTATION_UNSPECIFIED = 0;
+
+    // Toll information for the matrix element(s).
+    TOLLS = 1;
+  }
+  
   // Required. Array of origins, which determines the rows of the response
   // matrix. Several size restrictions apply to the cardinality of origins and
   // destinations:
@@ -262,6 +293,13 @@ message ComputeRouteMatrixRequest {
   // has already occurred, the request fails.
   google.protobuf.Timestamp departure_time = 5
       [(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
+  // returned in the response.
+  repeated ExtraComputation extra_computations = 8
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // A single origin for ComputeRouteMatrixRequest