حذف سفر

این سند نحوه حذف سفر را شرح می‌دهد. فرض بر این است که «موتور ناوگان» را راه‌اندازی کرده‌اید. راه‌اندازی Fleet Engine را ببینید.

مبانی حذف سفر

سیستم شما ممکن است در شرایط زیر از Fleet Engine برای حذف سفر استفاده کند:

• برای انجام عملیات پاک‌سازی هنگام آزمایش کردن Fleet Engine API.
• برای حذف فوری سفری که دیگر لازم نیست.

برای حذف سفر، بااستفاده از gRPC یا REST درخواست ارسال کنید.

• روش DeleteTrip(): gRPC یا REST
• پیام DeleteTripRequest: فقط gRPC

از اطلاعات کاربری مناسب برای حساب سرویس پروژه‌تان استفاده کنید، همان‌طور که در Fleet Engine: نقش‌های حساب سرویس شرح داده شده است.

توجه: Fleet Engine به‌طور خودکار سفر را پس‌از اینکه برای مدتی غیرفعال بود حذف می‌کند. چرخه زندگی سفر را ببینید.

مثال: حذف سفر

مثال زیر نحوه حذف سفر در Fleet Engine را نشان می‌دهد.

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

مدیریت کردن خطاها

هنگام حذف سفر، ممکن است با خطای FAILED_PRECONDITION مواجه شوید، که در این صورت سفر فعال است و به خودرویی اختصاص داده شده است.
برای ادامه حذف، با UpdateTrip تماس بگیرید و trip_status را به COMPLETE/CANCELED به‌روز کنید.

قدم بعدی چیست

• ایجاد سفرهای چندمقصدی