इस सेक्शन में मौजूद दस्तावेज़ में, 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 को असाइनमेंट की जानकारी दें. दूसरा, वाहन खोजने की सेवा का इस्तेमाल करके वाहन खोजें. इसके लिए, यात्रा और वाहन के एट्रिब्यूट के हिसाब से फ़िल्टर करें, ताकि यात्रा पूरी करने के लिए सबसे सही वाहन खोजा जा सके. खोज के दायरे में मौजूद कोई भी ऑनलाइन वाहन, ड्राइवर SDK से मिले जगह की जानकारी के अपडेट के ज़रिए, अपनी आस-पास की जानकारी देता है.
|
| 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 में सात दिनों तक सक्रिय रहती हैं. इसके बाद, उन्हें हटा दिया जाता है. |
यात्रा के क्रम का फ़्लो
यहां दिए गए डायग्राम में, इस फ़्लो की ज़्यादा जानकारी दी गई है.
