حذف سفر

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

اصول اولیه حذف سفر

سیستم شما ممکن است از «موتور ناوگان» برای حذف سفر در شرایط زیر استفاده کند:

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

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

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

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

مثال: حذف سفر

مثال زیر نحوه حذف سفر در «موتور ناوگان» را نشان می‌دهد.

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 به‌روز کنید.

قدم بعدی چیست