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

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

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

उपभोक्ता एसडीके क्या है?

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

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

उपभोक्ता एसडीके का इस्तेमाल क्यों करना चाहिए?

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

उपभोक्ता एसडीके की मदद से, कौन क्या-क्या कर सकता है?

Driver SDK और Fleet Engine से मिली जानकारी का इस्तेमाल करके, उपभोक्ताओं के लिए बेहतर अनुभव बनाया जा सकता है. इसमें ये सुविधाएं शामिल हैं:

  • अपनी ब्रैंडिंग की ज़रूरतों के हिसाब से, मैप के यूज़र इंटरफ़ेस (यूआई) को पसंद के मुताबिक बनाना.

  • वाहन के रूट पर चलने के दौरान, उसकी मौजूदा जगह की जानकारी देखना. साथ ही, समय-समय पर उसकी जगह की जानकारी अपडेट करना.

  • पिकअप और ड्रॉप-ऑफ़ की जगहों के लिए, पहुंचने का अनुमानित समय (ईटीए) दिखाना.

  • बची हुई दूरी दिखाना.

  • रूट पर लाइव ट्रैफ़िक दिखाना.

उपभोक्ता एसडीके कैसे काम करता है

बड़े लेवल पर, उपभोक्ता एसडीके इन तरीकों पर काम करता है:

  • Fleet Engine की सही भूमिकाएं होना, ताकि पुष्टि किया गया कोई ऐप्लिकेशन, उपभोक्ता के ऑर्डर से जुड़ी ट्रिप को फ़ॉलो कर सके.
  • आपके बैकएंड सिस्टम से मिली, उपभोक्ता और ट्रिप के बीच की जानकारी.
  • एसडीके के TripModel और JourneySharingSession क्लास, जो ट्रिप के डेटा को मॉडल करते हैं और उपभोक्ता ऐप्लिकेशन में ट्रिप सेशन शेयर करते हैं.

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

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

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

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

उपभोक्ता एसडीके का इस्तेमाल कैसे करें

अपने उपभोक्ता ऐप्लिकेशन में ट्रिप को फ़ॉलो करने का तरीका देखने के लिए, अपना प्लैटफ़ॉर्म चुनें.

Android

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

iOS

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

JavaScript

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

कॉम्पोनेंट

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

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

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

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

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

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

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

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

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

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

ट्रैक किए गए ऑब्जेक्ट की जगह की जानकारी

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

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

मैप की स्टाइल अपने हिसाब से तय करना

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

ट्रैक की गई जगहों की विज़िबिलिटी कंट्रोल करना

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

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

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

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

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