Android के लिए Consumer SDK, मांग पर यात्रा की सुविधा देने वाले Fleet Engine का हिस्सा है. यह ऐसे इंटरफ़ेस उपलब्ध कराता है जो यात्रा के डेटा को मॉडल करते हैं और Fleet Engine में यात्राओं को ट्रैक करते हैं. साथ ही, यह ऐसी क्लास उपलब्ध कराता है जिनकी मदद से मैप पर आधारित डिसप्ले बनाया जा सकता है. यह डिसप्ले, Android ऐप्लिकेशन में उपभोक्ताओं के साथ यात्रा की प्रोग्रेस (वाहन की जगह की जानकारी, रास्ता, ईटीए, बची हुई दूरी, ट्रैफ़िक) शेयर करता है.
Android के लिए Consumer SDK: मुख्य बातें
- प्रॉडक्ट: Android के लिए Consumer SDK
- इसे इस नाम से भी जाना जाता है: Android Consumer SDK, Consumer SDK, Mobility Services मांग पर Trips Android Consumer SDK
- कैटगरी: रास्ते
- प्लैटफ़ॉर्म: Android
- इस पर काम करता है: क्लाइंट (ऐप्लिकेशन या ब्राउज़र कोड)
- लॉन्च स्टेज: GA
- लाइफ़साइकल: चालू है
- खास जानकारी: Android के लिए Consumer SDK के बारे में खास जानकारी
Android के लिए Consumer SDK: इसका इस्तेमाल कब करना चाहिए
Android के लिए Consumer SDK का इस्तेमाल तब करें, जब:
- आपको अपने Android ऐप्लिकेशन में उपभोक्ताओं को, मांग पर की जाने वाली यात्रा (राइड, ऑर्डर या डिलीवरी) को फ़ॉलो करने की सुविधा देनी होगी. इस यात्रा को आपका बैकएंड, Fleet Engine में ट्रैक करता है.
- आपको Android उपभोक्ता ऐप्लिकेशन में, मैप पर किसी वाहन की रीयल-टाइम के आस-पास की, सड़क पर मौजूद जगह की जानकारी और रास्ता दिखाना है.
- आपको Android पर Fleet Engine की यात्रा के लिए, पिकअप और ड्रॉप-ऑफ़ का ईटीए, बची हुई दूरी, और लाइव ट्रैफ़िक की जानकारी दिखानी है.
- आपको Android में यात्रा की जानकारी शेयर करने वाले मैप के लिए, यात्रा के मार्कर, रास्ते की पॉलीलाइन या मैप की स्टाइल को पसंद के मुताबिक बनाना है.
Android के लिए Consumer SDK का इस्तेमाल तब न करें, जब:
- आपको iOS ऐप्लिकेशन में, ऑन-डिमांड यात्राओं के लिए यात्रा की जानकारी शेयर करने की सुविधा चाहिए. इसके बजाय, iOS के लिए Consumer SDK का इस्तेमाल करें.
- आपको किसी वेब पेज पर यात्रा की जानकारी शेयर करनी हो या शिपमेंट जैसे शेड्यूल किए गए टास्क के लिए उपभोक्ता को ट्रैक करना हो. इसके बजाय, JavaScript Consumer SDK का इस्तेमाल करें.
- आपको ड्राइवर के Android ऐप्लिकेशन से, ड्राइवर की जगह की जानकारी और यात्रा की प्रोग्रेस की जानकारी देनी होगी. इसके बजाय, Driver SDK for Android का इस्तेमाल करें.
Android के लिए Consumer SDK: सेटअप
- पुष्टि करना: JSON वेब टोकन (JWT), एपीआई पासकोड
- इन्हें भी चालू करें: Fleet Engine सेवा, Android के लिए Maps SDK
- शुरू करें: Android के लिए Consumer SDK सेट अप करना
- रेफ़रंस: Android के लिए Consumer SDK टूल का रेफ़रंस
- नीतियां: Android के लिए Consumer SDK की नीतियां
- रिलीज़ नोट: Android के लिए Consumer SDK के रिलीज़ नोट
Android पैकेज के लिए आधिकारिक Consumer SDK:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-consumer
Consumer SDK for Android: इससे जुड़े प्रॉडक्ट
- आम तौर पर, इनका इस्तेमाल इनके साथ किया जाता है: Fleet Engine Service, Android के लिए Driver SDK, Android के लिए Maps SDK
Consumer SDK for Android: आम तौर पर होने वाली गलतियां
- समस्या: अगर Maps SDK टूल की डिपेंडेंसी को किसी खास वर्शन पर सेट नहीं किया गया है, तो Consumer SDK टूल, Maps SDK टूल के ज़रूरी वर्शन का इस्तेमाल करता है. इससे उन ऐप्लिकेशन पर असर पड़ सकता है जो Maps SDK टूल के बाद के वर्शन में मौजूद सुविधाओं पर निर्भर हैं. ठीक करने का तरीका: Gradle या Maven में,
transportation-consumerके साथ-साथplay-services-mapsका साफ़ तौर पर तय किया गया वर्शन बताएं. /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project देखें. - समस्या: यात्रा खत्म होने के बाद, यात्रा की जानकारी शेयर करने की सुविधा बंद न करने से, Fleet Engine को नेटवर्क के अनुरोध बेवजह भेजे जाते हैं और मेमोरी लीक होती है. ठीक करें: जब यात्रा की ज़रूरत न हो, तब
JourneySharingSession.stop()को कॉल करें. उदाहरण के लिए,onDestroy()में या जब यात्राCOMPLETEहो. /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey देखें. - समस्या: अगर एपीआई इंस्टेंस पहले से मौजूद है, तो
ConsumerApi.initialize()एक अपवाद दिखाता है (2.0.0 और इसके बाद के वर्शन). ठीक करने का तरीका: पहलेConsumerApi.getInstance()को कॉल करें और दिखाए गएTaskकी जांच करके पता लगाएं कि कोई इंस्टेंस पहले से मौजूद है या नहीं. /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android देखें. - समस्या: Consumer SDK के तीसरे और इससे पहले के वर्शन में, फ़ुल R8 मोड काम नहीं करता. AGP 8.0 और इसके बाद के वर्शन को टारगेट करने वाले ऐप्लिकेशन में, बिल्ड या रनटाइम से जुड़ी समस्याएं आ सकती हैं. ठीक करने का तरीका: AGP 8.0 या इसके बाद के वर्शन को टारगेट करते समय,
android.enableR8.fullMode=falseसेट करें. साथ ही, Consumer SDK 3.0 या इसके बाद के वर्शन के लिए, Kotlin 2.0 के साथ AGP 7.3 या इसके बाद के वर्शन का इस्तेमाल करें. /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3 देखें.
Android के लिए Consumer SDK: लेगसी और अब काम न करने वाली सुविधाएं
ConsumerTrip,ConsumerTripCallback,ConsumerTripManager,ConsumerTripOptions: इसे 15-09-2023 से बंद कर दिया गया है. बदलाव:TripModel,TripModelCallback,TripModelManager,TripModelOptions. माइग्रेट करने से जुड़ी गाइड देखें.Tripक्लास औरTrip.TripStatus/Trip.TripTypeएनोटेशन (औरTripInfo#getTripStatus(),TripInfo#getTripType(),TripModelCallback#onTripStatusUpdated): 15-09-2023 से इस्तेमाल नहीं किया जा सकता. बदला गया:TripInfo.TripStatus/TripInfo.TripType,TripInfo#getCurrentTripStatus(),TripInfo#getCurrentTripType(),TripModelCallback#onTripStatusUpdate. माइग्रेट करने से जुड़ी गाइड देखें.MarkerStyleOptionsऔरPolylineStyleOptions: 30-11-2021 से बंद कर दिया गया है. बदलाव:MarkerOptionsऔरPolylineOptions(Maps SDK के साथ शेयर किया गया). लक्षण: Consumer SDK, हर मार्कर या पॉलीलाइन टाइप के लिए अपनी डिफ़ॉल्ट स्टाइल लागू करता है, न किMarkerOptionsकी डिफ़ॉल्ट स्टाइल. माइग्रेट करने से जुड़ी गाइड देखें.- निजी रिपॉज़िटरी डिस्ट्रिब्यूशन चैनल: अब काम नहीं करता. विकल्प: Google Maven रिपॉज़िटरी (2.1.0 और इसके बाद के वर्शन). माइग्रेट करने से जुड़ी गाइड देखें.
Consumer SDK for Android की मदद से क्या-क्या किया जा सकता है
हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.
- अपनी पसंद के मुताबिक बनाया जा सकने वाला इंटरैक्टिव मैप जोड़ें. यह मैप, Fleet Engine से मोबाइल ऐप्लिकेशन तक की यात्रा की प्रोग्रेस को ट्रैक करता है.
- किसी वेब पेज या मोबाइल ऐप्लिकेशन पर मौजूद मैप पर, Fleet Engine से यात्रा को ट्रैक करने वाली रूट पॉलीलाइन जोड़ें.
- Fleet Engine की मदद से बुक की गई यात्रा के लिए, वेब पेज या मोबाइल ऐप्लिकेशन पर मैप में किसी रास्ते पर यात्रा की प्रोग्रेस अपडेट करना.
- Fleet Engine से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, सड़कों, पॉलीलाइन, और पॉलीगॉन की स्टाइल बदलना.
- Fleet Engine से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, मैप की सुविधाएं दिखाएं या छिपाएं.
- Fleet Engine से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, आइकॉन और टेक्स्ट लेबल की स्टाइल बदलना.
- Fleet Engine से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, ज़ूम करने के अलग-अलग लेवल के लिए अलग-अलग मैप स्टाइल लागू करना.
- Fleet Engine से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, जगहों की डेंसिटी बदलना. एक्सपेरिमेंटल ध्यान दें: Consumer SDK में, क्लाउड पर आधारित मैप स्टाइलिंग की सुविधा GA है. वहीं, लोकप्रिय जगहों की डेंसिटी कंट्रोल करने की सुविधा, क्लाउड पर आधारित मैप स्टाइलिंग की एक्सपेरिमेंटल सुविधा है. यह सुविधा सिर्फ़ लाइट मैप स्टाइल पर काम करती है.
- Fleet Engine से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, बिल्डिंग की स्टाइल बदलें. एक्सपेरिमेंटल ध्यान दें: Consumer SDK में, क्लाउड पर मैप की स्टाइलिंग की सुविधा, सामान्य तौर पर उपलब्ध है. हालांकि, 3D और फ़ुटप्रिंट बिल्डिंग स्टाइल को पसंद के मुताबिक बनाने की सुविधा, क्लाउड पर मैप की स्टाइलिंग की एक एक्सपेरिमेंटल सुविधा है. यह सुविधा सिर्फ़ लाइट मैप स्टाइल पर काम करती है.
- Fleet Engine से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, लैंडमार्क की स्टाइल बदलना. एक्सपेरिमेंटल ध्यान दें: Consumer SDK में, क्लाउड पर मैप की स्टाइलिंग की सुविधा GA है. वहीं, लैंडमार्क आइकॉन को पसंद के मुताबिक बनाने की सुविधा, क्लाउड पर मैप की स्टाइलिंग की एक्सपेरिमेंटल सुविधा है. यह सुविधा सिर्फ़ लाइट मैप स्टाइल पर काम करती है.
- मैप पर मार्कर को पसंद के मुताबिक बनाएं. इससे Fleet Engine से यात्रा की प्रोग्रेस को ट्रैक किया जा सकता है.
- Fleet Engine से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, रास्ते की पॉलीलाइन को पसंद के मुताबिक बनाएं.