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

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

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

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

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