Fleet Engine, SearchTripsRequest एंडपॉइंट उपलब्ध कराता है. इसका इस्तेमाल करके, यात्राएं खोजी जा सकती हैं. इस दस्तावेज़ में, दो ऐसे उदाहरण दिए गए हैं जिनमें इस सुविधा का इस्तेमाल किया जा सकता है.
gRPC के लिए SearchTripsRequest या REST के लिए trips.Search देखें.
किसी वाहन के लिए चालू यात्राओं का पता लगाना
किसी फ़ील्ड के लिए चालू यात्राओं का पता लगाने के लिए, SearchTripsRequest
इस मैसेज का इस्तेमाल करके, vehicle_id को उस वाहन पर सेट करें जिसके बारे में जानकारी चाहिए. इसके बाद, active_trips_only को true पर सेट करें.
अपने सिस्टम और Fleet Engine के बीच वाहन की उपलब्धता का मिलान करना
कुछ मामलों में, आपको SearchVehicles से मिले ऐसे नतीजे दिख सकते हैं जो आपके सिस्टम और फ्लीट में उपलब्ध वाहनों से मेल नहीं खाते. ऐसा इसलिए होता है, क्योंकि SearchVehicles या तो चालू ट्रिप वाले वाहन नहीं दिखाता या उन्हें नतीजों की रैंकिंग में नीचे कर देता है. इसकी एक वजह यह है कि जब वाहन यात्राएं पूरी कर लेते हैं, लेकिन यात्रा की स्थिति को COMPLETE या CANCELED पर सही तरीके से सेट नहीं किया जाता है. SearchTrips का इस्तेमाल करके, खुली हुई यात्राएं ढूंढें. इससे वाहनों का आकलन किया जा सकता है, ताकि यह पक्का किया जा सके कि आपके सिस्टम में मौजूद SearchTrips, Fleet Engine के SearchTrips से मेल खाता हो.TripStatus
SearchTrips का इस तरह इस्तेमाल करने के लिए, SearchTripsRequest मैसेज में यह जानकारी सेट करें:
vehicle_idखाली होना चाहिए.active_trips_onlytrueहोनी चाहिए.minimum_stalenessकी वैल्यू, यात्रा की ज़्यादातर अवधियों से ज़्यादा होनी चाहिए. उदाहरण के लिए, एक घंटा.
इस तरह के अनुरोध के नतीजों में ऐसी यात्राएं शामिल होती हैं जो न तो COMPLETE हैं और न ही CANCELED. साथ ही, उन्हें एक घंटे से ज़्यादा समय से अपडेट नहीं किया गया है. इसके बाद, इन यात्राओं की जांच करके यह पक्का किया जा सकता है कि Fleet Engine में इनकी स्थिति सही तरीके से अपडेट की गई है.