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

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

  • 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 में उसकी लाइफ़साइकल के चरणों का उदाहरण दिया गया है. इसमें यह माना गया है कि आपने Fleet Engine सेट अप कर लिया है और आपके पास यात्रा के लिए कोई वाहन है. साथ ही, ड्राइवर ऐप्लिकेशन में जगह की जानकारी के अपडेट की सुविधा चालू है. ड्राइवर SDK: ऑन-डिमांड यात्राएं लेख पढ़ें.

1 बुकिंग का अनुरोध पाना. Fleet Engine में यात्रा शुरू होने से पहले, आपका बुकिंग सिस्टम, आपके ऐप्लिकेशन या अन्य बुकिंग सिस्टम के ज़रिए, ग्राहक से राइड या डिलीवरी का अनुरोध पाता है. इसके बाद, आपका सिस्टम, CreateTrip का इस्तेमाल करके यात्रा की इकाई बनाता है. इसमें पिकअप की जगह जैसी ज़रूरी फ़ील्ड शामिल होती हैं. इस चरण में, अन्य फ़ील्ड भी सेट की जा सकती हैं. जैसे, यात्रियों की संख्या और ड्रॉप ऑफ़ की जगह. इसके अलावा, वाहन असाइन होने तक इंतज़ार किया जा सकता है. एक डेस्टिनेशन वाली यात्रा बनाना लेख पढ़ें.
2 वाहन असाइन करना.

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

SearchVehicle से ऐसा वाहन मिलने के बाद जिसे आपने यात्रा के लिए चुना है, आपका सिस्टम, UpdateTrip एंडपॉइंट को कॉल करके, NEW यात्रा के लिए असाइन किए गए वाहन की आईडी की जानकारी देता है.

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

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

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

TripSequenceDiagram

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