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

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

यात्रा के बाद उपभोक्ता ऐप्लिकेशन

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

Consumer SDK कैसे काम करता है

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

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

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

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

मैप व्यू और यात्रा ट्रैकर

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

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

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

ट्रैक किए गए लोकेशन ऑब्जेक्ट

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

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

अपने मैप की स्टाइल बदलना

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

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

Fleet Engine में पहले से तय किए गए लोकेशन प्रोवाइडर, मैप पर ट्रैक किए गए लोकेशन ऑब्जेक्ट के लिए, इन नियमों का पालन करते हैं. कस्टम या डिराइव किया गया लोकेशन प्रोवाइडर बनाने पर, आपको दिखने से जुड़े नियमों में बदलाव करने का विकल्प मिलता है.

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

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

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

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