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 में उनकी स्थिति सही तरीके से अपडेट की गई है या नहीं.