उपभोक्ता SDK टूल की, मांग पर उपलब्ध यात्राओं के बारे में खास जानकारी

मांग पर की जाने वाली यात्राओं के लिए, खरीदार के अनुभव को बेहतर बनाएं. इसके लिए, खरीदारों को किसी ऑर्डर, राइड या आपकी ओर से दी जाने वाली अन्य सेवा के लिए, यात्रा को फ़ॉलो करने की अनुमति दें.

यात्रा के बाद, उपभोक्ता ऐप्लिकेशन

Consumer SDK क्या है?

Consumer SDK, मांग पर यात्रा की सुविधा के लिए Fleet Engine का हिस्सा है. यह ऐसे इंटरफ़ेस उपलब्ध कराता है जो यात्रा के डेटा को मॉडल करते हैं और Fleet Engine में यात्राओं को फ़ॉलो करते हैं. साथ ही, यह ऐसी क्लास उपलब्ध कराता है जिनका इस्तेमाल करके, मैप पर आधारित बेहतर डिसप्ले बनाया जा सकता है. इससे उपभोक्ता उपयोगकर्ताओं के साथ यात्राएं शेयर की जा सकती हैं. उपयोगकर्ता अनुभव को बेहतर बनाने के लिए, आपको अपने ऐप्लिकेशन में Consumer SDK को इंटिग्रेट करना होगा. साथ ही, Fleet Engine में सही भूमिका वाली प्रोफ़ाइलें सेट करनी होंगी.

Consumer SDK के प्लैटफ़ॉर्म के हिसाब से एपीआई का इस्तेमाल करके, अपने ऐप्लिकेशन में यात्राएं शेयर करने की सुविधा बनाई जा सकती है. Consumer SDK टूल इन प्लैटफ़ॉर्म के लिए उपलब्ध है:

Consumer SDK का इस्तेमाल क्यों करना चाहिए?

मांग के हिसाब से यात्रा की सुविधा देने वाले ऐप्लिकेशन में Consumer SDK को इंटिग्रेट करने से, उपभोक्ताओं को बेहतर अनुभव दिया जा सकता है. साथ ही, उन्हें रीयल-टाइम में अपडेट की गई सटीक जगह की जानकारी और सड़क के हिसाब से तय की गई पोज़िशन की जानकारी दी जा सकती है. आपके खरीदार, मैप पर वाहन का रास्ता देख सकते हैं. साथ ही, उन्हें यह भी पता चलता है कि वाहन कहां तक पहुंचा है. इससे उन्हें यह समझने में मदद मिलती है कि उनकी राइड या डिलीवरी कहां तक पहुंची है.

Consumer SDK की मदद से क्या-क्या किया जा सकता है?

Driver SDK और Fleet Engine से मिली जानकारी का इस्तेमाल करके, खरीदारों के लिए बेहतर अनुभव बनाया जा सकता है. इसमें ये सुविधाएं शामिल हैं:

  • मैप के यूज़र इंटरफ़ेस (यूआई) को अपनी ब्रैंडिंग की ज़रूरतों के हिसाब से बनाएं.

  • गाड़ी के रास्ते में आगे बढ़ने पर, उसकी मौजूदा जगह की जानकारी को ट्रैक करें. साथ ही, समय-समय पर उसकी जगह की जानकारी अपडेट करें.

  • पिकअप और ड्रॉप-ऑफ़ की जगहों के लिए, पहुंचने का अनुमानित समय (ईटीए) दिखाएं.

  • बची हुई दूरी दिखाओ.

  • रास्ते पर लाइव ट्रैफ़िक दिखाओ.

Consumer SDK के काम करने का तरीका

बड़े लेवल पर, Consumer SDK इन तरीकों पर काम करता है:

  • Fleet Engine की सही भूमिकाएं असाइन की गई हों, ताकि पुष्टि किया गया ऐप्लिकेशन, उपभोक्ता के ऑर्डर से जुड़ी यात्रा को फ़ॉलो कर सके.
  • उपयोगकर्ता और यात्रा के बीच का संबंध, जिसे आपका बैकएंड सिस्टम उपलब्ध कराता है.
  • TripModel और JourneySharingSession एसडीके क्लास, यात्रा के डेटा को मॉडल करती हैं. साथ ही, उपभोक्ता ऐप्लिकेशन में यात्रा के सेशन शेयर करती हैं.

Consumer SDK, अन्य इंटरफ़ेस और क्लास भी उपलब्ध कराता है. इनकी मदद से, ऐप्लिकेशन को बेहतर बनाया जा सकता है. इसमें ट्रैफ़िक, मैप मार्कर, पहुंचने का अनुमानित समय, और रास्ते की जानकारी जैसी सुविधाएं शामिल होती हैं.

Consumer SDK कैसे काम करता है

इस टेबल में, उपभोक्ता ऐप्लिकेशन के ज़रिए यात्रा के फ़्लो को दिखाया गया है.

1 उपभोक्ता एप्लिकेशन ने यात्रा का अनुरोध किया आपके बैकएंड सर्वर को मांग पर ट्रिप का अनुरोध मिलता है. इसके बाद, वह यह काम करता है:
  • यह फ़्लीट इंजन में ट्रिप बनाता है.
  • इससे किसी वाहन को यात्रा असाइन की जाती है.
2 ड्राइवर, यात्रा का अनुरोध स्वीकार करता है ड्राइवर ऐप्लिकेशन को ट्रिप आईडी और ट्रिप की जानकारी मिलती है. इसके बाद, ड्राइवर ट्रिप स्वीकार करता है.
3 उपभोक्ता एप्लिकेशन को यात्रा को फ़ॉलो करने का ऐक्सेस देने का अनुरोध करना उपभोक्ता एप्लिकेशन को आपके बैकएंड से ट्रिप आईडी मिलता है. इसके बाद, वह ट्रिप को फ़ॉलो करने का अनुरोध करता है.
4 ड्राइवर यात्रा शुरू करता है जब ड्राइवर, ड्राइवर ऐप्लिकेशन का इस्तेमाल करके यह बताता है कि यात्रा शुरू हो गई है, तो ऐप्लिकेशन, Driver SDK के ज़रिए आपके बैकएंड सर्वर को इसकी सूचना देता है. उदाहरण के लिए, जब ड्राइवर रेस्टोरेंट से निकलने वाला हो या पिकअप की जगह पर जाने वाला हो.
5 Fleet Engine, यात्रा की जानकारी भेजना शुरू करता है Fleet Engine, यात्रा को ट्रैक करना शुरू कर देता है और उपभोक्ता ऐप्लिकेशन के साथ यात्रा की प्रोग्रेस शेयर करता है.
6 उपभोक्ता एप्लिकेशन में यात्रा की जानकारी दिखती है उपयोगकर्ता को सूचना देने के लिए, उपभोक्ता ऐप्लिकेशन का इस्तेमाल किया जाता है. साथ ही, इसमें यात्रा की जानकारी दिखती है. यात्रा के दौरान, यह जानकारी अपडेट होती रहती है.
7 यात्रा रद्द कर दी गई है या पूरी हो गई है ड्राइवर के ट्रिप रद्द करने या पूरी करने पर, ड्राइवर ऐप्लिकेशन, जगह की जानकारी को ट्रैक करने की सुविधा बंद कर देता है. साथ ही, आपका बैकएंड सर्वर, Fleet Engine को ट्रिप को रद्द या पूरा होने के तौर पर मार्क करने के लिए कहता है.
8 उपभोक्ता ऐप्लिकेशन में यात्रा की जानकारी दिखना बंद हो जाती है यात्रा को रद्द या पूरा हुआ दिखाया जाता है.
9 अगली यात्रा के लिए भी यही प्रोसेस दोहराई जाती है एक नई यात्रा बन जाती है और यह प्रोसेस फिर से शुरू हो जाती है.

Consumer SDK का इस्तेमाल कैसे करें

अपने प्लैटफ़ॉर्म को चुनें, ताकि यह देखा जा सके कि उपभोक्ता ऐप्लिकेशन में यात्राओं को फ़ॉलो करने की सुविधा कैसे शुरू की जाती है.

Android

1 Android में Consumer SDK सेट अप करना अपने ऐप्लिकेशन में मांग के हिसाब से यात्राएं ट्रैक करने के लिए, Consumer SDK सेट अप करें. ज़्यादा जानकारी के लिए, Android Consumer SDK पाना लेख पढ़ें.
2 विज़ुअल इंटरफ़ेस सेट अप करना उपयोगकर्ता अनुभव को सेट अप करने के लिए, मैप तय करें और वेक्टर मैप के लिए सहायता जोड़ें. ज़्यादा जानकारी के लिए, मैप सेट अप करना लेख पढ़ें.
3 किसी यात्रा को फ़ॉलो करना किसी ट्रिप को फ़ॉलो करके, खरीदार के साथ सही वाहन की जगह की जानकारी शेयर करें. ज़्यादा जानकारी के लिए, यात्रा को फ़ॉलो करना लेख पढ़ें.
5 यात्रा की प्रोग्रेस अपडेट करना और यात्रा से जुड़ी गड़बड़ियों को ठीक करना अपनी यात्राओं की जानकारी अपडेट करें. जैसे, यात्रा की दूरी और पहुंचने का अनुमानित समय. साथ ही, यात्रा के दौरान होने वाली किसी भी गड़बड़ी को ठीक करें. ज़्यादा जानकारी के लिए, यात्रा की प्रोग्रेस अपडेट करना और यात्रा से जुड़ी गड़बड़ियों को ठीक करना लेख पढ़ें.
5 यात्रा पूरी होने पर, फ़ॉलो करना बंद करें किसी ट्रिप को फ़ॉलो करना बंद करें, ताकि खरीदार के साथ गाड़ी की जगह की जानकारी शेयर न की जा सके. ज़्यादा जानकारी के लिए, यात्रा को फ़ॉलो करना बंद करना लेख पढ़ें.

iOS

1 iOS में Consumer SDK सेट अप करना अपने ऐप्लिकेशन में मांग के हिसाब से यात्राएं ट्रैक करने के लिए, Consumer SDK सेट अप करें. ज़्यादा जानकारी के लिए, iOS Consumer SDK पाना लेख पढ़ें.
2 विज़ुअल इंटरफ़ेस सेट अप करना उपयोगकर्ता अनुभव को सेट अप करने के लिए, मैप व्यू को शुरू करें और मैप इवेंट मैनेज करें. ज़्यादा जानकारी के लिए, मैप सेट अप करना लेख पढ़ें.
3 किसी यात्रा को फ़ॉलो करना किसी ट्रिप को फ़ॉलो करके, खरीदार के साथ सही वाहन की जगह की जानकारी शेयर करें. ज़्यादा जानकारी के लिए, यात्रा को फ़ॉलो करना लेख पढ़ें.
5 यात्रा की प्रोग्रेस अपडेट करना और यात्रा से जुड़ी गड़बड़ियों को ठीक करना अपनी यात्राओं की जानकारी अपडेट करें. जैसे, यात्रा की दूरी और पहुंचने का अनुमानित समय. साथ ही, यात्रा के दौरान होने वाली किसी भी गड़बड़ी को ठीक करें. ज़्यादा जानकारी के लिए, यात्रा की प्रोग्रेस अपडेट करना और यात्रा से जुड़ी गड़बड़ियों को ठीक करना लेख पढ़ें.
5 यात्रा पूरी होने पर, फ़ॉलो करना बंद करें किसी ट्रिप को फ़ॉलो करना बंद करें, ताकि खरीदार के साथ गाड़ी की जगह की जानकारी शेयर न की जा सके. ज़्यादा जानकारी के लिए, यात्रा को फ़ॉलो करना बंद करना लेख पढ़ें.

JavaScript

1 JavaScript में Consumer SDK सेट अप करना अपने ऐप्लिकेशन में मांग के हिसाब से यात्राएं ट्रैक करने के लिए, Consumer SDK सेट अप करें. ज़्यादा जानकारी के लिए, JavaScript Consumer SDK सेट अप करना लेख पढ़ें.
2 मैप लोड करना और उसे पसंद के मुताबिक बनाना Maps JavaScript API चालू करें और उपभोक्ता अनुभव को सेट अप करने के लिए अनुमति सेट अप करें. ज़्यादा जानकारी के लिए, मैप सेट अप करना लेख पढ़ें.
3 किसी यात्रा को फ़ॉलो करना किसी ट्रिप को फ़ॉलो करके, खरीदार के साथ सही वाहन की जगह की जानकारी शेयर करें. ज़्यादा जानकारी के लिए, यात्रा को फ़ॉलो करना लेख पढ़ें.
5 यात्रा की प्रोग्रेस अपडेट करना और यात्रा से जुड़ी गड़बड़ियों को ठीक करना अपनी यात्राओं की जानकारी अपडेट करें. जैसे, यात्रा की दूरी और पहुंचने का अनुमानित समय. साथ ही, यात्रा के दौरान होने वाली किसी भी गड़बड़ी को ठीक करें. ज़्यादा जानकारी के लिए, यात्रा की प्रोग्रेस को अपडेट करना और उसे फ़ॉलो करना और यात्रा से जुड़ी गड़बड़ियों को ठीक करना लेख पढ़ें.
5 यात्रा पूरी होने पर, फ़ॉलो करना बंद करें किसी ट्रिप को फ़ॉलो करना बंद करें, ताकि खरीदार के साथ गाड़ी की जगह की जानकारी शेयर न की जा सके. ज़्यादा जानकारी के लिए, यात्रा को फ़ॉलो करना बंद करना लेख पढ़ें.

घटक

इस सेक्शन में, यात्रा को फ़ॉलो करने के लिए ज़रूरी दो कॉम्पोनेंट के बारे में खास जानकारी दी गई है:

इसके अलावा, इन कॉम्पोनेंट का इस्तेमाल करके, उपभोक्ता के अनुभव को अपनी पसंद के मुताबिक बनाया जा सकता है:

पुष्टि करने वाला टोकन फ़ेचर

Fleet Engine में सेव की गई जगह की जानकारी के डेटा का ऐक्सेस कंट्रोल करने के लिए, आपको यह काम करना होगा:

  1. अपने सर्वर पर, Fleet Engine के लिए JSON वेब टोकन (JWT) बनाने की सेवा लागू करें. ज़्यादा जानकारी के लिए, JWT जारी करना लेख पढ़ें.

  2. जगह की जानकारी के डेटा का ऐक्सेस पाने की पुष्टि करने के लिए, अपने वेब या मोबाइल ऐप्लिकेशन में पुष्टि करने वाला टोकन फ़ेचर लागू करें. टोकन फ़ेचर सेट अप करने के बारे में ज़्यादा जानने के लिए, Android, iOS या JavaScript के लिए सेटअप गाइड देखें.

मैप व्यू और यात्रा ट्रैक करने की सुविधा

ट्रिप को फ़ॉलो करने में, वाहनों और वेपॉइंट के विज़ुअलाइज़ेशन के साथ-साथ ड्राइवर के ईटीए या ड्राइव करने के लिए बची हुई दूरी के रॉ डेटा फ़ीड शामिल होते हैं.

यहां दी गई टेबल में, इन कॉम्पोनेंट के बारे में बताया गया है:

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

ट्रैक की गई जगह की जानकारी वाले ऑब्जेक्ट

जगह की जानकारी देने वाली सेवा, ऑब्जेक्ट की जगह की जानकारी ट्रैक करती है. जैसे, वेपॉइंट और वाहन. इसके बारे में यहां दी गई टेबल में बताया गया है.

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

अपने मैप को बेहतर बनाना

मार्कर और पॉलीलाइन स्टाइल से, मैप पर ट्रैक की गई जगह की जानकारी देने वाले ऑब्जेक्ट का लुक और फ़ील तय होता है. अपने वेब ऐप्लिकेशन की स्टाइल से मैच करने के लिए, कस्टम स्टाइलिंग के विकल्पों का इस्तेमाल किया जा सकता है.

ट्रैक की गई जगहों की जानकारी को कंट्रोल करना

Fleet Engine में पहले से तय किए गए लोकेशन प्रोवाइडर, मैप पर ट्रैक किए गए लोकेशन ऑब्जेक्ट के लिए, दिखने से जुड़े इन नियमों का पालन करते हैं. अगर आपने कस्टम या डिराइव किया गया लोकेशन प्रोवाइडर बनाया है, तो आपके पास दिखने से जुड़े नियमों को बदलने का विकल्प होता है.

  • वाहन सिर्फ़ यात्रा के दौरान दिखते हैं: यात्रा के लिए वाहन तब तक दिखता है, जब तक उसे यात्रा के लिए असाइन किया जाता है और जब तक वह यात्री को उसके गंतव्य तक नहीं पहुंचा देता. अगर यात्रा रद्द कर दी जाती है, तो वाहन नहीं दिखता.

  • जगह के अन्य सभी मार्कर हमेशा दिखते हैं: शुरुआती जगह, डेस्टिनेशन, और वेपॉइंट के लिए जगह के अन्य सभी मार्कर, मैप पर हमेशा दिखते हैं. उदाहरण के लिए, किसी यात्रा के दौरान छोड़े जाने की जगह या शिपमेंट की डिलीवरी की जगह हमेशा मैप पर दिखती है. भले ही, यात्रा या डिलीवरी की स्थिति कुछ भी हो.

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

उस प्लैटफ़ॉर्म का दस्तावेज़ देखें जिस पर आपको यात्राएँ ट्रैक करनी हैं: