Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
In diesem Dokument wird beschrieben, wie Sie ein Lieferfahrzeug löschen. Dabei wird davon ausgegangen, dass Sie Fleet Engine eingerichtet haben. Weitere Informationen finden Sie unter Fleet Engine einrichten.
Grundlagen zum Löschen von Lieferfahrzeugen
Ihr System kann Fleet Engine verwenden, um ein Lieferfahrzeug in den folgenden Situationen zu löschen:
Bereinigungsvorgänge beim Testen von Fleet Engine-APIs ausführen.
Ein Lieferfahrzeug, das nicht mehr benötigt wird, sofort löschen.
Senden Sie eine Anfrage mit gRPC oder REST, um ein Lieferfahrzeug zu löschen.
Verwenden Sie die entsprechenden Anmeldedaten für das Dienstkonto Ihres Projekts, wie unter Fleet Engine: Dienstkontorollen beschrieben.
Beispiel: Lieferfahrzeug löschen
Java
Im folgenden Beispiel wird gezeigt, wie Sie mit der Java-gRPC-Bibliothek ein Lieferfahrzeug löschen.
staticfinalStringPROJECT_ID="my-rideshare-co-gcp-project";staticfinalStringVEHICLE_ID="vehicle-8241890";StringdeliveryVehicleName="providers/"+PROJECT_ID+"/deliveryVehicles/"+VEHICLE_ID;DeliveryServiceBlockingStubdeliveryService=DeliveryServiceGrpc.newBlockingStub(channel);// Delete Vehicle requestDeleteDeliveryVehicleRequestdeleteDeliveryVehicleRequest=DeleteDeliveryVehicleRequest.newBuilder().setName(deliveryVehicleName).build();try{deliveryService.deleteDeliveryVehicle(deleteDeliveryVehicleRequest);}catch(StatusRuntimeExceptione){Statuss=e.getStatus();switch(s.getCode()){caseNOT_FOUND:// The delivery vehicle doesn't exist.break;caseFAILED_PRECONDITION:// There are tasks(s) that reference delivery vehicle.break;casePERMISSION_DENIED:break;}return;}
REST
Im folgenden Beispiel wird gezeigt, wie Sie ein Lieferfahrzeug aus Fleet Engine löschen, indem Sie einen REST-Aufruf an DeleteDeliveryVehicle senden.
# DELETE https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<vehicleId># Set JWT, PROJECT_ID, and VEHICLE_ID in the local environmentcurl-XDELETE-H"Authorization: Bearer ${JWT}"\"https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryvehicles/${VEHICLE_ID}"
Wenn der Löschvorgang erfolgreich ist, gibt die API eine leere Antwort zurück.
Fehler verarbeiten
Wenn Sie ein Lieferfahrzeug löschen, kann es zu einem FAILED_PRECONDITION-Fehler kommen. In diesem Fall gibt es Aufgaben, die auf das Lieferfahrzeug verweisen.
So fahren Sie mit dem Löschen fort:
Rufen Sie ListTasks auf, um Aufgaben zu finden, die sich auf das Lieferfahrzeug beziehen.
Rufen Sie DeleteTask auf, um jede der gefundenen Aufgaben zu löschen.
[null,null,["Zuletzt aktualisiert: 2025-09-05 (UTC)."],[],[],null,["# Delete delivery vehicle\n\nThis document describes how to delete a delivery vehicle. It assumes you\nhave set up Fleet Engine. See [Set up Fleet Engine](/maps/documentation/mobility/fleet-engine/essentials/set-up-fleet).\n\nDelivery vehicle deletion basics\n--------------------------------\n\nYour system may use Fleet Engine to delete a delivery vehicle in the following situations:\n\n- To perform cleanup operations while testing Fleet Engine APIs.\n- To immediately delete a Delivery Vehicle that is no longer required.\n\nTo delete a delivery vehicle, send a request using either gRPC or REST.\n\n- `DeleteDeliveryVehicle()` method: [gRPC](/maps/documentation/mobility/fleet-engine/reference/tasks/rpc/maps.fleetengine.delivery.v1#maps.fleetengine.delivery.v1.DeliveryService) or [REST](/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/providers.deliveryVehicles/delete)\n- `DeleteDeliveryVehicleRequest` message: [gRPC](/maps/documentation/mobility/fleet-engine/reference/tasks/rpc/maps.fleetengine.delivery.v1#deletedeliveryvehiclerequest) only\n\nUse the appropriate credentials for the service account of your project as\ndescribed in [Fleet Engine: Service account roles](/maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/service-accounts).\n| **Note:** Fleet Engine automatically deletes a delivery vehicle after it has been inactive for a period of time. See [Vehicle re-use](/maps/documentation/mobility/fleet-engine/essentials/vehicles#vehicle_re-use).\n\nExample: delete delivery vehicle\n--------------------------------\n\n### Java\n\n\nThe following example shows how to use the [Java gRPC library](/maps/documentation/mobility/fleet-engine/essentials/client-libraries-tasks#java) to delete a\ndelivery vehicle. \n\n static final String PROJECT_ID = \"my-rideshare-co-gcp-project\";\n static final String VEHICLE_ID = \"vehicle-8241890\";\n\n String deliveryVehicleName = \"providers/\" + PROJECT_ID + \"/deliveryVehicles/\" + VEHICLE_ID;\n\n DeliveryServiceBlockingStub deliveryService = DeliveryServiceGrpc.newBlockingStub(channel);\n\n // Delete Vehicle request\n DeleteDeliveryVehicleRequest deleteDeliveryVehicleRequest =\n DeleteDeliveryVehicleRequest.newBuilder().setName(deliveryVehicleName).build();\n\n try {\n deliveryService.deleteDeliveryVehicle(deleteDeliveryVehicleRequest);\n } catch (StatusRuntimeException e) {\n Status s = e.getStatus();\n switch (s.getCode()) {\n case NOT_FOUND: // The delivery vehicle doesn't exist.\n break;\n case FAILED_PRECONDITION: // There are tasks(s) that reference delivery vehicle.\n break;\n case PERMISSION_DENIED:\n break;\n }\n return;\n }\n\n### REST\n\n\nThe following example shows how to delete a delivery vehicle from Fleet Engine using REST by\nmaking a call to `DeleteDeliveryVehicle`. \n\n # DELETE https://fleetengine.googleapis.com/v1/providers/\u003cproject_id\u003e/deliveryVehicles/\u003cvehicleId\u003e\n # Set JWT, PROJECT_ID, and VEHICLE_ID in the local environment\n curl -X DELETE -H \"Authorization: Bearer ${JWT}\" \\\n \"https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryvehicles/${VEHICLE_ID}\"\n\nIf the delete operation is successful, the API returns an empty response.\n\nHandle errors\n-------------\n\nWhen deleting a delivery vehicle, you might encounter a `FAILED_PRECONDITION`\nerror, in which case there are task(s) that reference the delivery vehicle.\nTo proceed with the deletion:\n\n1. Call `ListTasks` to find task(s) that reference the Delivery Vehicle.\n2. Call `DeleteTask` to delete each of the found task.\n\n| **Warning:** Ensure that the found task(s) are no longer required. Once deleted, task(s) cannot be recovered.\n\nWhat's next\n-----------\n\n- [Create a scheduled journey](/maps/documentation/mobility/fleet-engine/journeys/tasks)"]]