Hapus kendaraan

Dokumen ini menjelaskan cara menghapus kendaraan. Ini mengasumsikan bahwa Anda telah menyiapkan Fleet Engine. Lihat Menyiapkan Fleet Engine.

Dasar-dasar penghapusan kendaraan

Sistem Anda dapat menggunakan Fleet Engine untuk menghapus kendaraan dalam situasi berikut:

  • Untuk melakukan operasi pembersihan saat menguji Fleet Engine API.
  • Untuk segera menghapus Kendaraan yang tidak lagi diperlukan.

Untuk menghapus kendaraan, kirim permintaan menggunakan gRPC atau REST.

  • Metode DeleteVehicle(): gRPC atau REST
  • Pesan DeleteVehicleRequest: khusus gRPC

Gunakan kredensial yang sesuai untuk akun layanan project Anda seperti yang dijelaskan dalam Fleet Engine: Peran akun layanan.

Contoh: delete vehicle

JavaREST

Contoh berikut menunjukkan cara menggunakan library gRPC Java untuk menghapus kendaraan.

  static final String PROJECT_ID = "my-delivery-co-gcp-project";
  static final String VEHICLE_ID = "vehicle-8241890";

  String vehicleName = "providers/" + PROJECT_ID + "/vehicles/" + VEHICLE_ID;

  VehicleServiceBlockingStub vehicleService = VehicleService.newBlockingStub(channel);

  // Delete Vehicle request
  DeleteVehicleRequest deleteVehicleRequest = DeleteVehicleRequest.newBuilder()
      .setName(vehicleName)
      .build();

  try {
    vehicleService.deleteVehicle(deleteVehicleRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case NOT_FOUND:            // The vehicle doesn't exist.
         break;
       case FAILED_PRECONDITION:  // There are trip(s) that reference vehicle.
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

Contoh berikut menunjukkan cara menghapus kendaraan dari Fleet Engine menggunakan REST dengan melakukan panggilan ke DeleteVehicle.

  # DELETE https://fleetengine.googleapis.com/v1/providers/<project_id>/vehicles/<vehicleId>
  # Set JWT, PROJECT_ID, and VEHICLE_ID in the local environment
  curl -X DELETE -H "Authorization: Bearer ${JWT}" \
    "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/vehicles/${VEHICLE_ID}"

Jika operasi penghapusan berhasil, API akan menampilkan respons kosong.

Menangani error

Saat menghapus kendaraan, Anda mungkin mengalami error FAILED_PRECONDITION, yang berarti ada perjalanan yang mereferensikan kendaraan tersebut. Untuk melanjutkan penghapusan:

  1. Panggil SearchTrips untuk menemukan perjalanan yang mereferensikan Kendaraan.
  2. Panggil DeleteTrip untuk menghapus setiap perjalanan yang ditemukan.

Langkah berikutnya