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

يوفر 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 بشكل صحيح.

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