يوفر 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_onlytrue. - يجب أن تكون قيمة الحقل "
minimum_staleness" أكبر من معظم مُدد الرحلات. حيث على سبيل المثال، ساعة واحدة.
وتشمل نتائج هذا الطلب الرحلات غير COMPLETE أو
CANCELED، ولم يتم تحديثها منذ أكثر من ساعة. يمكنك بعد ذلك فحص
هذه الرحلات للتأكد من تحديث حالتها في Fleet Engine بشكل صحيح.