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

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

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

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

कंज़्यूमर SDK टूल के काम करने का तरीक़ा जानें.

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

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

JavaScript

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

घटक

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

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

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

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

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

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

मैप व्यू और ट्रिप ट्रैकर

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

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

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

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

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

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

अपने मैप को स्टाइल में ढालना

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

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

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

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

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

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

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