البحث عن رحلات

توفّر 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.

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