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 में मौजूद TripStatus से मेल खाता है.
SearchTrips का इस्तेमाल इस तरह करने के लिए, SearchTripsRequest मैसेज में यह सेट करें:
vehicle_idखाली होना चाहिए.active_trips_onlyकी वैल्यूtrueहोनी चाहिए.minimum_staleness, ज़्यादातर यात्राओं के कुल समय से ज़्यादा होना चाहिए. उदाहरण के लिए, एक घंटा.
इस तरह के अनुरोध के नतीजों में, ऐसी यात्राएं शामिल होती हैं जो न तो COMPLETE हैं और न ही
CANCELED. साथ ही, उन्हें एक घंटे से ज़्यादा समय से अपडेट नहीं किया गया है. इसके बाद, इन यात्राओं की जांच करके यह पक्का किया जा सकता है कि Fleet Engine में इनका स्टेटस सही तरीके से अपडेट किया गया है या नहीं.