@googlemaps/fleetengine 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [0.6.0](https://github.com/googleapis/google-cloud-node/compare/fleetengine-v0.5.0...fleetengine-v0.6.0) (2025-03-18)
+
+
+### ⚠ BREAKING CHANGES
+
+* upgrade to Node 18 ([#6096](https://github.com/googleapis/google-cloud-node/issues/6096))
+
+### Features
+
+* [Many APIs] add request/response debug logging to gapics ([388b4e2](https://github.com/googleapis/google-cloud-node/commit/388b4e20329b7f6fc0dd061dddff573c45104213))
+
+
+### Miscellaneous Chores
+
+* Upgrade to Node 18 ([#6096](https://github.com/googleapis/google-cloud-node/issues/6096)) ([eadae64](https://github.com/googleapis/google-cloud-node/commit/eadae64d54e07aa2c65097ea52e65008d4e87436))
+
+## [0.5.0](https://github.com/googleapis/google-cloud-node/compare/fleetengine-v0.4.0...fleetengine-v0.5.0) (2025-02-28)
+
+
+### Features
+
+* [fleetengine] A new field `past_locations` is added to message `.maps.fleetengine.delivery.v1.DeliveryVehicle` ([#6063](https://github.com/googleapis/google-cloud-node/issues/6063)) ([71505cc](https://github.com/googleapis/google-cloud-node/commit/71505cc6cb7ed23aa78e0f091e53797e90ea5aa4))
+* A new field `past_locations` is added to message `.maps.fleetengine.v1.Vehicle` ([71505cc](https://github.com/googleapis/google-cloud-node/commit/71505cc6cb7ed23aa78e0f091e53797e90ea5aa4))
+
 ## [0.4.0](https://github.com/googleapis/google-cloud-node/compare/fleetengine-v0.3.0...fleetengine-v0.4.0) (2025-01-16)
 
 

package/README.md

@@ -44,7 +44,7 @@ Google APIs Client Libraries, in [Client Libraries Explained][explained].
 1.  [Select or create a Cloud Platform project][projects].
 1.  [Enable billing for your project][billing].
 1.  [Enable the Local Rides and Deliveries API API][enable_api].
-1.  [Set up authentication][auth] so you can access the
+1.  [Set up authentication with a service account][auth] so you can access the
     API from your local workstation.
 
 ### Installing the client library
@@ -235,11 +235,13 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 | Sample                      | Source Code                       | Try it |
 | --------------------------- | --------------------------------- | ------ |
 | Trip_service.create_trip | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine/samples/generated/v1/trip_service.create_trip.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-fleetengine/samples/generated/v1/trip_service.create_trip.js,packages/google-maps-fleetengine/samples/README.md) |
+| Trip_service.delete_trip | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine/samples/generated/v1/trip_service.delete_trip.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-fleetengine/samples/generated/v1/trip_service.delete_trip.js,packages/google-maps-fleetengine/samples/README.md) |
 | Trip_service.get_trip | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine/samples/generated/v1/trip_service.get_trip.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-fleetengine/samples/generated/v1/trip_service.get_trip.js,packages/google-maps-fleetengine/samples/README.md) |
 | Trip_service.report_billable_trip | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine/samples/generated/v1/trip_service.report_billable_trip.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-fleetengine/samples/generated/v1/trip_service.report_billable_trip.js,packages/google-maps-fleetengine/samples/README.md) |
 | Trip_service.search_trips | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine/samples/generated/v1/trip_service.search_trips.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-fleetengine/samples/generated/v1/trip_service.search_trips.js,packages/google-maps-fleetengine/samples/README.md) |
 | Trip_service.update_trip | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine/samples/generated/v1/trip_service.update_trip.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-fleetengine/samples/generated/v1/trip_service.update_trip.js,packages/google-maps-fleetengine/samples/README.md) |
 | Vehicle_service.create_vehicle | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine/samples/generated/v1/vehicle_service.create_vehicle.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-fleetengine/samples/generated/v1/vehicle_service.create_vehicle.js,packages/google-maps-fleetengine/samples/README.md) |
+| Vehicle_service.delete_vehicle | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine/samples/generated/v1/vehicle_service.delete_vehicle.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-fleetengine/samples/generated/v1/vehicle_service.delete_vehicle.js,packages/google-maps-fleetengine/samples/README.md) |
 | Vehicle_service.get_vehicle | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine/samples/generated/v1/vehicle_service.get_vehicle.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-fleetengine/samples/generated/v1/vehicle_service.get_vehicle.js,packages/google-maps-fleetengine/samples/README.md) |
 | Vehicle_service.list_vehicles | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine/samples/generated/v1/vehicle_service.list_vehicles.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-fleetengine/samples/generated/v1/vehicle_service.list_vehicles.js,packages/google-maps-fleetengine/samples/README.md) |
 | Vehicle_service.search_fuzzed_vehicles | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine/samples/generated/v1/vehicle_service.search_fuzzed_vehicles.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-fleetengine/samples/generated/v1/vehicle_service.search_fuzzed_vehicles.js,packages/google-maps-fleetengine/samples/README.md) |
@@ -316,4 +318,4 @@ See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/LICENSE)
 [projects]: https://console.cloud.google.com/project
 [billing]: https://support.google.com/cloud/answer/6293499#enable-billing
 [enable_api]: https://console.cloud.google.com/flows/enableapi?apiid=fleetengine.googleapis.com
-[auth]: https://cloud.google.com/docs/authentication/external/set-up-adc-local
+[auth]: https://cloud.google.com/docs/authentication/getting-started

package/build/protos/google/geo/type/viewport.proto

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/build/protos/google/maps/fleetengine/v1/fleetengine.proto

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,6 +17,7 @@ syntax = "proto3";
 package maps.fleetengine.v1;
 
 import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/maps/fleetengine/v1/traffic.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";

package/build/protos/google/maps/fleetengine/v1/header.proto

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/build/protos/google/maps/fleetengine/v1/traffic.proto

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/build/protos/google/maps/fleetengine/v1/trip_api.proto

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -71,6 +71,23 @@ service TripService {
     };
   }
 
+  // Deletes a single Trip.
+  //
+  // Returns FAILED_PRECONDITION if the Trip is active and assigned to a
+  // vehicle.
+  rpc DeleteTrip(DeleteTripRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=providers/*/trips/*}"
+    };
+    option (google.api.routing) = {
+      routing_parameters {
+        field: "name"
+        path_template: "{provider_id=providers/*}"
+      }
+    };
+    option (google.api.method_signature) = "name";
+  }
+
   // Report billable trip usage.
   rpc ReportBillableTrip(ReportBillableTripRequest)
       returns (google.protobuf.Empty) {
@@ -233,6 +250,23 @@ message GetTripRequest {
   google.protobuf.Timestamp remaining_waypoints_route_version = 10;
 }
 
+// DeleteTrip request message.
+message DeleteTripRequest {
+  // Optional. The standard Fleet Engine request header.
+  RequestHeader header = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Must be in the format `providers/{provider}/trips/{trip}`.
+  // The provider must be the Project ID (for example, `sample-cloud-project`)
+  // of the Google Cloud Project of which the service account making
+  // this call is a member.
+  string name = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "fleetengine.googleapis.com/Trip"
+    }
+  ];
+}
+
 // ReportBillableTrip request message.
 message ReportBillableTripRequest {
   // Selector for different solution types of a reported trip.

package/build/protos/google/maps/fleetengine/v1/trips.proto

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

package/build/protos/google/maps/fleetengine/v1/vehicle_api.proto

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -26,6 +26,7 @@ import "google/maps/fleetengine/v1/fleetengine.proto";
 import "google/maps/fleetengine/v1/header.proto";
 import "google/maps/fleetengine/v1/vehicles.proto";
 import "google/protobuf/duration.proto";
+import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
 import "google/protobuf/wrappers.proto";
@@ -100,6 +101,23 @@ service VehicleService {
     };
   }
 
+  // Deletes a Vehicle from the Fleet Engine.
+  //
+  // Returns FAILED_PRECONDITION if the Vehicle has active Trips.
+  // assigned to it.
+  rpc DeleteVehicle(DeleteVehicleRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=providers/*/vehicles/*}"
+    };
+    option (google.api.routing) = {
+      routing_parameters {
+        field: "name"
+        path_template: "{provider_id=providers/*}"
+      }
+    };
+    option (google.api.method_signature) = "name";
+  }
+
   // Writes updated vehicle data to the Fleet Engine.
   //
   // When updating a `Vehicle`, the following fields cannot be updated since
@@ -260,6 +278,24 @@ message GetVehicleRequest {
   google.protobuf.Timestamp waypoints_version = 5;
 }
 
+// DeleteVehicle request message.
+message DeleteVehicleRequest {
+  // Optional. The standard Fleet Engine request header.
+  RequestHeader header = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Must be in the format
+  // `providers/{provider}/vehicles/{vehicle}`.
+  // The {provider} must be the Project ID (for example, `sample-cloud-project`)
+  // of the Google Cloud Project of which the service account making
+  // this call is a member.
+  string name = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "fleetengine.googleapis.com/Vehicle"
+    }
+  ];
+}
+
 // `UpdateVehicle request message.
 message UpdateVehicleRequest {
   // The standard Fleet Engine request header.

package/build/protos/google/maps/fleetengine/v1/vehicles.proto

@@ -1,4 +1,4 @@
-// Copyright 2024 Google LLC
+// Copyright 2025 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -86,6 +86,14 @@ message Vehicle {
   // Last reported location of the vehicle.
   VehicleLocation last_location = 5;
 
+  // Input only. Locations where this vehicle has been in the past that haven't
+  // yet been reported to Fleet Engine. This is used in `UpdateVehicleRequest`
+  // to record locations which were previously unable to be sent to the server.
+  // Typically this happens when the vehicle does not have internet
+  // connectivity.
+  repeated VehicleLocation past_locations = 30
+      [(google.api.field_behavior) = INPUT_ONLY];
+
   // The total numbers of riders this vehicle can carry.  The driver is not
   // considered in this value. This value must be greater than or equal to one.
   int32 maximum_capacity = 6;