मांग पर की जाने वाली यात्राओं के लिए, उपभोक्ता अनुभव को बेहतर बनाएं. इसके लिए, उपभोक्ताओं को यात्रा की जानकारी देखने की अनुमति दें. यह जानकारी, ऑर्डर, राइड या आपकी ओर से दी जाने वाली अन्य सेवा से जुड़ी होनी चाहिए.
उपयोगकर्ता 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, अन्य इंटरफ़ेस और क्लास भी उपलब्ध कराता है. इनकी मदद से, ऐप्लिकेशन इस्तेमाल करने का बेहतर अनुभव पाया जा सकता है. इसमें ट्रैफ़िक, मैप मार्कर, ईटीए, और रास्ते की जानकारी जैसी सुविधाएं शामिल की जा सकती हैं.
इस टेबल में, उपभोक्ता ऐप्लिकेशन के ज़रिए यात्रा के फ़्लो को दिखाया गया है.
| 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 में सेव की गई जगह की जानकारी के डेटा का ऐक्सेस कंट्रोल करने के लिए, आपको यह काम करना होगा:
अपने सर्वर पर, Fleet Engine के लिए JSON वेब टोकन (JWT) बनाने वाली सेवा लागू करें. ज़्यादा जानकारी के लिए, JWT जारी करना लेख पढ़ें.
वेब या मोबाइल ऐप्लिकेशन में, पुष्टि करने वाले टोकन को फ़ेच करने की सुविधा लागू करें, ताकि जगह की जानकारी के डेटा को ऐक्सेस करने की पुष्टि की जा सके. टोकन फ़ेचर सेट अप करने के बारे में ज़्यादा जानने के लिए, Android, iOS या JavaScript के लिए सेटअप गाइड देखें.
मैप व्यू और यात्रा ट्रैकर
ट्रिप को फ़ॉलो करने में, वाहनों और वेपॉइंट को विज़ुअलाइज़ करने के कॉम्पोनेंट शामिल होते हैं. साथ ही, इसमें ड्राइवर के ईटीए या ड्राइव करने के लिए बची हुई दूरी के लिए रॉ डेटा फ़ीड भी शामिल होते हैं.
यहां दी गई टेबल में, इन कॉम्पोनेंट के बारे में बताया गया है:
| कॉम्पोनेंट | ब्यौरा |
|---|---|
| उपयोगकर्ता के लिए मैप व्यू | मैप व्यू, यात्रा के लाइफ़साइकल को मैनेज करता है. साथ ही, यात्रा के दौरान वाहनों की जगह की जानकारी के लिए वेपॉइंट दिखाता है. अगर किसी वाहन का रास्ता पता है, तो मैप व्यू, वाहन के रास्ते की पॉलीलाइन को अपडेट करता है. इससे, वाहन के रास्ते की प्रोग्रेस दिखती है. |
| JavaScript में यात्रा की जगह की जानकारी देने वाला एपीआई | JavaScript वेब ऐप्लिकेशन के लिए, यात्रा की जगह की जानकारी देने वाला टूल, ट्रैक किए गए ऑब्जेक्ट की जगह की जानकारी को शेयर किए गए यात्रा के मैप में भेजता है. ज़्यादा जानकारी के लिए, यात्रा की जगह की जानकारी देने वाले प्रोवाइडर को इंस्टैंशिएट करना लेख पढ़ें.
यात्रा की जगह की जानकारी देने वाली सेवा का इस्तेमाल करके, यात्रा के लिए यह जानकारी ट्रैक की जा सकती है:
|
ट्रैक की गई जगह की जानकारी वाले ऑब्जेक्ट
जगह की जानकारी देने वाली सेवा, ऑब्जेक्ट की जगह की जानकारी ट्रैक करती है. जैसे, वेपॉइंट और वाहन. इसके बारे में यहां दी गई टेबल में बताया गया है.
| ट्रैक की गई जगह | ब्यौरा |
|---|---|
| कार लेने की जगह | पिकअप करने की जगह वह जगह होती है जहां से यात्रा शुरू होती है. |
| मंज़िल की जानकारी | मंज़िल की जगह वह जगह होती है जहां यात्रा खत्म होती है. यह कुकी, ड्रॉप ऑफ़ की जगह को मार्क करती है. |
| वेपॉइंट की जगह | वेपॉइंट की जगह, ट्रैक की गई यात्रा के रास्ते में पड़ने वाली कोई भी जगह होती है. तकनीकी तौर पर, वेपॉइंट में पिकअप और ड्रॉपऑफ़ की जगहें शामिल हो सकती हैं. हालांकि, वेपॉइंट का मतलब आम तौर पर रास्ते में पड़ने वाले स्टॉप से होता है. उदाहरण के लिए, डिलीवरी के रास्ते में पिकअप और डेस्टिनेशन के बीच के स्टॉप, वेपॉइंट की जगहें होती हैं. ज़्यादा जानकारी के लिए, Fleet Engine के दस्तावेज़ में यात्रा के वेपॉइंट देखें. |
| वाहन की जगह | वाहन की जगह की जानकारी, वाहन की रिपोर्ट की गई जगह की जानकारी होती है. ज़्यादा जानकारी के लिए, Fleet Engine के दस्तावेज़ में वाहन की जगह की जानकारी देखें. |
अपने मैप को स्टाइल करना
मार्कर और पॉलीलाइन स्टाइल से, मैप पर ट्रैक की गई जगह की जानकारी देने वाले ऑब्जेक्ट का लुक तय होता है. अपने वेब ऐप्लिकेशन की स्टाइल से मैच करने के लिए, कस्टम स्टाइलिंग के विकल्पों का इस्तेमाल किया जा सकता है.
ट्रैक की गई जगहों की जानकारी को कंट्रोल करना
Fleet Engine में पहले से तय किए गए लोकेशन प्रोवाइडर, मैप पर ट्रैक किए गए लोकेशन ऑब्जेक्ट के लिए, दिखने से जुड़े इन नियमों का पालन करते हैं. कस्टम या डिराइव किया गया लोकेशन प्रोवाइडर बनाने पर, दिखने से जुड़े नियमों में बदलाव किया जा सकता है.
वाहन सिर्फ़ तब दिखते हैं, जब यात्रा जारी हो: यात्रा के लिए वाहन तब तक दिखता है, जब तक उसे यात्रा के लिए असाइन किया जाता है और जब तक यात्री को उसके गंतव्य तक नहीं पहुंचा दिया जाता. अगर यात्रा रद्द कर दी जाती है, तो वाहन नहीं दिखता.
जगह के अन्य मार्कर हमेशा दिखते हैं: शुरुआती जगह, मंज़िल, और रास्ते के पॉइंट के लिए जगह के अन्य मार्कर हमेशा मैप पर दिखते हैं. उदाहरण के लिए, यात्रा के दौरान किसी जगह पर छोड़ने या शिपमेंट की डिलीवरी की जगह हमेशा मैप पर दिखती है. भले ही, यात्रा या डिलीवरी की स्थिति कुछ भी हो.
आगे क्या करना है
उस प्लैटफ़ॉर्म का दस्तावेज़ देखें जिस पर आपको यात्राओं को फ़ॉलो करना है: