feat: add new toll passes

Google APIs · copybara-github · commit 402c5bd1554d · 2022-08-25T09:22:26.000-07:00
feat!: add optional tags to proto3 index based fields to enable checking for field presence

BREAKING CHANGE: Adds field presence to fields with semantic meanings for their default values. In this case index fields with a value of 0 have specific meaning and their presence should be noted. This may break workflows where client libraries generated from this change handle data from previous client libraries (where presence is not noted). There are no users of the client libraries currently, so while this is a potential breaking change - there is nothing to break.

PiperOrigin-RevId: 470006887
diff --git a/google/maps/routing/v2/routes_service.proto b/google/maps/routing/v2/routes_service.proto
@@ -122,8 +122,7 @@ service Routes {
   // be automatically included in the response.
   // * Selecting only the fields that you need results in a smaller response
   // size, and thus higher network throughput.
-  rpc ComputeRouteMatrix(ComputeRouteMatrixRequest)
-      returns (stream RouteMatrixElement) {
+  rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (stream RouteMatrixElement) {
     option (google.api.http) = {
       post: "/distanceMatrix/v2:computeRouteMatrix"
       body: "*"
@@ -154,24 +153,20 @@ message ComputeRoutesRequest {
   // 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.
-  RoutingPreference routing_preference = 5
-      [(google.api.field_behavior) = OPTIONAL];
+  RoutingPreference routing_preference = 5 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Specifies your preference for the quality of the polyline.
   PolylineQuality polyline_quality = 6 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Specifies the preferred encoding for the polyline.
-  PolylineEncoding polyline_encoding = 12
-      [(google.api.field_behavior) = OPTIONAL];
+  PolylineEncoding polyline_encoding = 12 [(google.api.field_behavior) = OPTIONAL];
 
   // 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.
-  google.protobuf.Timestamp departure_time = 7
-      [(google.api.field_behavior) = OPTIONAL];
+  google.protobuf.Timestamp departure_time = 7 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. Specifies whether to calculate alternate routes in addition to
-  // the route.
+  // Optional. Specifies whether to calculate alternate routes in addition to the route.
   bool compute_alternative_routes = 8 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. A set of conditions to satisfy that affect the way routes are
@@ -212,8 +207,8 @@ message ComputeRoutesResponse {
 
 // ComputeRouteMatrix request message
 message ComputeRouteMatrixRequest {
-  // Required. Array of origins, which determines the rows of the response
-  // matrix. Several size restrictions apply to the cardinality of origins and
+  // Required. Array of origins, which determines the rows of the response matrix.
+  // Several size restrictions apply to the cardinality of origins and
   // destinations:
   //
   // * The number of elements (origins × destinations) must be no greater than
@@ -222,32 +217,27 @@ message ComputeRouteMatrixRequest {
   // 100 if routing_preference is set to `TRAFFIC_AWARE_OPTIMAL`.
   // * The number of waypoints (origins + destinations) specified as `place_id`
   // must be no greater than 50.
-  repeated RouteMatrixOrigin origins = 1
-      [(google.api.field_behavior) = REQUIRED];
+  repeated RouteMatrixOrigin origins = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. Array of destinations, which determines the columns of the
-  // response matrix.
-  repeated RouteMatrixDestination destinations = 2
-      [(google.api.field_behavior) = REQUIRED];
+  // Required. Array of destinations, which determines the columns of the response matrix.
+  repeated RouteMatrixDestination destinations = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. Specifies the mode of transportation.
   RouteTravelMode travel_mode = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // 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, 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.
-  RoutingPreference routing_preference = 4
-      [(google.api.field_behavior) = OPTIONAL];
-
-  // Optional. The departure time. If you don't set this value, this defaults to
-  // the time that you made the request. If you set this value to a time that
-  // has already occurred, the request fails.
-  google.protobuf.Timestamp departure_time = 5
-      [(google.api.field_behavior) = OPTIONAL];
+  // 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, 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.
+  RoutingPreference routing_preference = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The departure time. If you don't set this value, this defaults to the time
+  // that you made the request. If you set this value to a time that has already
+  // occurred, the request fails.
+  google.protobuf.Timestamp departure_time = 5 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // A single origin for ComputeRouteMatrixRequest
@@ -269,10 +259,10 @@ message RouteMatrixDestination {
 // ComputeRouteMatrix API. This proto can be streamed to the client.
 message RouteMatrixElement {
   // Zero-based index of the origin in the request.
-  int32 origin_index = 1;
+  optional int32 origin_index = 1;
 
   // Zero-based index of the destination in the request.
-  int32 destination_index = 2;
+  optional int32 destination_index = 2;
 
   // Error status code for this element.
   google.rpc.Status status = 3;
diff --git a/google/maps/routing/v2/routes_v2.yaml b/google/maps/routing/v2/routes_v2.yaml
@@ -1,7 +1,7 @@
 type: google.api.Service
 config_version: 3
 name: routes.googleapis.com
-title: routes.googleapis.com API
+title: Routes API
 
 apis:
 - name: google.maps.routing.v2.Routes
diff --git a/google/maps/routing/v2/speed_reading_interval.proto b/google/maps/routing/v2/speed_reading_interval.proto
@@ -47,12 +47,10 @@ message SpeedReadingInterval {
   }
 
   // The starting index of this interval in the polyline.
-  // In JSON, when the index is 0, the field appears to be unpopulated.
-  int32 start_polyline_point_index = 1;
+  optional int32 start_polyline_point_index = 1;
 
   // The ending index of this interval in the polyline.
-  // In JSON, when the index is 0, the field appears to be unpopulated.
-  int32 end_polyline_point_index = 2;
+  optional int32 end_polyline_point_index = 2;
 
   // Traffic speed in this interval.
   Speed speed = 3;
diff --git a/google/maps/routing/v2/toll_passes.proto b/google/maps/routing/v2/toll_passes.proto
@@ -96,12 +96,31 @@ enum TollPass {
   IN_LOCAL_HP_PLATE_EXEMPT = 79;
 
   // Mexico toll pass.
+  // https://iave.capufe.gob.mx/#/
+  MX_IAVE = 90;
+
+  // Mexico
+  // https://www.pase.com.mx
+  MX_PASE = 91;
+
+  // Mexico
+  //  https://operadoravial.com/quick-pass/
+  MX_QUICKPASS = 93;
+
+  // http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
+  MX_SISTEMA_TELEPEAJE_CHIHUAHUA = 89;
+
+  // Mexico
   MX_TAG_IAVE = 12;
 
   // Mexico toll pass company. One of many operating in Mexico City. See
   // additional details at https://www.televia.com.mx.
   MX_TAG_TELEVIA = 13;
 
+  // Mexico toll pass company. One of many operating in Mexico City.
+  // https://www.televia.com.mx
+  MX_TELEVIA = 92;
+
   // Mexico toll pass. See additional details at
   // https://www.viapass.com.mx/viapass/web_home.aspx.
   MX_VIAPASS = 14;
