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

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

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

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

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

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

حقول الرحلة

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

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

يوضّح القسم التالي كيفية إنشاء رحلة متتالية وإسنادها إلى مركبة. في هذا السيناريو، تكون عملية إنشاء الرحلة مماثلة لتلك المتعلّقة برحلة تهدف إلى وجهة واحدة. وبعد ذلك، يمكنك إنشاء رحلة أخرى وإسنادها إلى مركبة التي سبق أن كانت في رحلة نشطة.

// 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() أو onTripRemainingWaypointsUpdated المرجع المخصّص لرحلتَي أremainingWaypoints التي تحتوي على:
  _{موضع إنزال}.
• يعرض كلّ من getTrip() أو onTripRemainingWaypointsUpdated المخصّص للردّ على الرحلة ب remainingWaypoints يحتوي على ما يلي:
  أ _{موضع الاستلام} → ب _{موضع الاستلام} → ب _{موضع الاستلام}.

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

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