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