Android के लिए Driver SDK टूल के बारे में खास जानकारी

Android के लिए Driver SDK, ड्राइवर ऐप्लिकेशन के लिए एक मोबाइल टूलकिट है. यह Navigation SDK से Fleet Engine को वाहन की जगह की जानकारी, रास्ते, बची हुई दूरी, और ईटीए के अपडेट भेजता है. यह मांग पर यात्राओं और शेड्यूल किए गए टास्क, दोनों के साथ काम करता है.

Android के लिए Driver SDK: मुख्य बातें

  • प्रॉडक्ट: Driver SDK for Android
  • इसे इस नाम से भी जाना जाता है: ड्राइवर एसडीके, मांग पर यात्राओं के लिए ड्राइवर एसडीके, शेड्यूल किए गए टास्क के लिए ड्राइवर एसडीके
  • कैटगरी: रास्ते
  • प्लैटफ़ॉर्म: Android
  • इस पर काम करता है: क्लाइंट (ऐप्लिकेशन या ब्राउज़र कोड)
  • लॉन्च स्टेज: GA
  • लाइफ़साइकल: चालू है
  • खास जानकारी: Android के लिए Driver SDK के बारे में खास जानकारी

Driver SDK for Android: इसका इस्तेमाल कब करना चाहिए

Android के लिए Driver SDK का इस्तेमाल तब करें, जब:

  • Fleet Engine को वाहन की जगह की रीयल-टाइम जानकारी और रास्ते के अपडेट भेजने के लिए, आपको Android ड्राइवर ऐप्लिकेशन की ज़रूरत होगी.
  • Navigation SDK से, अगले वेपॉइंट तक की बची हुई दूरी और ईटीए की जानकारी पाने के लिए, आपको Fleet Engine की ज़रूरत होगी.
  • आपको एक ऐसा ड्राइवर ऐप्लिकेशन चाहिए जो असाइन की गई मांग पर यात्राओं या शेड्यूल किए गए टास्क को मैनेज करे और नेविगेशन की सुविधा भी दे.

Android के लिए Driver SDK का इस्तेमाल तब न करें, जब:

  • आपको अपने ऐप्लिकेशन में सिर्फ़ रास्ते के दिशा-निर्देश की सुविधा चाहिए और आपको Fleet Engine का इस्तेमाल नहीं करना है. इसके बजाय, Android के लिए Navigation SDK का इस्तेमाल करें.
  • आपको वाहन के डेटा से जुड़े अपडेट भेजने होंगे. इनमें जगह की जानकारी, रास्ता, दूरी, और ईटीए शामिल नहीं हैं. ये अपडेट आपके बैकएंड से भेजे जाते हैं. इसके बजाय, Fleet Engine Service का इस्तेमाल करें.
  • iOS के लिए ड्राइवर ऐप्लिकेशन बनाना. इसके बजाय, iOS के लिए Driver SDK का इस्तेमाल करें.

Android के लिए Driver SDK: सेटअप

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

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-driver
  • maven: com.google.android.libraries.navigation:navigation

Driver SDK for Android: सामान्य गलतियां

  • समस्या: अगर बिल्ड डिपेंडेंसी में ड्राइवर एसडीके का वर्शन नहीं बताया गया है, तो आईडीई सबसे नया वर्शन लोड करता है. वर्शन 7.0.0 से, नए बिल्ड अब Android 6 और 7 (एपीआई 23-25) के साथ काम नहीं करते. समाधान: अपनी बिल्ड डिपेंडेंसी में, Android के लिए Driver SDK का कोई वर्शन तय करें. इससे आपको यह कंट्रोल करने में मदद मिलेगी कि ओएस के लिए ज़रूरी कम से कम वर्शन कब बदला जाए. /maps/documentation/mobility/services/resources/relnotes_driver_sdk_android देखें.
  • समस्या: ड्राइवर SDK टूल, Navigation SDK टूल पर निर्भर करता है. Navigation SDK टूल के किसी वर्शन को पिन किए बिना, प्रोजेक्ट हमेशा मेजर वर्शन में Navigation SDK टूल का नया वर्शन डाउनलोड करता है. समस्या हल करने का तरीका: Driver SDK और Navigation SDK, दोनों की डिपेंडेंसी जोड़ें. अगर आपको Navigation SDK को पिन करना है, तो रिलीज़ नोट में दिए गए Driver SDK के वर्शन की रेंज में से कोई वर्शन चुनें. उदाहरण के लिए, Driver SDK 7.1 के लिए [7.0, 8.0). /maps/documentation/mobility/driver-sdk/on-demand/android/configure-project देखें.
  • समस्या: डिवाइस की जगह की जानकारी का अपडेट करते समय, एसडीके AuthTokenFactory के ज़रिए अनुमति देने वाले टोकन का अनुरोध करता है. अगर आपका सर्वर JWT जारी नहीं कर सकता, तो Fleet Engine में अपडेट करने की अनुमति नहीं दी जा सकती. ठीक करने का तरीका: पक्का करें कि एसडीके को शुरू करने से पहले, सर्वर-साइड सेटअप टोकन जारी कर सके. साथ ही, टोकन की समयसीमा खत्म होने तक उनका फिर से इस्तेमाल किया जा सके. /maps/documentation/mobility/driver-sdk/on-demand/android/authenticate देखें.
  • समस्या: ProGuard बिल्ड, com.google, io.grpc, और okio क्लास के लिए चेतावनियां जनरेट कर सकते हैं. समस्या ठीक करने का तरीका: अपने ProGuard कॉन्फ़िगरेशन में -dontwarn com.google.**, -dontwarn io.grpc.**, और -dontwarn okio.** जोड़ें. /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies देखें.

Android के लिए Driver SDK: लेगसी और अब काम न करने वाली सुविधाएं

  • StatusListener इंटरफ़ेस: 25-11-2024 से बंद कर दिया गया है. बदले में मिलने वाला आइटम: DriverStatusListener. Symptom: इसे Driver SDK for Android के v6.0.0 से हटा दिया गया है. माइग्रेट करने से जुड़ी गाइड देखें.
  • Android v1.x के लिए Nav/Driver SDK (कंबाइंड बाइनरी): 21-06-2022 से बंद है. बदलाव: Driver SDK v3+ और Navigation SDK टूल की बाइनरी को अलग-अलग किया गया है. लक्षण: 21-06-2021 को बंद कर दिया गया और 21-06-2022 के बाद इसका रखरखाव नहीं किया गया; Waypoint#fromLatLng और Navigator#startGuidance(resumeIntent) जैसे तरीके, v3.0 में हटा दिए गए. माइग्रेट करने से जुड़ी गाइड देखें.
  • AuthTokenContext ServiceType: Decommissioned since 2021-11-29. बदलाव: शामिल किए गए वाहन आईडी और टास्क आईडी के लिए दावे. लक्षण: v4.0.0 में इन्हें हटा दिया गया है: AuthTokenContext से ServiceType और getServiceType(), और AuthTokenContext.Builder से setServiceType. माइग्रेट करने से जुड़ी गाइड देखें.
  • Task parentId प्रॉपर्टी: 28-04-2022 से इस्तेमाल पर रोक लगा दी गई है. बदले में मिलने वाला आइटम: trackingId. Symptom: इसका नाम v4.1.0 में बदला गया है. पुरानी प्रॉपर्टी अब भी मौजूद है, लेकिन अब उसका इस्तेमाल नहीं किया जाता.

Driver SDK for Android की मदद से क्या-क्या किया जा सकता है

हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.