إنشاء رحلات متتالية

يوضّح هذا المستند كيفية إنشاء رحلة متتالية وضبط الحقل المناسب وتخصيصها لمركبة لتنفيذها. يفترض هذا الدليل أنّك قد أعددت "محرك الأسطول"، وأنّك أنشأت مركبات، وأنّ لديك تطبيقًا يعمل للسائقين، وتطبيقًا اختياريًا للمستهلكين. من المفترض أيضًا أن تكون على دراية بسيناريوهات الرحلات المختلفة المتاحة للرحلات عند الطلب. اطّلِع على الأدلة ذات الصلة التالية لتحديد ما يلي:

• إعداد Fleet Engine
• إنشاء مركبة
• سيناريوهات الرحلات في النظرة العامة على الرحلات عند الطلب

أساسيات إنشاء الرحلات

يصف هذا القسم تفاصيل الطلب اللازمة لإنشاء رحلة في Fleet Engine. يمكنك إصدار طلب إنشاء باستخدام gRPC وREST.

• طريقة CreateTrip(): gRPC أو REST
• رسالة CreateTripRequest: gRPC فقط

حقول الرحلة

استخدِم الحقول التالية لإنشاء رحلة في Fleet Engine. يمكنك استخدام ملفّات مختلفة للأنواع المختلفة من الرحلات: الرحلات التي تتضمن وجهة واحدة أو وجهات متعددة، والرحلات المتتالية، أو الرحلات المشتركة. يمكنك إدخال الحقول الاختيارية عند إنشاء الرحلة، أو يمكنك ضبطها لاحقًا عند تعديل الرحلة.

حقول الرحلة

الاسم	مطلوب؟	الوصف
parent	نعم	سلسلة تتضمّن رقم تعريف المشروع يجب أن يكون هذا المعرّف هو المعرّف نفسه المستخدَم في عملية دمج 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 التي تحتوي على:
  أ _تسليم → ب _استلام → ب _تسليم.
• تؤدي كلّ من getTrip() أو callback onTripRemainingWaypointsUpdated لرحلت أ إلى عرض remainingWaypoints يحتوي على:
  _{موضع إنزال}.
• تُعرِض كلّ من getTrip() أو onTripRemainingWaypointsUpdated المخصّصة للاتّصال بشأن الرحلة ب remainingWaypoints التي تحتوي على ما يلي:
  أ _{موضع الاستلام} → ب _{موضع الاستلام} → ب _{موضع الاستلام}.

الخطوات التالية

• إنشاء رحلات مشتركة مشترَكة
• إعداد حزمة تطوير البرامج (SDK) لبرنامج التشغيل