feat: Add ExtraComputations feature to ComputeRoutes and ComputeRouteMatrix

Google APIs · copybara-github · commit 23dc63cfbe99 · 2023-01-18T17:22:52.000-08:00
PiperOrigin-RevId: 503020999
diff --git a/google/maps/routing/v2/routes_service.proto b/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
