Android के लिए Consumer SDK टूल का क्विक रेफ़रंस

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: सेटअप

Android पैकेज के लिए आधिकारिक Consumer SDK:

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-consumer

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 में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.