Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Dokumen ini menjelaskan cara menghapus kendaraan pengiriman. Panduan ini mengasumsikan Anda telah menyiapkan Fleet Engine. Lihat Menyiapkan Fleet Engine.
Dasar-dasar penghapusan kendaraan pengiriman
Sistem Anda dapat menggunakan Fleet Engine untuk menghapus kendaraan pengiriman dalam situasi berikut:
Untuk melakukan operasi pembersihan saat menguji Fleet Engine API.
Untuk segera menghapus Kendaraan Pengiriman yang tidak lagi diperlukan.
Untuk menghapus kendaraan pengiriman, kirim permintaan menggunakan gRPC atau REST.
Contoh berikut menunjukkan cara menggunakan library gRPC Java untuk menghapus
kendaraan pengiriman.
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
Contoh berikut menunjukkan cara menghapus kendaraan pengiriman dari Fleet Engine menggunakan REST dengan
melakukan panggilan ke DeleteDeliveryVehicle.
# 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}"
Jika operasi penghapusan berhasil, API akan menampilkan respons kosong.
Menangani error
Saat menghapus kendaraan pengiriman, Anda mungkin mengalami error FAILED_PRECONDITION, yang berarti ada tugas yang mereferensikan kendaraan pengiriman tersebut.
Untuk melanjutkan penghapusan:
Panggil ListTasks untuk menemukan tugas yang mereferensikan Kendaraan Pengiriman.
Panggil DeleteTask untuk menghapus setiap tugas yang ditemukan.
[null,null,["Terakhir diperbarui pada 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)"]]