@googlemaps/fleetengine-delivery 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.3.0](https://github.com/googleapis/google-cloud-node/compare/fleetengine-delivery-v0.2.0...fleetengine-delivery-v0.3.0) (2025-02-28)
+
+
+### Features
+
+* [fleetengine-delivery] A new field `past_locations` is added to message `.maps.fleetengine.delivery.v1.DeliveryVehicle` ([#6064](https://github.com/googleapis/google-cloud-node/issues/6064)) ([48190a2](https://github.com/googleapis/google-cloud-node/commit/48190a2219978f1ddf29776a40f069fc235e0476))
+* [fleetengine-delivery] Added Fleet Engine Delete APIs ([#6081](https://github.com/googleapis/google-cloud-node/issues/6081)) ([07a6a9a](https://github.com/googleapis/google-cloud-node/commit/07a6a9a97c625ab8aeeccd991e45d4c8ac6abf0f))
+* A new field `past_locations` is added to message `.maps.fleetengine.v1.Vehicle` ([48190a2](https://github.com/googleapis/google-cloud-node/commit/48190a2219978f1ddf29776a40f069fc235e0476))
+
+## [0.2.0](https://github.com/googleapis/google-cloud-node/compare/fleetengine-delivery-v0.1.0...fleetengine-delivery-v0.2.0) (2025-01-16)
+
+
+### Features
+
+* [fleetengine-delivery] Promote network_configs field to v2 API ([#5944](https://github.com/googleapis/google-cloud-node/issues/5944)) ([8577586](https://github.com/googleapis/google-cloud-node/commit/8577586e4ba05fd9099d4b580a31a30985b0611f))
+
 ## 0.1.0 (2024-06-03)
 
 

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 Last Mile Fleet Solution Delivery API API][enable_api].
-1.  [Set up authentication with a service account][auth] so you can access the
+1.  [Set up authentication][auth] so you can access the
     API from your local workstation.
 
 ### Installing the client library
@@ -146,6 +146,8 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 | Delivery_service.batch_create_tasks | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine-delivery/samples/generated/v1/delivery_service.batch_create_tasks.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-delivery/samples/generated/v1/delivery_service.batch_create_tasks.js,packages/google-maps-fleetengine-delivery/samples/README.md) |
 | Delivery_service.create_delivery_vehicle | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine-delivery/samples/generated/v1/delivery_service.create_delivery_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-delivery/samples/generated/v1/delivery_service.create_delivery_vehicle.js,packages/google-maps-fleetengine-delivery/samples/README.md) |
 | Delivery_service.create_task | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine-delivery/samples/generated/v1/delivery_service.create_task.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-delivery/samples/generated/v1/delivery_service.create_task.js,packages/google-maps-fleetengine-delivery/samples/README.md) |
+| Delivery_service.delete_delivery_vehicle | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine-delivery/samples/generated/v1/delivery_service.delete_delivery_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-delivery/samples/generated/v1/delivery_service.delete_delivery_vehicle.js,packages/google-maps-fleetengine-delivery/samples/README.md) |
+| Delivery_service.delete_task | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine-delivery/samples/generated/v1/delivery_service.delete_task.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-delivery/samples/generated/v1/delivery_service.delete_task.js,packages/google-maps-fleetengine-delivery/samples/README.md) |
 | Delivery_service.get_delivery_vehicle | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine-delivery/samples/generated/v1/delivery_service.get_delivery_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-delivery/samples/generated/v1/delivery_service.get_delivery_vehicle.js,packages/google-maps-fleetengine-delivery/samples/README.md) |
 | Delivery_service.get_task | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine-delivery/samples/generated/v1/delivery_service.get_task.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-delivery/samples/generated/v1/delivery_service.get_task.js,packages/google-maps-fleetengine-delivery/samples/README.md) |
 | Delivery_service.get_task_tracking_info | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-fleetengine-delivery/samples/generated/v1/delivery_service.get_task_tracking_info.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-delivery/samples/generated/v1/delivery_service.get_task_tracking_info.js,packages/google-maps-fleetengine-delivery/samples/README.md) |
@@ -223,4 +225,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/getting-started
+[auth]: https://cloud.google.com/docs/authentication/external/set-up-adc-local

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

@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2024 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/delivery/v1/common.proto

@@ -1,4 +1,4 @@
-// Copyright 2023 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.
@@ -25,8 +25,10 @@ option csharp_namespace = "Google.Maps.FleetEngine.Delivery.V1";
 option go_package = "cloud.google.com/go/maps/fleetengine/delivery/apiv1/deliverypb;deliverypb";
 option java_multiple_files = true;
 option java_outer_classname = "Common";
-option java_package = "google.maps.fleetengine.delivery.v1";
+option java_package = "com.google.maps.fleetengine.delivery.v1";
 option objc_class_prefix = "CFED";
+option php_namespace = "Google\\Maps\\FleetEngine\\Delivery\\V1";
+option ruby_package = "Google::Maps::FleetEngine::Delivery::V1";
 
 // Describes a vehicle attribute as a key-value pair. The "key:value" string
 // length cannot exceed 256 characters.

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

@@ -1,4 +1,4 @@
-// Copyright 2023 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,14 +26,17 @@ import "google/maps/fleetengine/delivery/v1/delivery_vehicles.proto";
 import "google/maps/fleetengine/delivery/v1/header.proto";
 import "google/maps/fleetengine/delivery/v1/task_tracking_info.proto";
 import "google/maps/fleetengine/delivery/v1/tasks.proto";
+import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
 
 option csharp_namespace = "Google.Maps.FleetEngine.Delivery.V1";
 option go_package = "cloud.google.com/go/maps/fleetengine/delivery/apiv1/deliverypb;deliverypb";
 option java_multiple_files = true;
 option java_outer_classname = "DeliveryApi";
-option java_package = "google.maps.fleetengine.delivery.v1";
+option java_package = "com.google.maps.fleetengine.delivery.v1";
 option objc_class_prefix = "CFED";
+option php_namespace = "Google\\Maps\\FleetEngine\\Delivery\\V1";
+option ruby_package = "Google::Maps::FleetEngine::Delivery::V1";
 option (google.api.resource_definition) = {
   type: "fleetengine.googleapis.com/Provider"
   pattern: "providers/{provider}"
@@ -76,11 +79,29 @@ service DeliveryService {
     option (google.api.method_signature) = "name";
   }
 
+  // Deletes a DeliveryVehicle from the Fleet Engine.
+  //
+  // Returns FAILED_PRECONDITION if the DeliveryVehicle has OPEN Tasks
+  // assigned to it.
+  rpc DeleteDeliveryVehicle(DeleteDeliveryVehicleRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=providers/*/deliveryVehicles/*}"
+    };
+    option (google.api.routing) = {
+      routing_parameters {
+        field: "name"
+        path_template: "{provider_id=providers/*}"
+      }
+    };
+    option (google.api.method_signature) = "name";
+  }
+
   // Writes updated `DeliveryVehicle` data to Fleet Engine, and assigns
   // `Tasks` to the `DeliveryVehicle`. You cannot update the name of the
-  // `DeliveryVehicle`. You *can* update `remaining_vehicle_journey_segments`
-  // though, but it must contain all of the `VehicleJourneySegment`s currently
-  // on the `DeliveryVehicle`. The `task_id`s are retrieved from
+  // `DeliveryVehicle`. You *can* update `remaining_vehicle_journey_segments`,
+  // but it must contain all of the `VehicleJourneySegment`s to be persisted on
+  // the `DeliveryVehicle`. The `task_id`s are retrieved from
   // `remaining_vehicle_journey_segments`, and their corresponding `Tasks` are
   // assigned to the `DeliveryVehicle` if they have not yet been assigned.
   rpc UpdateDeliveryVehicle(UpdateDeliveryVehicleRequest)
@@ -142,19 +163,21 @@ service DeliveryService {
     option (google.api.method_signature) = "name";
   }
 
-  // Deprecated: Use `GetTaskTrackingInfo` instead.
-  rpc SearchTasks(SearchTasksRequest) returns (SearchTasksResponse) {
-    option deprecated = true;
+  // Deletes a single Task.
+  //
+  // Returns FAILED_PRECONDITION if the Task is OPEN and assigned to a
+  // DeliveryVehicle.
+  rpc DeleteTask(DeleteTaskRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
-      get: "/v1/{parent=providers/*}/tasks:search"
+      delete: "/v1/{name=providers/*/tasks/*}"
     };
     option (google.api.routing) = {
       routing_parameters {
-        field: "parent"
+        field: "name"
         path_template: "{provider_id=providers/*}"
       }
     };
-    option (google.api.method_signature) = "parent";
+    option (google.api.method_signature) = "name";
   }
 
   // Updates `Task` data.
@@ -240,6 +263,7 @@ message CreateDeliveryVehicleRequest {
   // Required. The `DeliveryVehicle` entity to create. When creating a new
   // delivery vehicle, you may set the following optional fields:
   //
+  // * type
   // * last_location
   // * attributes
   //
@@ -265,6 +289,23 @@ message GetDeliveryVehicleRequest {
   ];
 }
 
+// DeleteDeliveryVehicle request message.
+message DeleteDeliveryVehicleRequest {
+  // Optional. The standard Delivery API request header.
+  DeliveryRequestHeader header = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Must be in the format
+  // `providers/{provider}/deliveryVehicles/{delivery_vehicle}`.
+  // The `provider` must be the Google Cloud Project ID. For example,
+  // `sample-cloud-project`.
+  string name = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "fleetengine.googleapis.com/DeliveryVehicle"
+    }
+  ];
+}
+
 // The `ListDeliveryVehicles` request message.
 message ListDeliveryVehiclesRequest {
   // Optional. The standard Delivery API request header.
@@ -418,6 +459,12 @@ message CreateTaskRequest {
   // * `planned_location` (optional for `UNAVAILABLE` tasks)
   // * `task_duration`
   //
+  // The following fields can be optionally set:
+  //
+  // * `target_time_window`
+  // * `task_tracking_view_config`
+  // * `attributes`
+  //
   // Note: The Task's `name` field is ignored. All other Task fields must not be
   // set; otherwise, an error is returned.
   Task task = 4 [(google.api.field_behavior) = REQUIRED];
@@ -439,57 +486,20 @@ message GetTaskRequest {
   ];
 }
 
-// Deprecated: Issue `GetTaskTrackingInfoRequest`s to `GetTaskTrackingInfo`
-// instead.
-message SearchTasksRequest {
-  option deprecated = true;
-
+// DeleteTask request message.
+message DeleteTaskRequest {
   // Optional. The standard Delivery API request header.
   DeliveryRequestHeader header = 1 [(google.api.field_behavior) = OPTIONAL];
 
-  // Required. Must be in the format `providers/{provider}`.
-  // The provider must be the Google Cloud Project ID. For example,
+  // Required. Must be in the format `providers/{provider}/tasks/{task}`. The
+  // `provider` must be the Google Cloud Project ID. For example,
   // `sample-cloud-project`.
-  string parent = 3 [(google.api.field_behavior) = REQUIRED];
-
-  // Required. The identifier of the set of related Tasks being requested.
-  // Tracking IDs are subject to the following restrictions:
-  //
-  // * Must be a valid Unicode string.
-  // * Limited to a maximum length of 64 characters.
-  // * Normalized according to [Unicode Normalization Form C]
-  // (http://www.unicode.org/reports/tr15/).
-  // * May not contain any of the following ASCII characters: '/', ':', '?',
-  // ',', or '#'.
-  string tracking_id = 4 [(google.api.field_behavior) = REQUIRED];
-
-  // Optional. The maximum number of Tasks to return. The service may return
-  // fewer than this value. If you don't specify this value, then the server
-  // determines the number of results to return.
-  int32 page_size = 5 [(google.api.field_behavior) = OPTIONAL];
-
-  // Optional. A page token, received from a previous `SearchTasks` call. You
-  // must provide this value to retrieve the subsequent page.
-  //
-  // When paginating, all other parameters provided to `SearchTasks` must match
-  // the call that provided the page token.
-  string page_token = 6 [(google.api.field_behavior) = OPTIONAL];
-}
-
-// The `SearchTasks` response. It contains the set of Tasks that meet the search
-// criteria in the `SearchTasksRequest`.
-message SearchTasksResponse {
-  option deprecated = true;
-
-  // The set of Tasks for the requested `tracking_id`. A successful response can
-  // also be empty. An empty response indicates that no Tasks are associated
-  // with the supplied `tracking_id`.
-  repeated Task tasks = 1;
-
-  // Pass this token in the `SearchTasksRequest` to continue to
-  // list results. If all results have been returned, then this field is either
-  // an empty string, or it doesn't appear in the response.
-  string next_page_token = 2;
+  string name = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "fleetengine.googleapis.com/Task"
+    }
+  ];
 }
 
 // The `UpdateTask` request message.
@@ -554,8 +564,8 @@ message ListTasksRequest {
   // Optional. A filter query to apply when listing Tasks. See
   // http://aip.dev/160 for examples of filter syntax. If you don't specify a
   // value, or if you filter on an empty string, then all Tasks are returned.
-  // For information about the Task properties that you can filter on, see [Task
-  // list](/maps/documentation/transportation-logistics/last-mile-fleet-solution/fleet-performance/fleet-engine/deliveries_api#list_tasks).
+  // For information about the Task properties that you can filter on, see [List
+  // tasks](https://developers.google.com/maps/documentation/mobility/fleet-engine/journeys/tasks/find-tasks#filter_listed_tasks).
   string filter = 6 [(google.api.field_behavior) = OPTIONAL];
 }
 

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

@@ -1,4 +1,4 @@
-// Copyright 2023 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.
@@ -27,8 +27,10 @@ option csharp_namespace = "Google.Maps.FleetEngine.Delivery.V1";
 option go_package = "cloud.google.com/go/maps/fleetengine/delivery/apiv1/deliverypb;deliverypb";
 option java_multiple_files = true;
 option java_outer_classname = "DeliveryVehicles";
-option java_package = "google.maps.fleetengine.delivery.v1";
+option java_package = "com.google.maps.fleetengine.delivery.v1";
 option objc_class_prefix = "CFED";
+option php_namespace = "Google\\Maps\\FleetEngine\\Delivery\\V1";
+option ruby_package = "Google::Maps::FleetEngine::Delivery::V1";
 
 // The `DeliveryVehicle` message. A delivery vehicle transports shipments from a
 // depot to a delivery location, and from a pickup location to the depot. In
@@ -71,6 +73,14 @@ message DeliveryVehicle {
   // The last reported location of the Delivery Vehicle.
   DeliveryVehicleLocation last_location = 2;
 
+  // Input only. Locations where this Delivery Vehicle has been in the past that
+  // haven't yet been reported to Fleet Engine. This is used in
+  // `UpdateDeliveryVehicleRequest` to record locations which were previously
+  // unable to be sent to the server. Typically this happens when the Delivery
+  // Vehicle does not have internet connectivity.
+  repeated DeliveryVehicleLocation past_locations = 12
+      [(google.api.field_behavior) = INPUT_ONLY];
+
   // The Delivery Vehicle's navigation status.
   DeliveryVehicleNavigationStatus navigation_status = 3;
 
@@ -215,9 +225,8 @@ message VehicleJourneySegment {
 message VehicleStop {
   // Additional information about the Task performed at this stop.
   message TaskInfo {
-    // The Task ID. This field won't be populated in the response of either a
-    // `GetTask`, or a `SearchTasks` call. Task IDs are subject to the following
-    // restrictions:
+    // The Task ID. This field won't be populated in the response of a `GetTask`
+    // call. Task IDs are subject to the following restrictions:
     //
     // * Must be a valid Unicode string.
     // * Limited to a maximum length of 64 characters.
@@ -255,15 +264,14 @@ message VehicleStop {
 
   // Required. The location of the stop. Note that the locations in the `Task`s
   // might not exactly match this location, but will be within a short distance
-  // of it. This field won't be populated in the response of either a `GetTask`,
-  // or a `SearchTasks` call.
+  // of it. This field won't be populated in the response of a `GetTask` call.
   LocationInfo planned_location = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The list of `Task`s to be performed at this stop. This field won't be
-  // populated in the response of either a `GetTask` or `SearchTasks` call.
+  // populated in the response of a `GetTask` call.
   repeated TaskInfo tasks = 2;
 
   // The state of the `VehicleStop`. This field won't be populated in the
-  // response of either a `GetTask`, or a `SearchTasks` call.
+  // response of a `GetTask` call.
   State state = 3;
 }

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

@@ -1,4 +1,4 @@
-// Copyright 2023 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.
@@ -22,8 +22,10 @@ option csharp_namespace = "Google.Maps.FleetEngine.Delivery.V1";
 option go_package = "cloud.google.com/go/maps/fleetengine/delivery/apiv1/deliverypb;deliverypb";
 option java_multiple_files = true;
 option java_outer_classname = "Headers";
-option java_package = "google.maps.fleetengine.delivery.v1";
+option java_package = "com.google.maps.fleetengine.delivery.v1";
 option objc_class_prefix = "CFED";
+option php_namespace = "Google\\Maps\\FleetEngine\\Delivery\\V1";
+option ruby_package = "Google::Maps::FleetEngine::Delivery::V1";
 
 // A RequestHeader contains fields common to all Delivery RPC requests.
 message DeliveryRequestHeader {

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

@@ -1,4 +1,4 @@
-// Copyright 2023 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.
@@ -29,8 +29,10 @@ option csharp_namespace = "Google.Maps.FleetEngine.Delivery.V1";
 option go_package = "cloud.google.com/go/maps/fleetengine/delivery/apiv1/deliverypb;deliverypb";
 option java_multiple_files = true;
 option java_outer_classname = "TaskTrackingInfoProto";
-option java_package = "google.maps.fleetengine.delivery.v1";
+option java_package = "com.google.maps.fleetengine.delivery.v1";
 option objc_class_prefix = "CFED";
+option php_namespace = "Google\\Maps\\FleetEngine\\Delivery\\V1";
+option ruby_package = "Google::Maps::FleetEngine::Delivery::V1";
 
 // The `TaskTrackingInfo` message. The message contains task tracking
 // information which will be used for display. If a tracking ID is associated

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

@@ -1,4 +1,4 @@
-// Copyright 2023 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.
@@ -27,8 +27,10 @@ option csharp_namespace = "Google.Maps.FleetEngine.Delivery.V1";
 option go_package = "cloud.google.com/go/maps/fleetengine/delivery/apiv1/deliverypb;deliverypb";
 option java_multiple_files = true;
 option java_outer_classname = "Tasks";
-option java_package = "google.maps.fleetengine.delivery.v1";
+option java_package = "com.google.maps.fleetengine.delivery.v1";
 option objc_class_prefix = "CFED";
+option php_namespace = "Google\\Maps\\FleetEngine\\Delivery\\V1";
+option ruby_package = "Google::Maps::FleetEngine::Delivery::V1";
 
 // A Task in the Delivery API represents a single action to track. In general,
 // there is a distinction between shipment-related Tasks and break Tasks. A