Fleet Engine, SearchTripsRequest एंडपॉइंट उपलब्ध कराता है. इसका इस्तेमाल करके, यात्राएं ढूंढी जा सकती हैं. इस दस्तावेज़ में ऐसी दो स्थितियों के बारे में बताया गया है जिनमें इस सुविधा का इस्तेमाल किया जा सकता है.
gRPC के लिए SearchTripsRequest या REST के लिए trips.Search देखें.
किसी वाहन के लिए चालू यात्राओं का पता लगाना
किसी खास फ़ील्ड के लिए चालू यात्राएं ढूंढने के लिए, 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 में इनका स्टेटस सही तरीके से अपडेट किया गया है या नहीं.