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

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

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

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

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

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

  • आपको अपने Android ऐप्लिकेशन में Google Maps के रास्ते के दिशा-निर्देशों की सुविधा चाहिए, ताकि उपयोगकर्ता किसी दूसरे ऐप्लिकेशन पर स्विच न करें.
  • आपको नेविगेशन यूज़र इंटरफ़ेस (यूआई) को अपने ब्रैंड के हिसाब से बनाना होगा या पसंद के मुताबिक नेविगेशन अनुभव बनाना होगा.
  • आपको गाड़ी चलाने, पैदल चलने, साइकल चलाने या दोपहिया वाहनों के लिए, ऐप्लिकेशन में नेविगेशन की सुविधा चाहिए.
  • आपको Routes API की मदद से तय किए गए रास्ते पर नेविगेट करना होगा. इसके लिए, एसडीके को रूट टोकन पास करना होगा.

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

  • iOS के लिए ऐप्लिकेशन बनाया जा रहा हो. इसके बजाय, iOS के लिए Navigation SDK का इस्तेमाल करें.
  • Flutter या React Native की मदद से, क्रॉस-प्लैटफ़ॉर्म ऐप्लिकेशन बनाया जा रहा हो. इसके बजाय, Flutter और React Native के लिए Google Navigation का इस्तेमाल करें.
  • आपको सर्वर-साइड रूट, ईटीए या रूट-टोकन कंप्यूटेशन की ज़रूरत है, न कि ऐप्लिकेशन में मोड़-दर-मोड़ दिशा-निर्देश की. इसके बजाय, Routes API का इस्तेमाल करें.

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

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

  • maven: com.google.android.libraries.navigation:navigation

Android के लिए Navigation SDK टूल: सामान्य गलतियां

  • समस्या: Navigation SDK में Maps SDK पहले से बंडल किया गया है. play-services-maps को सीधे तौर पर या ट्रांज़िटिव डिपेंडेंसी के ज़रिए पुल करने वाले बिल्ड में, Maps SDK की डुप्लीकेट कॉपी बन जाती हैं. समस्या हल करने का तरीका: com.google.android.gms:play-services-maps को सभी डिपेंडेंसी (Gradle कॉन्फ़िगरेशन या Maven एक्सक्लूज़न) से हटाएं. साथ ही, Maps SDK की किसी भी डायरेक्ट डिपेंडेंसी को हटाएं. /maps/documentation/navigation/android-sdk/android-studio-setup देखें.
  • समस्या: Navigation SDK 8.0 और इसके बाद के वर्शन, minAndroidGradlePluginVersion=9.0.1 का एलान करते हैं. इसलिए, एजीपी के पुराने वर्शन के साथ बिल्ड काम नहीं करते. ठीक करने का तरीका: 8.0+ वर्शन के साथ बिल्ड करने से पहले, AGP 9.0.1, Gradle 9.1.0, और Kotlin 2.3.0 पर अपग्रेड करें. /maps/documentation/navigation/android-sdk/kotlin-compatibility-migration देखें.
  • समस्या: NavigationFragment का इस्तेमाल करते समय, NavigationView के लाइफ़साइकल के तरीकों को सीधे तौर पर कॉल करने या उन्हें NavigationView के साथ गलत क्रम में कॉल करने पर गड़बड़ियां होती हैं. ठीक करने का तरीका: NavigationFragment का इस्तेमाल करें. यह लाइफ़साइकल कॉलबैक को मैनेज करता है. अगर NavigationView का इस्तेमाल किया जाता है, तो लाइफ़साइकल के तरीकों को तय क्रम में फ़ॉरवर्ड करें. /maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices देखें.
  • समस्या: नेविगेशन की सुविधा तब तक उपलब्ध नहीं होती, जब तक उपयोगकर्ता Google नेविगेशन की सेवा की शर्तें स्वीकार नहीं कर लेता. ठीक करने का तरीका: जब पहली बार नेविगेटर को शुरू किया जाए, तब एसडीके को प्रॉम्प्ट करने दें या TermsAndConditionsCheckOption / NavigationApi.showTermsAndConditionsDialog के साथ डायलॉग को पहले दिखाएं (उदाहरण के लिए, साइनअप के दौरान). /maps/documentation/navigation/android-sdk/route देखें.

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

  • Waypoint fromLatLng() और fromPlaceId(): 10-05-2021 से बंद कर दिया गया है. बदलाव: Waypoint.builder() (Waypoint.Builder). असर: वर्शन 3.0 से हटा दिया गया है. कॉल, 3.0 या इसके बाद के वर्शन के साथ कंपाइल नहीं होते. माइग्रेट करने से जुड़ी गाइड देखें.
  • SupportNavigationFragment: यह फ़ील्ड 1 अक्टूबर, 2026 से काम नहीं करेगा. बदले में मिलने वाला आइटम: NavigationFragment. Symptom: इसे Navigation SDK के 8.0.0 वर्शन से हटा दिया गया है. माइग्रेट करने से जुड़ी गाइड देखें.
  • NavigationView और SupportNavigationFragment पर setLocationMarkerEnabled: इसे 7 जुलाई, 2023 से बंद कर दिया गया है. बदले में मिलने वाला आइटम: GoogleMap.setMyLocationEnabled. Symptom: इसे वर्शन 5.0.0 में हटा दिया गया है. हालांकि, 4.1 में इसे बंद कर दिया गया था. कॉल, 5.0 या इसके बाद के वर्शन के साथ कंपाइल नहीं होते.
  • DisplayOptions showTrafficLights और showStopSigns: इन्हें 01-10-2026 से बंद कर दिया गया है. बदलाव: कोई बदलाव नहीं किया गया है. नेविगेशन के दौरान, ट्रैफ़िक लाइट और स्टॉप साइन हमेशा चालू रहते हैं. समस्या: इन तरीकों के कॉल, 8.0.0 वर्शन के साथ कंपाइल नहीं होते.
  • Maven आर्टफ़ैक्ट com.google.android.maps:navsdk (निजी रिपॉज़िटरी, v4.x) और एएआर बंडल डाउनलोड: 7 जुलाई, 2023 से बंद कर दिया गया है. बदलाव: google() Maven रिपॉज़िटरी से com.google.android.libraries.navigation:navigation. समस्या: Google Maven पर, 5.0 और इसके बाद के वर्शन सिर्फ़ com.google.android.libraries.navigation:navigation के तौर पर उपलब्ध हैं. एएआर बंडल अब उपलब्ध नहीं है. माइग्रेट करने से जुड़ी गाइड देखें.

Android के लिए Navigation SDK की मदद से क्या-क्या किया जा सकता है

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

Android के लिए Navigation SDK: Maps

Android के लिए Navigation SDK: Maps एनोटेशन

Android के लिए Navigation SDK: मैप की स्टाइलिंग

Android के लिए Navigation SDK: नेविगेशन