feat: add ability to specify trip attributes to Trip and deprecate Trip.remaining_waypoints_version

Google APIs · copybara-github · commit 302273adb329 · 2025-07-09T13:26:02.000-07:00
PiperOrigin-RevId: 781185838
diff --git a/google/maps/fleetengine/delivery/v1/common.proto b/google/maps/fleetengine/delivery/v1/common.proto
@@ -144,6 +144,19 @@ message DeliveryVehicleLocation {
   // Accuracy of `raw_location` as a radius, in meters.
   google.protobuf.DoubleValue raw_location_accuracy = 25;
 
+  // The location from Android's Fused Location Provider.
+  google.type.LatLng flp_location = 29;
+
+  // Update timestamp of the `flp_location`
+  google.protobuf.Timestamp flp_update_time = 30;
+
+  // Accuracy of `flp_location` in meters as a radius.
+  google.protobuf.DoubleValue flp_latlng_accuracy_meters = 31;
+
+  // Direction the vehicle is moving in degrees, as determined by the Fused
+  // Location Provider. 0 represents North. The valid range is [0,360).
+  google.protobuf.Int32Value flp_heading_degrees = 32;
+
   // Supplemental location provided by the integrating app.
   google.type.LatLng supplemental_location = 18;
 
diff --git a/google/maps/fleetengine/v1/fleetengine.proto b/google/maps/fleetengine/v1/fleetengine.proto
@@ -282,6 +282,19 @@ message VehicleLocation {
   // Accuracy of `raw_location` as a radius, in meters.
   google.protobuf.DoubleValue raw_location_accuracy = 25;
 
+  // The location from Android's Fused Location Provider.
+  google.type.LatLng flp_location = 29;
+
+  // Update timestamp of `flp_location`.
+  google.protobuf.Timestamp flp_update_time = 30;
+
+  // Accuracy of `flp_location` in meters as a radius.
+  google.protobuf.DoubleValue flp_latlng_accuracy_meters = 31;
+
+  // Direction the vehicle is moving in degrees, as determined by the Fused
+  // Location Provider. 0 represents North. The valid range is [0,360).
+  google.protobuf.Int32Value flp_heading_degrees = 32;
+
   // Supplemental location provided by the integrating app.
   google.type.LatLng supplemental_location = 18;
 
@@ -335,3 +348,22 @@ enum LocationSensor {
   // The location provider on Apple operating systems.
   CORE_LOCATION = 200;
 }
+
+// Describes a trip attribute as a key-value pair. The "key:value" string length
+// cannot exceed 256 characters.
+message TripAttribute {
+  // The attribute's key. Keys may not contain the colon character (:).
+  string key = 1;
+
+  // The attribute's value, can be in string, bool, or double type.
+  oneof trip_attribute_value {
+    // String typed attribute value.
+    string string_value = 2;
+
+    // Boolean typed attribute value.
+    bool bool_value = 3;
+
+    // Double typed attribute value.
+    double number_value = 4;
+  }
+}
diff --git a/google/maps/fleetengine/v1/traffic.proto b/google/maps/fleetengine/v1/traffic.proto
@@ -34,13 +34,13 @@ message SpeedReadingInterval {
     // Default value. This value is unused.
     SPEED_UNSPECIFIED = 0;
 
-    // Normal speed, no slowdown is detected.
+    // Normal speed, no traffic delays.
     NORMAL = 1;
 
-    // Slowdown detected, but no traffic jam formed.
+    // Slowdown detected, medium amount of traffic.
     SLOW = 2;
 
-    // Traffic jam detected.
+    // Traffic delays.
     TRAFFIC_JAM = 3;
   }
 
diff --git a/google/maps/fleetengine/v1/trip_api.proto b/google/maps/fleetengine/v1/trip_api.proto
@@ -222,11 +222,11 @@ message GetTripRequest {
   // If a minimum is unspecified, the route data are always retrieved.
   google.protobuf.Timestamp current_route_segment_version = 6;
 
-  // Indicates the minimum timestamp (exclusive) for which
-  // `Trip.remaining_waypoints` are retrieved. If they are unchanged since this
-  // timestamp, the `remaining_waypoints` are not set in the response. If this
-  // field is unspecified, `remaining_waypoints` is always retrieved.
-  google.protobuf.Timestamp remaining_waypoints_version = 7;
+  // Deprecated: `Trip.remaining_waypoints` are always retrieved. Use
+  // `remaining_waypoints_route_version` to control when
+  // `Trip.remaining_waypoints.traffic_to_waypoint` and
+  // `Trip.remaining_waypoints.path_to_waypoint` data are retrieved.
+  google.protobuf.Timestamp remaining_waypoints_version = 7 [deprecated = true];
 
   // The returned current route format, `LAT_LNG_LIST_TYPE` (in `Trip.route`),
   // or `ENCODED_POLYLINE_TYPE` (in `Trip.current_route_segment`). The default
diff --git a/google/maps/fleetengine/v1/trips.proto b/google/maps/fleetengine/v1/trips.proto
@@ -224,6 +224,9 @@ message Trip {
   // The subset of Trip fields that are populated and how they should be
   // interpreted.
   TripView view = 31;
+
+  // A list of custom Trip attributes. Each attribute must have a unique key.
+  repeated TripAttribute attributes = 35;
 }
 
 // The actual location where a stop (pickup/dropoff) happened.

Original file line number	Diff line number	Diff line change
`@@ -224,6 +224,9 @@ message Trip {`
`224`	`224`	`// The subset of Trip fields that are populated and how they should be`
`225`	`225`	`// interpreted.`
`226`	`226`	`TripView view = 31;`
	`227`	`+`
	`228`	`+ // A list of custom Trip attributes. Each attribute must have a unique key.`
	`229`	`+ repeated TripAttribute attributes = 35;`
`227`	`230`	`}`
`228`	`231`
`229`	`232`	`// The actual location where a stop (pickup/dropoff) happened.`