ลบยานพาหนะ

เอกสารนี้อธิบายวิธีลบยานพาหนะ โดยถือว่าคุณได้ตั้งค่า Fleet Engine แล้ว ดูหัวข้อตั้งค่า Fleet Engine

ข้อมูลเบื้องต้นเกี่ยวกับการลบยานพาหนะ

ระบบของคุณอาจใช้ Fleet Engine เพื่อลบยานพาหนะในสถานการณ์ต่อไปนี้

• เพื่อดำเนินการล้างข้อมูลขณะทดสอบ Fleet Engine API
• เพื่อลบยานพาหนะที่ไม่จำเป็นต้องใช้อีกต่อไปทันที

หากต้องการลบยานพาหนะ ให้ส่งคำขอโดยใช้ gRPC หรือ REST

• วิธี DeleteVehicle(): gRPC หรือ REST
• ข้อความ DeleteVehicleRequest: gRPC เท่านั้น

ใช้ข้อมูลเข้าสู่ระบบที่เหมาะสมสำหรับบัญชีบริการของโปรเจ็กต์ตามที่อธิบายไว้ในFleet Engine: บทบาทของบัญชีบริการ

หมายเหตุ: Fleet Engine จะลบยานพาหนะโดยอัตโนมัติหลังจากที่ไม่มีการใช้งานเป็นระยะเวลาหนึ่ง ดูการนำยานพาหนะกลับมาใช้ใหม่

ตัวอย่าง: ลบยานพาหนะ

Java

ตัวอย่างต่อไปนี้แสดงวิธีใช้ไลบรารี Java gRPC เพื่อลบยานพาหนะ ดูรายการภาษาที่รองรับทั้งหมดได้ที่ไลบรารีของไคลเอ็นต์สำหรับบริการการเดินทางแบบออนดีมานด์

  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;
  }

REST

ตัวอย่างต่อไปนี้แสดงวิธีลบยานพาหนะออกจาก Fleet Engine โดยใช้ REST ด้วยการเรียก 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}"

หากการดำเนินการลบสำเร็จ API จะแสดงการตอบกลับที่ว่างเปล่า

จัดการข้อผิดพลาด

เมื่อลบยานพาหนะ คุณอาจพบข้อผิดพลาด FAILED_PRECONDITION ซึ่งในกรณีนี้จะมีการเดินทางที่อ้างอิงยานพาหนะดังกล่าว วิธีดำเนินการลบ

1. เรียกใช้ SearchTrips เพื่อค้นหาการเดินทางที่อ้างอิงยานพาหนะ
2. เรียกใช้ DeleteTrip เพื่อลบการเดินทางแต่ละรายการที่พบ

คำเตือน: ตรวจสอบว่าคุณไม่จำเป็นต้องใช้การเดินทางที่พบอีกต่อไป เมื่อลบแล้ว จะกู้คืนการเดินทางไม่ได้

ขั้นตอนถัดไป

• สร้างการเดินทางแบบออนดีมานด์