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