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

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

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

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