استرجع بيانات الرحلة مباشرةً من Fleet Engine

يوضّح لك هذا الدليل كيفية استرداد بيانات الرحلات مباشرةً من Fleet Engine، كبديل لاستخدام Consumer SDK. يمكنك استخدام هذا الأسلوب للتحكّم بشكل أكبر في تجربة المستخدم النهائي مع الاستفادة في الوقت نفسه من ميزات Fleet Engine الدقيقة وفي الوقت الفعلي، مثل الموقع الجغرافي للمركبة ووقت الوصول المقدَّر والمسار.

لمزيد من التفاصيل حول استخدام حزمة تطوير البرامج (SDK) للمستهلكين، يُرجى الاطّلاع على مشاركة الرحلات عند الطلب.

استرداد معلومات الرحلة

لاسترداد معلومات الرحلة من Fleet Engine مباشرةً، استدعِ طريقة GetTrip، مع تحديد طريقة العرض JOURNEY_SHARING_V1S. راجِع مرجع RPC أو REST.

عادةً ما يطلب الخادم من خدمة الرحلات معرفة حالة كل رحلة بينما يتتبّع الراكب تقدّم المركبة. يتم عادةً تعديل بيانات الموقع الجغرافي للمركبة كل 10 ثوانٍ، ويجب أن يطلب نظامك البيانات بالمعدل نفسه. يمكن مراقبة الحقل Trip.last_location.update_time لمعرفة ما إذا كانت هناك أي تعديلات منذ الطلب السابق إلى GetTrip.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "trip-A";

String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;
GetTripRequest getTripRequest =
    GetTripRequest.newBuilder()
        .setName(tripName)
        .setView(JOURNEY_SHARING_V1S)
        .build();
Trip trip = tripService.getTrip(getTripRequest);

يحتوي عنصر Trip الناتج على الحقول التالية التي تم ملؤها بأحدث المعلومات المتاحة للرحلة:

name trip_status remaining_waypoints
vehicle_id trip_type last_location
number_of_passengers pickup_point view (== JOURNEY_SHARING_V1S)
actual_pickup_point intermediate_destinations intermediate_destination_index
pickup_time intermediate_destinations_version dropoff_point
actual_dropoff_point dropoff_time

استرداد نقاط الطريق المتبقية في الرحلة

يحتوي عنصر Trip على حقل متكرّر من النوع TripWaypoint. يتضمّن هذا الحقل جميع نقاط الطريق التي ستنتقل إليها المركبة، بالترتيب، قبل نقطة التسليم النهائية لهذه الرحلة. يؤدي تحديد طريقة عرض "مشاركة الرحلة" إلى توجيه Fleet Engine لوضع المعلومات المعدَّلة في remaining_waypoints[0]TripWaypoint. في طرق العرض الأخرى التي لا تتضمّن ميزة "مشاركة الرحلة"، لا تشير نقطة الطريق هذه عادةً إلى آخر موقع جغرافي للمركبة المحدّدة. راجِع المرجع الخاص بـ RPC أو REST.

لمزيد من المعلومات، يُرجى الاطّلاع على حالة الرحلة ونقاط الطريق المتبقية للمركبة في دليل مقدمة عن الرحلات.

في ما يلي مثال على حقل remaining_waypoints لرحلة، الرحلة أ:

[0] location.point = trip.pickup_point.point
trip_id = "trip_A"
waypoint_type = PICKUP_WAYPOINT_TYPE
path_to_waypoint = LatLng[] أول LatLng من المسار المتبقي إلى موقع الاستلام
‫2nd LatLng من المسار المتبقي إلى موقع الاستلام
...
آخر خط عرض من المسار المتبقي إلى نقطة الالتقاط
pickup_point، إذا كان مختلفًا عن آخر نقطة
traffic_data
distance_meters = المسافة من current vehicle_location على طول path_to_waypoint إلى نقطة الاستلام
eta = updated ETA
المدة = المدة المعدَّلة
[1] location.point = trip.dropoff_point.point
trip_id = "trip_A"
waypoint_type = DROP_OFF_WAYPOINT_TYPE
path_to_waypoint = LatLng[] أول LatLng من مرحلة النزول
‫LatLng الثاني من مرحلة التوصيل
...
آخر LatLng من محطة التوصيل
نقطة التسليم، إذا كانت مختلفة عن آخر نقطة
traffic_data
distance_meters = distance from pickup along path_to_waypoint to dropoff
eta = updated ETA
المدة = مدة رحلة التوصيل

في الرحلات التي تتضمّن نقاط توقّف متتالية ورحلات مشتركة، قد تحتوي هذه القائمة على نقاط توقّف من رحلات أخرى يجب المرور بها قبل هذه الرحلة. على سبيل المثال، لنفترض أنّ الرحلة (ب) مخصّصة للمركبة نفسها التي تم تخصيص الرحلة (أ) لها. سيتم بعد ذلك ملء حقل remaining_waypoints الخاص بالرحلة (أ) على النحو التالي. تم حذف معظم الحقول للاختصار، ولكن سيتم ملؤها بما يتوافق مع المثال السابق.

[0] trip_id = "trip_A"
waypoint_type = PICKUP_WAYPOINT_TYPE
[1] trip_id = "trip_B"
waypoint_type = PICKUP_WAYPOINT_TYPE
[2] trip_id = "trip_B"
waypoint_type = DROP_OFF_WAYPOINT_TYPE
[3] trip_id = "trip_A"
waypoint_type = DROP_OFF_WAYPOINT_TYPE

سيتم ملء حقل remaining_waypoint للرحلة B بشكل مشابه، ولكن ستظهر فيه أول ثلاث إدخالات فقط، لأنّ نقطة التوقّف في الرحلة A ليست جزءًا من مسار الرحلة B.