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: सेटअप
- चालू की जाने वाली सेवा:
navigationsdk.googleapis.com - पुष्टि करने का तरीका: एपीआई पासकोड
- इस्तेमाल का एट्रिब्यूशन: इनिशलाइज़र में इस्तेमाल का एट्रिब्यूशन आईडी जोड़ने के लिए,
MapsApiSettings.addInternalUsageAttributionId(context, id)को कॉल करें. ऑप्ट आउट करने के लिए, कॉल को मिटाएं या खाली स्ट्रिंग पास करें. - शुरू करें: Android के लिए Navigation SDK टूल सेट अप करना
- रेफ़रंस: Android के लिए Navigation SDK का रेफ़रंस
- कीमत: Android के लिए Navigation SDK के इस्तेमाल और बिलिंग की जानकारी
- नीतियां: Android के लिए Navigation SDK की नीतियां
- रिलीज़ नोट: Android के लिए Navigation SDK के रिलीज़ नोट
Android के लिए आधिकारिक Navigation SDK पैकेज:
- maven:
com.google.android.libraries.navigation:navigation
Android के लिए Navigation SDK: इससे जुड़े प्रॉडक्ट
- आम तौर पर, इनके साथ इस्तेमाल किया जाता है: Routes API, Android के लिए Driver SDK
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 टूल: लेगसी और अब काम न करने वाली सुविधाएं
WaypointfromLatLng()और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 या इसके बाद के वर्शन के साथ कंपाइल नहीं होते.DisplayOptionsshowTrafficLightsऔर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 के लिए:
AndroidManifest.xmlमेंको कॉन्फ़िगर करें. इसके लिए, Secrets Gradle प्लगिन का इस्तेमाल करें याapp/build.gradle.ktsमेंmanifestPlaceholders["MAPS_API_KEY"]को कॉन्फ़िगर करें.AndroidManifest.xmlमेंYOUR_GOOGLE_MAPS_API_KEYको कभी भी हार्डकोड न करें. साथ ही, अगरE/Google Maps Android API: Authorization failureदिखता है, तोGoogleMap(या maps-composeGoogleMap) को कभी भी ऑफ़लाइन मॉक कैनवस या Leaflet WebView से न बदलें. उपयोगकर्ता को निर्देश दें कि वह सीक्रेट के ज़रिएMAPS_API_KEYउपलब्ध कराए और Android के लिए Maps SDK टूल चालू करे. इसके अलावा, NavigationView / SupportNavigationFragment का इस्तेमाल करते समय, Navigation SDK टूल चालू करे. - मैप कॉन्फ़िगरेशन और स्टाइलिंग सेटिंग को सेव करने के लिए, फिर से इस्तेमाल किया जा सकने वाला मैप आइडेंटिफ़ायर बनाएं.
- मैप पर उपयोगकर्ता के इंटरैक्शन और इवेंट का जवाब देना.
- मैप पर दिखने वाले कंट्रोल को पसंद के मुताबिक बनाएं.
- मैप को कंट्रोल करने के लिए, जेस्चर को पसंद के मुताबिक बनाएं.
- मैप (कैमरा) पर ज़ूम और पैन को कंट्रोल करना.
- मैप का टाइप बदलें.
- मैप की कलर स्कीम बदलना.
- मैप में ट्रैफ़िक लेयर जोड़ना.
Android के लिए Navigation SDK: Maps एनोटेशन
- मैप में जानकारी वाली विंडो जोड़ना.
- मैप में कोई आकार या लाइन जोड़ना.
- मैप की सतह पर ग्राउंड की गई ओवरले इमेज जोड़ें.
- मैप में कस्टम टाइल ओवरले जोड़ना.
- मैप में मार्कर जोड़ना. ध्यान दें: Navigation SDK for Android में AdvancedMarkerOptions का इस्तेमाल नहीं किया जा सकता. Navigation SDK for Android का इस्तेमाल करते समय, GoogleMap.addMarker(MarkerOptions) की मदद से मार्कर जोड़ें.
- मैप पर मार्कर को पसंद के मुताबिक बनाना. ध्यान दें: Android के लिए Navigation SDK, AdvancedMarkerOptions के साथ काम नहीं करता. Android के लिए Navigation SDK का इस्तेमाल करते समय, MarkerOptions की मदद से मार्कर को पसंद के मुताबिक बनाएं.
- मैप पर मार्कर की मदद से, उपयोगकर्ता के इंटरैक्शन का जवाब देना.
Android के लिए Navigation SDK: मैप की स्टाइलिंग
Android के लिए Navigation SDK: नेविगेशन
- किसी मोबाइल ऐप्लिकेशन में, रास्ते के दिशा-निर्देश देने वाली इंटरैक्टिव सुविधा जोड़ें.
- रास्ते के दिशा-निर्देश पाने के लिए, मंज़िल सेट करें.
- रास्ते के दिशा-निर्देश पाने के लिए, नेविगेशन शुरू करें.
- रास्ते के अनुरोध के लिए, यात्रा का मोड (ड्राइव, पैदल, दोपहिया वाहन, टैक्सी) तय करें.
- रास्ते के दिशा-निर्देशों के लिए, रूटिंग की प्राथमिकताओं में बदलाव करना.
- रास्ते के दिशा-निर्देशों के लिए, सड़क के किनारे और पहुंचने की अन्य प्राथमिकताएं तय करें.
- फिर से इस्तेमाल किए जा सकने वाले रूट टोकन की मदद से, रास्ते के दिशा-निर्देशों के लिए फिर से प्लान किए गए रास्ते की जानकारी देना.
- रास्ते के दिशा-निर्देश वाले नेविगेशन सेशन से, उपयोगकर्ता के पहुंचने के अपडेट दिखाएं.
- रास्ते के दिशा-निर्देश वाले सेशन से, उपयोगकर्ता की जगह की जानकारी के अपडेट पाना.
- रास्ते के दिशा-निर्देश वाले नेविगेशन सेशन से, समय और दूरी के अपडेट पाना.
- रास्ते के दिशा-निर्देश वाले नेविगेशन सेशन से, रास्ते में हुए बदलाव के अपडेट पाना.
- रास्ते के दिशा-निर्देश वाले सेशन से, नाइट मोड के अपडेट पाना.
- रास्ते के दिशा-निर्देश वाले सेशन से, उपयोगकर्ता की स्पीड के अपडेट दिखाता है.
- रास्ते के दिशा-निर्देशों के दौरान दिखने वाले यूज़र इंटरफ़ेस (यूआई) एलिमेंट और कंट्रोल को अपनी पसंद के मुताबिक बनाएं.
- रास्ते के दिशा-निर्देशों की सुविधा में नया यूज़र इंटरफ़ेस (यूआई) एलिमेंट जोड़ना.
- रास्ते के दिशा-निर्देशों में, यात्रा की प्रोग्रेस दिखाने वाला इंडिकेटर जोड़ना.
- रास्ते के दिशा-निर्देशों के दौरान दिखने वाली मैप की सुविधाओं को अपनी पसंद के मुताबिक बनाएं.
- रास्ते के दिशा-निर्देशों में ट्रैफ़िक लेयर जोड़ना.
- रास्ते के दिशा-निर्देशों के लिए, कैमरे के व्यू और उसके काम करने के तरीके में बदलाव करना.
- रास्ते के दिशा-निर्देशों के लिए, स्पीडोमीटर और स्पीड लिमिट की सूचनाओं को अपनी पसंद के मुताबिक बनाना.
- रास्ते के दिशा-निर्देशों की फ़ीड को मैसेज की सीरीज़ के तौर पर दिखाता है. इसमें रास्ते के हर मोड़ के लिए दिशा-निर्देश होते हैं.
- रास्ते के दिशा-निर्देशों वाले फ़ीड के साथ इस्तेमाल करने के लिए, कस्टम आइकॉन तय करें.
- Android ऐप्लिकेशन में, Android Auto के लिए इंटरैक्टिव और रास्ते के दिशा-निर्देश देने वाली सुविधा जोड़ें. झलक देखें
- उपयोगकर्ताओं को उनके रास्ते में आने वाली रुकावटों के बारे में सूचना देना.
- नेविगेशन शुरू करने से पहले, उपयोगकर्ताओं को उनके रास्ते में आने वाली रुकावटों को देखने की अनुमति दें.
- उपयोगकर्ताओं को अपने रास्ते में आने वाली रुकावटों की शिकायत करने की अनुमति दें.
- उपयोगकर्ताओं को अपने रास्ते में आने वाली रुकावटों की पुष्टि करने की अनुमति दें.
- रास्ते में आने वाली रुकावट की जानकारी देने के लिए, पसंद के मुताबिक बटन जोड़ें.