Xóa chuyến đi

Tài liệu này mô tả cách xoá một chuyến đi. Giả sử bạn đã thiết lập Công cụ của đội xe. Xem bài viết Thiết lập Công cụ quản lý đội xe.

Thông tin cơ bản về việc xoá chuyến đi

Hệ thống của bạn có thể sử dụng Công cụ quản lý đội xe để xoá một chuyến đi trong các trường hợp sau:

  • Để thực hiện các thao tác dọn dẹp trong khi kiểm thử API Động cơ của đội xe.
  • Để xoá ngay một Chuyến đi không còn cần thiết.

Để xoá một chuyến đi, hãy gửi yêu cầu bằng gRPC hoặc REST.

  • Phương thức DeleteTrip(): gRPC hoặc REST
  • Thông báo DeleteTripRequest: chỉ gRPC

Sử dụng thông tin xác thực thích hợp cho tài khoản dịch vụ của dự án như mô tả trong phần Công cụ của đội xe: Vai trò của tài khoản dịch vụ.

Ví dụ: xoá chuyến đi

Ví dụ sau đây minh hoạ cách xoá một chuyến đi trong Công cụ quản lý đội xe.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "trip-8241890";

String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;

TripServiceBlockingStub tripService = TripServiceGrpc.newBlockingStub(channel);

// Delete trip request.
DeleteTripRequest deleteTripRequest = DeleteTripRequest.newBuilder()
    .setName(tripName)
    .build();

// Error handling.
try {
  tripService.deleteTrip(deleteTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:            // The trip doesn't exist.
      break;
    case FAILED_PRECONDITION:  // Trip is active and assigned to a vehicle.
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

Xử lý lỗi

Khi xoá một chuyến đi, bạn có thể gặp lỗi FAILED_PRECONDITION. Trong trường hợp này, chuyến đi đang hoạt động và được chỉ định cho một xe.
Để tiếp tục xoá, hãy gọi UpdateTrip và cập nhật trip_status thành COMPLETE/CANCELED.

Bước tiếp theo