ایجاد سفرهای پشت‌سرهم

این سند نحوه ایجاد سفر پشت‌سرهم، تنظیم فیلدهای صحیح، و واگذاری آن به خودرو برای انجام را شرح می‌دهد. این راهنما فرض می‌کند که Fleet Engine را راه‌اندازی کرده‌اید، وسایل نقلیه را ایجاد کرده‌اید، برنامه راننده فعال دارید، و به‌طور اختیاری، برنامه مصرف‌کننده دارید. همچنین باید با سناریوهای مختلف سفر موجود برای سفرهای درخواستی آشنا باشید. برای این کار، راهنماهای مرتبط زیر را ببینید:

اصول اولیه ایجاد سفر

این بخش جزئیات درخواست لازم برای ایجاد سفر در Fleet Engine را شرح می‌دهد. درخواست ایجاد را بااستفاده از gRPC یا REST صادر می‌کنید.

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

فیلدهای سفر

از فیلدهای زیر برای ایجاد سفر در Fleet Engine استفاده کنید. می‌توانید از فیلدهای مختلفی برای انواع مختلف سفرها استفاده کنید: تک‌مقصدی یا چندمقصدی، پشت‌سرهم، یا سفرهای اشتراکی. می‌توانید فیلدهای اختیاری را هنگام ایجاد سفر ارائه دهید، یا می‌توانید آن‌ها را بعداً هنگام به‌روزرسانی سفر تنظیم کنید.

فیلدهای سفر
نام الزامی است؟ شرح
ولی بله رشته‌ای که شامل شناسه پروژه است. این شناسه باید همان شناسه‌ای باشد که در سراسر ادغام Fleet Engine شما با همان نقش‌های حساب سرویس استفاده می‌شود.
trip_id بله رشته‌ای که شما ایجاد می‌کنید و این سفر را به‌طور منحصربه‌فرد شناسایی می‌کند. شناسه‌های سفر محدودیت‌های خاصی دارند که در مرجع نشان داده شده است.
trip_type بله TripType را برای نوع سفری که ایجاد می‌کنید روی مقادیر زیر تنظیم کنید:
  • مقصد تکی: روی SHARED یا EXCLUSIVE تنظیم شده است.
  • چندمقصدی: روی EXCLUSIVE تنظیم شده است.
  • پشت‌سرهم: روی EXCLUSIVE تنظیم شده است.
  • ادغام مشترک: روی SHARED تنظیم شده است.
pickup_point بله نقطه شروع سفر.
مقصدهای میانی بله

فقط سفرهای چندمقصدی: فهرست مقصدهای میانی که راننده بین سوار کردن و پیاده کردن مسافر از آن‌ها بازدید می‌کند. مانند dropoff_point، این فیلد را می‌توان بعداً با فراخوانی UpdateTrip تنظیم کرد، اما سفر چندمقصدی طبق تعریف شامل مقصدهای میانی است.

vehicle_waypoints بله

فقط سفرهای اشتراکی: این فیلد از درهم‌بافی نقطه‌مسیرهای چند سفر پشتیبانی می‌کند. این فهرست شامل همه نقاط‌مسیر باقی‌مانده برای خودرو اختصاص‌یافته و همچنین نقاط‌مسیر سوار کردن و پیاده کردن برای این سفر است. می‌توانید این فیلد را با فراخوانی CreateTrip یا UpdateTrip تنظیم کنید. همچنین می‌توانید نقاط‌مسیر خودرو را ازطریق فیلد waypoints با تماس با UpdateVehicle به‌روز کنید. این سرویس به‌دلیل مسائل مربوط به حریم خصوصی، این اطلاعات را در تماس‌های GetTrip برنمی‌گرداند.

number_of_passengers نه تعداد مسافران در سفر.
dropoff_point نه مقصد سفر.
vehicle_id نه شناسه خودرو اختصاص‌داده‌شده به سفر.

مثال: ایجاد سفر پشت‌سرهم

در زیر نحوه ایجاد سفر پشت‌سرهم و اختصاص آن به خودرو نشان داده شده است. در این سناریو، ایجاد سفر مانند سفر تک‌مقصدی است. فقط بعداً است که سفر دیگری ایجاد می‌کنید و آن را به خودرویی با سفر فعال اختصاص می‌دهید.

// A vehicle with ID 'my-vehicle' is already created and it is assigned to a trip with ID 'current-trip'.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String VEHICLE_ID =" my-vehicle";
static final String TRIP_ID = "back-to-back-trip");

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;

Trip trip = Trip.newBuilder()
    .setTripType(TripType.EXCLUSIVE)
    .setPickupPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.195139).setLongitude(106.820826)))
    .setDropoffPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.1275).setLongitude(106.6537)))
    .setVehicleId(VEHICLE_ID)
    .build();

// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
    .setParent(parent)
    .setTripId(TRIP_ID)
    .setTrip(trip)
    .build();

// Error handling.
try {
  // Fleet Engine automatically assigns a 'waypoints' list to the trip containing
  // the vehicle's current trip waypoints.
  Trip createdTrip =
      tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case ALREADY_EXISTS:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

به‌روزرسانی سفرهای پشت‌سرهم

وقتی خودرویی را برای سفر پشت‌سرهم اختصاص می‌دهید، سفری را به خودرو اختصاص می‌دهید حتی اگر قبلاً سفری به آن اختصاص داده شده باشد.

هر سفری که در Fleet Engine ایجاد می‌شود باید به خودرویی اختصاص داده شود تا Fleet Engine بتواند زمان تخمینی رسیدن سفر را محاسبه و آن را ردیابی کند. می‌توانید این کار را درطول ایجاد سفر یا بعداً هنگام به‌روزرسانی سفر انجام دهید.

پس‌از اینکه سفر را به خودرو اختصاص دادید، Fleet Engine به‌طور خودکار نقاط مسیر مرتبط با سفرهای پشت‌سرهم را به فیلد نقاط مسیر خودرو اضافه می‌کند. فیلد remainingWaypoints سفر حاوی فهرستی از همه نقطه‌مسیرها است، ازجمله نقطه‌مسیرهای سفرهای دیگری که قبل‌از پیاده کردن مسافر این سفر بازدید خواهند شد.

برای مثال، دو سفر پشت‌سرهم را درنظر بگیرید: سفر الف و سفر ب. خودرو مصرف‌کننده را برای سفر الف سوار کرده است و درحین حرکت به‌سمت مقصد، راننده درخواستی برای سوار کردن مصرف‌کننده دیگری برای سفر بعدی، سفر ب، دریافت می‌کند.

  • فراخوانی getVehicle() remainingWaypoints را برمی‌گرداند که حاوی این موارد است:
    A Drop-off ← B Pickup ← B Drop-off.
  • ‫getTrip() یا onTripRemainingWaypointsUpdated فراخوانی برگشتی برای سفر الف remainingWaypoints را برمی‌گرداند که حاوی این موارد است:
    پیاده کردن الف.
  • یا getTrip() یا onTripRemainingWaypointsUpdated فراخوانی برگشتی برای سفر B remainingWaypoints را برمی‌گرداند که حاوی این موارد است:
    A پیاده کردن ← B سوار کردن ← و B پیاده کردن.

قدم بعدی چیست