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

ऑन-डिमांड यात्राओं के लिए, उपभोक्ताओं को बेहतर अनुभव दें. इसके लिए, उन्हें किसी ऑर्डर, राइड या आपकी दी जाने वाली अन्य सेवा के लिए, यात्रा के दौरान अपडेट पाने की सुविधा दें.

किसी यात्रा के बाद, उपभोक्ता के इस्तेमाल किया गया ऐप्लिकेशन

Consumer SDK टूल क्या है?

ऑन-डिमांड यात्राओं के लिए, Consumer SDK टूल, 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 SDK क्लास, जो यात्रा के डेटा को मॉडल करती हैं और उपभोक्ता ऐप्लिकेशन में यात्रा के सेशन शेयर करती हैं.

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

Consumer SDK टूल के काम करने का तरीका

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

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

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

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

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

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