यात्राएं खोजें

Fleet Engine, SearchTripsRequest एंडपॉइंट उपलब्ध कराता है. इसका इस्तेमाल, यात्राएं ढूंढने के लिए किया जा सकता है. इस दस्तावेज़ में, ऐसे दो परिदृश्यों के बारे में बताया गया है जिनमें इस सुविधा का इस्तेमाल किया जा सकता है.

gRPC के लिए SearchTripsRequest या REST के लिए trips.Search देखें.

ध्यान दें: यात्राएं, Fleet Engine में सात दिनों तक चालू रहती हैं. इसके बाद, उन्हें मिटा दिया जाता है. इसलिए, SearchTrips में सिर्फ़ वे यात्राएं दिखती हैं जो पिछले सात दिनों में चालू रही हैं.

किसी वाहन के लिए चालू यात्राएं ढूंढना

किसी खास फ़ील्ड के लिए चालू यात्राएं ढूंढने के लिए, 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 में उनका स्टेटस सही तरीके से अपडेट किया गया हो.

आगे क्या करना है

• यात्रा मिटाना