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