يوفّر Fleet Engine نقطة النهاية SearchTripsRequest التي يمكنك استخدامها للعثور على
الرحلات. يصف هذا المستند سيناريوهَين قد تستخدم فيهما هذه الميزة.
يُرجى الاطّلاع على SearchTripsRequest لـ gRPC أو trips.Search لـ REST.
تحديد الرحلات النشطة لمركبة
للعثور على الرحلات النشطة لحقول معيّنة، استخدِم رسالة SearchTripsRequest لضبط vehicle_id على المركبة المعنيّة وضبط active_trips_only على true.
تسوية معلومات توفّر المركبات بين نظامك وFleet Engine
في بعض الحالات، قد تظهر لك نتائج من SearchVehicles لا تتوافق مع المركبات التي تعرف أنّها متاحة في نظامك وأسطولك. يحدث ذلك لأنّ SearchVehicles إما لا يعرض المركبات التي تتضمّن رحلات نشطة أو يخفض ترتيبها في النتائج. يحدث ذلك عندما تُكمل المركبات رحلاتها، ولكن لا يتم ضبط حالة الرحلة بشكل صحيح على COMPLETE أو CANCELED. باستخدام SearchTrips للعثور على الرحلات المفتوحة،
يمكنك تقييم المركبات للتأكّد من أنّ TripStatus في نظامك يتطابق
مع Fleet Engine.
لاستخدام SearchTrips بهذه الطريقة، اضبط ما يلي في رسالة SearchTripsRequest:
- يجب أن يكون الحقل
vehicle_idفارغًا. - يجب أن تكون قيمة
active_trips_onlyهيtrue. - يجب أن تكون قيمة
minimum_stalenessأكبر من معظم مُدد الرحلات، على سبيل المثال، ساعة واحدة.
تتضمّن نتائج هذا الطلب الرحلات التي ليست COMPLETE أو
CANCELED، ولم يتم تعديلها منذ أكثر من ساعة. يمكنك بعد ذلك فحص هذه الرحلات للتأكّد من تعديل حالتها في Fleet Engine بشكل صحيح.