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