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