मांग पर यात्रा की सुविधा क्या है?

इस सेक्शन में दिए गए दस्तावेज़ में, Google Maps Mobility की ऑन-डिमांड यात्रा की सेवा का इस्तेमाल करके, यात्राएं बनाने और उनका इस्तेमाल करने का तरीका बताया गया है. यह मान लेता है कि नीचे दी गई चीज़ों से जानकारी है:

• Fleet Engine: आपको Fleet Engine को लागू करने की जानकारी, अनुरोध करने के तरीके, और सुरक्षा के बारे में पता होना चाहिए. इसके लिए, Fleet Engine सेवा क्या है? लेख पढ़ें. साथ ही, Fleet Engine सेट अप करना लेख में सुरक्षा से जुड़े विषयों के बारे में जानें.
• मांग पर उपलब्ध सेवाओं के लिए, वाहन के बारे में बुनियादी बातें. वाहनों के बारे में जानकारी देखें.
• मांग पर मिलने वाली सेवाओं के लिए, यात्रा की बुनियादी जानकारी. ऑन-डिमांड यात्राएं देखें.

TripService का इस्तेमाल gRPC और REST के लिए किया जा सकता है. आसानी से समझने के लिए, फ़ील्ड रेफ़रंस gRPC के नियमों का पालन करते हैं.

ऑन-डिमांड सेवाओं के लिए Fleet Engine में, यात्रा एक तरह की प्रोसेस है. इसमें, आपके उपभोक्ताओं के खाने की डिलीवरी या सफ़र के अनुरोध को पूरा करने का मॉडल बनाया जाता है. सफ़र के दौरान, आपकी ओर से फ़्लीट इंजन को यात्रा का स्टेटस भेजा जाता है. जैसे, NEW, ENROUTE_TO_PICKUP वगैरह. यात्रा का स्टेटस, वाहन को असाइन किए गए जगह की जानकारी वाले वॉइसपॉइंट से जुड़ा होता है. साथ ही, Fleet Engine, यात्रा के हर अपडेट के साथ वाहन के इन वॉइसपॉइंट में बदलाव करता है. यात्राओं और वाहनों के बीच के संबंध के बारे में ज़्यादा जानने के लिए, Fleet Engine की ज़रूरी जानकारी में यात्राएं ऑन डिमांड देखें.

यात्रा की जानकारी

Fleet Engine में हर ट्रिप को ट्रैक करने के लिए, आपको पहले एक Trip इकाई बनानी होगी. रेफ़रंस के लिए, gRPC या REST देखें.

नीचे दी गई टेबल में, आपके सिस्टम में बनाई गई यात्रा के शुरू से लेकर आखिर तक फ़्लो और फ़्लीट इंजन में इसकी लाइफ़साइकल स्टेज के उदाहरण के बारे में बताया गया है. यह मान लिया जाता है कि आपने फ़्लीट इंजन सेट अप कर लिया है और आपके पास यात्रा के लिए असाइन करने के लिए एक वाहन है. साथ ही, ड्राइवर ऐप्लिकेशन में जगह की जानकारी के अपडेट चालू हैं. ड्राइवर के लिए SDK टूल: ऑन-डिमांड यात्राएं देखें.

1	बुकिंग का अनुरोध पाना.	फ़्लीट इंजन की यात्रा शुरू होने से पहले, आपके बुकिंग सिस्टम को उपभोक्ता से, आपके ऐप्लिकेशन या दूसरे बुकिंग सिस्टम से राइड या डिलीवरी का अनुरोध मिलता है. इसके बाद, आपका सिस्टम CreateTrip का इस्तेमाल करके, ज़रूरी फ़ील्ड के साथ सफ़र की इकाई बनाता है. जैसे, पिकअप की जगह. यह इस समय अन्य फ़ील्ड भी सेट कर सकता है, जैसे कि यात्री और ड्रॉपऑफ़ की जगह. इसके अलावा, यह तब तक इंतज़ार भी कर सकता है, जब तक कि कोई वाहन असाइन न कर दिया जाए. सिर्फ़ एक डेस्टिनेशन वाली यात्रा बनाना देखें.
2	वाहन असाइन करें.	आपके पास अपने सिस्टम में जाकर, सीधे तौर पर राइड के लिए वाहन असाइन करने और Fleet Engine को असाइनमेंट की रिपोर्ट भेजने का विकल्प है. इसके अलावा, वाहन खोजें सेवा का इस्तेमाल करके, वाहन खोजे जा सकते हैं. इसके लिए, राइड और वाहन, दोनों के एट्रिब्यूट के हिसाब से फ़िल्टर किया जा सकता है, ताकि यात्रा पूरी करने के लिए सबसे अच्छा वाहन ढूंढा जा सके. खोज के दायरे में मौजूद कोई भी ऑनलाइन वाहन, Driver SDK टूल की मदद से जगह की जानकारी के अपडेट के ज़रिए अपनी जगह की जानकारी देता है. जब SearchVehicle किसी ऐसे वाहन की जानकारी दिखाता है जिसे आपने किसी यात्रा से मैच किया है, तो आपका सिस्टम UpdateTrip एंडपॉइंट को कॉल करता है. इससे, NEW यात्रा के लिए असाइन किए गए वाहन आईडी की जानकारी मिलती है.
3	यात्रा की जानकारी अपडेट करें.	जब ड्राइवर यात्रा स्वीकार कर लेता है और पिकअप की जगह पर नेविगेट करना शुरू करता है, तो आपका सिस्टम, यात्रा की स्थिति को NEW से ENROUTE_TO_PICKUP में अपडेट कर देता है. ऐप्लिकेशन से आपके बैकएंड से सीधे कनेक्शन के ज़रिए या पोलिंग फ़्लीट इंजन के ज़रिए, यात्रा के दौरान गाड़ी की जगह की जानकारी पोल करते रहें. पोलिंग फ़्लीट इंजन को ड्राइवर SDK टूल से, गाड़ी की जगह की जानकारी के लगातार अपडेट मिलते रहते हैं. इसके बाद, आपका सिस्टम, फ़्लेट इंजन को यात्रा के हर माइलस्टोन की जानकारी देता है. फ़्लेट इंजन, इस जानकारी के आधार पर वाहन के वेपॉइंट की सूची अपडेट करता है.
4	उपयोगकर्ता के साथ अपनी यात्रा शेयर करें.	Fleet Engine, यात्रा की जानकारी और वाहन की जगह की जानकारी को ग्राहक के लिए बने एसडीके टूल के लिए उपलब्ध कराता है. यह टूल, यात्रा के अपडेट पाने और उन्हें ग्राहक के ऐप्लिकेशन में दिखाने के लिए, किसी लिसनर का इस्तेमाल करता है. Fleet Engine, ईटीए, बाकी बची दूरी, रास्तों, और वाहन के बाकी बचे रास्ते में रुकने की जगहों की जानकारी अपने-आप अपडेट करता है. ज़्यादा जानकारी के लिए, ऑन-डिमांड यात्राओं के लिए यात्रा की जानकारी शेयर करना देखें.
5	पूरी यात्रा.	जब वाहन, यात्रा के डेस्टिनेशन वेपॉइंट पर पहुंच जाता है और आपका ड्राइवर यह बताता है कि यात्रा पूरी हो गई है, तो आपका सिस्टम, Fleet Engine में TripStatus को COMPLETE पर सेट कर देता है. ध्यान रखें कि वाहनों की तरह ही, यात्रा की इकाइयां भी Fleet Engine में सात दिनों तक चालू रहती हैं. भले ही, उनकी स्थिति कुछ भी हो. सात दिन बाद, उन्हें हटा दिया जाता है.

यात्रा के क्रम का फ़्लो

इस डायग्राम में, इस फ़्लो के बारे में ज़्यादा जानकारी दी गई है.

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

• सिर्फ़ एक डेस्टिनेशन की यात्रा बनाना