सैन फ़्रांसिस्को में दिसंबर में होने वाले, Google Maps Platform डेवलपर कम्यूनिटी डे में हमारे साथ शामिल हों! अभी आवेदन करें.

Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

अपना प्रोजेक्ट सेट करें -- 4.99 और इससे पहले के वर्शन

इस गाइड में, Android के लिए Navigation SDK का इस्तेमाल करने के लिए, बिल्ड कॉन्फ़िगरेशन से जुड़ी ज़रूरी शर्तों के बारे में बताया गया है. इन निर्देशों को समझने के लिए, यह ज़रूरी है कि आपके पास Android IDE इंस्टॉल हो और आपको Android डेवलपमेंट की जानकारी हो.

Navigation SDK का इस्तेमाल करने के लिए ज़रूरी शर्तें

ये ज़रूरी शर्तें, Android के लिए Navigation SDK टूल के वर्शन 4.99 और इससे पहले के वर्शन पर लागू होती हैं.

Google Cloud console

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

अपने प्रोजेक्ट सेट अप करना: Cloud console प्रोजेक्ट और Android प्रोजेक्ट

कोई ऐप्लिकेशन बनाने या उसकी जांच करने से पहले, आपको Cloud Console प्रोजेक्ट बनाना होगा. साथ ही, एपीआई पासकोड के क्रेडेंशियल जोड़ने होंगे. प्रोजेक्ट में Navigation SDK को ऐक्सेस करने की सुविधा होनी चाहिए. Cloud Console प्रोजेक्ट में मौजूद सभी कुंजियों को, Navigation SDK टूल का एक जैसा ऐक्सेस दिया जाता है. एक कुंजी से एक से ज़्यादा डेवलपमेंट प्रोजेक्ट जुड़े हो सकते हैं. अगर आपके पास पहले से कोई कंसोल प्रोजेक्ट है, तो अपने मौजूदा प्रोजेक्ट में कोई कुंजी जोड़ी जा सकती है.

सेट अप करने के लिए

अपने पसंदीदा वेब ब्राउज़र में, Cloud Console में साइन इन करें और अपना Cloud Console प्रोजेक्ट बनाएं.
Android Studio जैसे अपने आईडीई में, Android ऐप्लिकेशन डेवलपमेंट प्रोजेक्ट बनाएं और पैकेज का नाम नोट करें.
अपने Cloud Console प्रोजेक्ट के लिए, Navigation SDK टूल का ऐक्सेस पाने के लिए, Google Maps Platform के प्रतिनिधि से संपर्क करें.
अपने वेब ब्राउज़र में Cloud Console डैशबोर्ड पर जाकर, क्रेडेंशियल बनाएं. इससे पाबंदियों वाला एपीआई पासकोड जनरेट किया जा सकेगा.
एपीआई पासकोड पेज पर, ऐप्लिकेशन से जुड़ी पाबंदियां सेक्शन में जाकर, Android ऐप्लिकेशन पर क्लिक करें.
पैकेज का नाम और फ़िंगरप्रिंट जोड़ें पर क्लिक करें. इसके बाद, अपने डेवलपमेंट प्रोजेक्ट के पैकेज का नाम और उस पासकोड के लिए SHA-1 फ़िंगरप्रिंट डालें.
सेव करें पर क्लिक करें.

अपने प्रोजेक्ट में Navigation SDK जोड़ना

Navigation SDK, Maven या AAR बंडल के तौर पर उपलब्ध है. डेवलपमेंट प्रोजेक्ट बनाने के बाद, इनमें से किसी एक तरीके का इस्तेमाल करके, एसडीके को उसमें इंटिग्रेट किया जा सकता है.

Navigation SDK के वर्शन 4.5 और इसके बाद के वर्शन के लिए, Maven का इस्तेमाल करना (सुझाया गया)

यहां google() Maven रिपॉज़िटरी का इस्तेमाल किया गया है. यह आपके प्रोजेक्ट में Navigation SDK जोड़ने का सबसे आसान और सुझाया गया तरीका है

अपने Gradle या Maven कॉन्फ़िगरेशन में यह डिपेंडेंसी जोड़ें. इसके लिए, Android के लिए Navigation SDK के वर्शन के लिए, VERSION_NUMBER प्लेसहोल्डर को बदलें.
ग्रेडल
अपने मॉड्यूल-लेवल की build.gradle फ़ाइल में यह कोड जोड़ें:
dependencies { ... implementation 'com.google.android.libraries.navigation:navigation:VERSION_NUMBER' }
अगर ओरिजनल Maven रिपॉज़िटरी से अपग्रेड किया जा रहा है, तो ध्यान दें कि ग्रुप और आर्टफ़ैक्ट के नाम बदल गए हैं. साथ ही, अब com.google.cloud.artifactregistry.gradle-plugin प्लग इन की ज़रूरत नहीं है.

साथ ही, अपने टॉप-लेवल build.gradle में यह जोड़ें:
allprojects { ... // Required: you must exclude the Google Play service Maps SDK from // your transitive dependencies to make nsure there won't be // multiple copies of Google Maps SDK in your binary, as the Navigation // SDK already bundles the Google Maps SDK. configurations { implementation { exclude group: 'com.google.android.gms', module: 'play-services-maps' } } }
Maven
अपनी pom.xml में ये चीज़ें जोड़ें:
<dependencies> ... <dependency> <groupId>com.google.android.libraries.navigation</groupId> <artifactId>navigation</artifactId> <version>VERSION_NUMBER</version> </dependency> </dependencies>
अगर आपके पास ऐसी डिपेंडेंसी हैं जो Maps SDK का इस्तेमाल करती हैं, तो आपको Maps SDK पर निर्भर हर डिपेंडेंसी को बाहर रखना होगा.
<dependencies> <dependency> <groupId>project.that.brings.in.maps</groupId> <artifactId>MapsConsumer</artifactId> <version>1.0</version> <exclusions>  <exclusion>  <groupId>com.google.android.gms</groupId> <artifactId>play-services-maps</artifactId> </exclusion> </exclusions> </dependency> </dependencies>

Navigation SDK के 4.5 से पहले के वर्शन या Driver SDK के साथ Maven का इस्तेमाल करना

Navigation SDK, v4 के बाकी वर्शन के लिए, ओरिजनल Maven रिपॉज़िटरी का इस्तेमाल करके उपलब्ध रहेगा. यह वही लाइब्रेरी है जिसमें ऊपर दिए गए वर्शन के सभी अपडेट शामिल हैं. साथ ही, यह ट्रांज़िशन के दौरान ड्राइवर एसडीके और अन्य लाइब्रेरी के साथ काम करती है. इस डिपेंडेंसी का इस्तेमाल करने के लिए, कंपाइल करते समय gcloud का इस्तेमाल करके अपने क्लाउड प्रोजेक्ट में लॉग इन करना ज़रूरी है.

Google की Maven रिपॉज़िटरी को ऐक्सेस करने के लिए, अपना एनवायरमेंट सेट अप करें. इसके बारे में Consumer SDK टूल के दस्तावेज़ के ज़रूरी शर्तें सेक्शन में बताया गया है. Navigation SDK का ऐक्सेस, Workspace ग्रुप के ज़रिए कंट्रोल किया जाता है.

अपने Gradle या Maven कॉन्फ़िगरेशन में यह डिपेंडेंसी जोड़ें. इसके लिए, Navigation SDK के वर्शन के लिए, VERSION_NUMBER प्लेसहोल्डर को बदलें.

ग्रेडल

अपने मॉड्यूल-लेवल की build.gradle फ़ाइल में यह कोड जोड़ें:

dependencies {
...
implementation 'com.google.android.maps:navsdk:VERSION_NUMBER'
}

साथ ही, अपने टॉप-लेवल build.gradle में यह जोड़ें:

allprojects {
...
// Required: you must exclude the Google Play service Maps SDK from
// your transitive dependencies to make sure there won't be
// multiple copies of Google Maps SDK in your binary, as the Navigation
// SDK already bundles the Google Maps SDK.
configurations {
        implementation {
            exclude group: 'com.google.android.gms', module: 'play-services-maps'
        }
}
}

Maven

अपनी pom.xml में ये चीज़ें जोड़ें:

<dependencies>
...
<dependency>
     <groupId>com.google.android.maps</groupId>
     <artifactId>navsdk</artifactId>
     <version>VERSION_NUMBER</version>
</dependency>
</dependencies>

अगर आपके पास ऐसी डिपेंडेंसी हैं जो Maps SDK का इस्तेमाल करती हैं, तो आपको Maps SDK पर निर्भर हर डिपेंडेंसी को बाहर रखना होगा.

<dependencies>
<dependency>
<groupId>project.that.brings.in.maps</groupId>
<artifactId>MapsConsumer</artifactId>
<version>1.0</version>
     <exclusions>
       <!-- Navigation SDK already bundles Maps SDK. You must exclude it to prevent duplication-->
       <exclusion>  <!-- declare the exclusion here -->
         <groupId>com.google.android.gms</groupId>
         <artifactId>play-services-maps</artifactId>
       </exclusion>
     </exclusions>
</dependency>
</dependencies>

डाउनलोड किए गए एएआर बंडल का इस्तेमाल करना (इसका सुझाव नहीं दिया जाता)

Navigation SDK, AAR बंडल के तौर पर भी उपलब्ध है. डेवलपमेंट प्रोजेक्ट बनाने के बाद, एसडीके को इंटिग्रेट किया जा सकता है. इन निर्देशों को Android Studio को आईडीई के तौर पर इस्तेमाल करने के लिए बनाया गया है.

शेयर किए गए Google Drive से, Navigation SDK का नया वर्शन डाउनलोड करें और उसे एक्सट्रैक्ट करें. अगर आपके पास ऐक्सेस नहीं है, तो अपने प्रतिनिधि से संपर्क करें.
Android Studio में, कोई प्रोजेक्ट खोलें और एसडीके मैनेजर का इस्तेमाल करके, Google Play services पैकेज जोड़ें.
ZIP फ़ाइल डायरेक्ट्री से, libs/google_navigation_navmap.aar को अपने प्रोजेक्ट की app/libs डायरेक्ट्री में कॉपी करें.

अपने मॉड्यूल-लेवल की build.gradle फ़ाइल में यह कोड जोड़ें:

implementation(name: 'google_navigation_navmap', ext: 'aar')

साथ ही, अपने टॉप-लेवल build.gradle में यह जोड़ें:

allprojects {
   ...
   // Required: you must exclude the Google Play service Maps SDK from
   // your transitive dependencies to make sure there won't be
   // multiple copies of Google Maps SDK in your binary, as the Navigation
   // SDK already bundles the Google Maps SDK.
   configurations {
       implementation {
           exclude group: 'com.google.android.gms', module: 'play-services-maps'
       }
   }
}

बिल्ड को कॉन्फ़िगर करना

प्रोजेक्ट बनाने के बाद, Navigation SDK को सही तरीके से बनाने और इस्तेमाल करने के लिए, सेटिंग कॉन्फ़िगर की जा सकती हैं.

स्थानीय प्रॉपर्टी अपडेट करना

Gradle Scripts फ़ोल्डर में, local.properties फ़ाइल खोलें और android.useDeprecatedNdk=true जोड़ें.

Gradle बिल्ड स्क्रिप्ट को अपडेट करना

build.gradle (Module:app) फ़ाइल खोलें और Navigation SDK की ज़रूरी शर्तों को पूरा करने के लिए, सेटिंग अपडेट करने के लिए ये दिशा-निर्देश अपनाएं. साथ ही, ऑप्टिमाइज़ करने के विकल्प भी सेट करें.

Navigation SDK के लिए ज़रूरी सेटिंग
1. minSdkVersion को 23 या इससे ज़्यादा पर सेट करें.
2. targetSdkVersion को 30 या इससे ज़्यादा पर सेट करें.
3. dexOptions की ऐसी सेटिंग जोड़ें जिससे javaMaxHeapSize बढ़े.
4. अतिरिक्त लाइब्रेरी के लिए जगह सेट करें.
5. Navigation SDK के लिए, repositories और dependencies जोड़ें.
6. डिपेंडेंसी में मौजूद वर्शन नंबर को, उपलब्ध सबसे नए वर्शन से बदलें.
बिल्ड टाइम कम करने के लिए वैकल्पिक सेटिंग
- डिपेंडेंसी से, इस्तेमाल नहीं किए गए कोड और रिसॉर्स हटाने के लिए, R8/ProGuard का इस्तेमाल करके, कोड छोटा करने और इस्तेमाल नहीं किए जाने वाले रिसॉर्स को हटाने की प्रोसेस चालू करें. अगर R8/ProGuard को रन होने में बहुत ज़्यादा समय लगता है, तो डेवलपमेंट के काम के लिए मल्टीडेक्स को चालू करें.
- बिल्ड में शामिल अनुवादों की संख्या कम करें: डेवलपमेंट के दौरान, एक भाषा के लिए resConfigs सेट करें. फ़ाइनल बिल्ड के लिए, resConfigs को उन भाषाओं के लिए सेट करें जिनका इस्तेमाल किया जाता है. डिफ़ॉल्ट रूप से, Gradle में उन सभी भाषाओं के लिए रिसॉर्स स्ट्रिंग शामिल होती हैं जो Navigation SDK के साथ काम करती हैं.

यहां ऐप्लिकेशन के लिए, Gradle बिल्ड स्क्रिप्ट का एक उदाहरण दिया गया है. डिपेंडेंसी के अपडेट किए गए सेट के लिए, सैंपल के तौर पर मिले ऐप्लिकेशन देखें. ऐसा इसलिए, क्योंकि हो सकता है कि आपके इस्तेमाल किए जा रहे Navigation SDK का वर्शन, इस दस्तावेज़ में बताए गए वर्शन से थोड़ा आगे या पीछे हो.

apply plugin: 'com.android.application'
apply plugin: 'com.google.cloud.artifactregistry.gradle-plugin'

ext {
    androidxVersion = "1.0.0"
    lifecycle_version = "1.1.1"
}

android {
    compileSdkVersion 30
    buildToolsVersion '28.0.3'

    defaultConfig {
        applicationId "<your id>"
        // Navigation SDK supports SDK 23 and later.
        minSdkVersion 23
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
        // Set this to the languages you actually use, otherwise you'll include resource strings
        // for all languages supported by the Navigation SDK.
        resConfigs "en"
        multiDexEnabled true
    }

    dexOptions {
        // This increases the amount of memory available to the dexer. This is required to build
        // apps using the Navigation SDK.
        javaMaxHeapSize "4g"
    }
    buildTypes {
        // Run ProGuard. Note that the Navigation SDK includes its own ProGuard configuration.
        // The configuration is included transitively by depending on the Navigation SDK.
        // If the ProGuard step takes too long, consider enabling multidex for development work
        // instead.
        all {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

// This tells Gradle where to look to find additional libraries - in this case, the
// google_navigation_navmap.aar file.
repositories {
    flatDir {
        dirs 'libs'
    }
    google()

    // Required for accessing the Navigation SDK on Google's Maven repository.
    maven {
        url "artifactregistry://us-west2-maven.pkg.dev/gmp-artifacts/transportation"
    }
}

dependencies {
    // Include the Google Navigation SDK
    implementation 'com.google.android.maps:navsdk:4.4.0'

    // The included AAR file under libs can be used instead of the Maven repository.
    // Uncomment the line below and comment out the previous dependency to use
    // the AAR file instead. Make sure that you add the AAR file to the libs directory.
    // implementation(name: 'google_navigation_navmap', ext: 'aar')

    // These dependencies are required for the Navigation SDK to function
    // properly at runtime.
    implementation 'org.chromium.net:cronet-fallback:69.3497.100'
    // Optional for Cronet users:
    // implementation 'org.chromium.net:cronet-api:69.3497.100'
    implementation 'androidx.appcompat:appcompat:${androidxVersion}'
    implementation 'androidx.cardview:cardview:${androidxVersion}'
    implementation 'com.google.android.material:material:${androidxVersion}'
    implementation 'androidx.mediarouter:mediarouter:${androidxVersion}'
    implementation 'androidx.preference:preference:${androidxVersion}'
    implementation 'androidx.recyclerview:recyclerview:${androidxVersion}'
    implementation 'androidx.legacy:legacy-support-v4:${androidxVersion}'
    implementation 'com.github.bumptech.glide:glide:4.9.0'
    implementation 'com.github.bumptech.glide:okhttp-integration:4.9.0'
    implementation 'android.arch.lifecycle:common-java8:$lifecycle_version'
    implementation 'com.android.support:multidex:1.0.3'
    implementation 'com.google.android.datatransport:transport-api:2.2.0'
    implementation 'com.google.android.datatransport:transport-backend-cct:2.2.0'
    implementation 'com.google.android.datatransport:transport-runtime:2.2.0'
    implementation 'joda-time:joda-time:2.9.9'
    annotationProcessor 'androidx.annotation:annotation:1.1.0'
    annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
}

अपने ऐप्लिकेशन में एपीआई पासकोड जोड़ना

इस सेक्शन में, एपीआई पासकोड को सेव करने का तरीका बताया गया है, ताकि आपका ऐप्लिकेशन उसे सुरक्षित तरीके से रेफ़र कर सके. आपको अपने वर्शन कंट्रोल सिस्टम में एपीआई पासकोड की जांच नहीं करनी चाहिए. इसलिए, हमारा सुझाव है कि आप इसे अपने प्रोजेक्ट की रूट डायरेक्ट्री में मौजूद secrets.properties फ़ाइल में सेव करें और उस फ़ाइल को वर्शन कंट्रोल से बाहर रखें. Gradle प्रॉपर्टी फ़ाइलों के बारे में ज़्यादा जानने के लिए, Gradle प्रॉपर्टी फ़ाइलें देखें.

इस टास्क को आसान बनाने के लिए, हमारा सुझाव है कि आप Android के लिए सीक्रेट ग्रेडल प्लग इन का इस्तेमाल करें.

Android के लिए Secrets Gradle Plugin इंस्टॉल करने और अपना एपीआई पासकोड सेव करने के लिए:

Android Studio में, अपनी टॉप-लेवल build.gradle.kts या build.gradle फ़ाइल खोलें और plugins ब्लॉक में यह कोड जोड़ें.

Kotlin

plugins {
    // ...
    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin") version "2.0.1" apply false
}

ग्रूवी

plugins {
    // ...
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' version '2.0.1' apply false
}

मॉड्यूल-लेवल की build.gradle.kts या build.gradle फ़ाइल खोलें और plugins एलिमेंट में यह कोड जोड़ें.

Kotlin

plugins {
    id("com.android.application")
    // ...
    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
}

ग्रूवी

plugins {
    id 'com.android.application'
    // ...
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
}

अगर Android Studio का इस्तेमाल किया जा रहा है, तो अपने प्रोजेक्ट को Gradle के साथ सिंक करें.
अपनी टॉप-लेवल डायरेक्ट्री में secrets.properties फ़ाइल खोलें. इसके बाद, यह कोड जोड़ें. YOUR_API_KEY को अपने एपीआई पासकोड से बदलें. secrets.properties को अपनी .gitignore फ़ाइल में जोड़ना न भूलें. इसके अलावा, इसे अपने वर्शन कंट्रोल सिस्टम से बाहर रखें, ताकि आप वर्शन कंट्रोल में अपना एपीआई पासकोड न डालें.
ध्यान दें: अगर secrets.properties फ़ाइल मौजूद नहीं है, तो उसे उसी फ़ोल्डर में बनाएं जिसमें local.properties फ़ाइल मौजूद है.
```
MAPS_API_KEY=YOUR_API_KEY
```
अपनी टॉप-लेवल डायरेक्ट्री में local.defaults.properties फ़ाइल बनाएं. यह वही फ़ोल्डर होना चाहिए जिसमें secrets.properties फ़ाइल है. इसके बाद, यह कोड जोड़ें.

ध्यान दें: कोड को ठीक उसी तरह डालें जैसा वह दिख रहा है. DEFAULT_API_KEY को अपने एपीआई पासकोड से न बदलें.
```
MAPS_API_KEY=DEFAULT_API_KEY
```
इस फ़ाइल का मकसद, एपीआई पासकोड के लिए बैकअप लोकेशन उपलब्ध कराना है. ऐसा तब किया जाता है, जब secrets.properties फ़ाइल न मिले, ताकि बिल्ड फ़ेल न हों. ऐसा तब हो सकता है, जब आपने ऐप्लिकेशन को किसी ऐसे वर्शन कंट्रोल सिस्टम से क्लोन किया हो जिसमें secrets.properties शामिल न हो और आपने अब तक अपने एपीआई पासकोड को उपलब्ध कराने के लिए, डिवाइस पर secrets.properties फ़ाइल न बनाई हो.
एपीआई पासकोड को अपनी AndroidManifest.xml फ़ाइल में जोड़ा जा सकता है या प्रोग्राम के हिसाब से एपीआई पासकोड दिया जा सकता है.
- AndroidManifest.xml में अपना एपीआई पासकोड जोड़ें:
```
<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="${MAPS_API_KEY}" />
        
```
  ध्यान दें: एपीआई पासकोड के लिए, मेटाडेटा के नाम के तौर पर com.google.android.geo.API_KEY का सुझाव दिया जाता है. इस नाम वाले पासकोड का इस्तेमाल, Android प्लैटफ़ॉर्म पर Google Maps पर आधारित कई एपीआई की पुष्टि करने के लिए किया जा सकता है. इनमें Navigation SDK for Android भी शामिल है. पुराने सिस्टम के साथ काम करने की सुविधा के लिए, एपीआई में com.google.android.maps.v2.API_KEY नाम का भी इस्तेमाल किया जा सकता है. इस लेगसी नाम की मदद से, सिर्फ़ Android Maps API v2 की पुष्टि की जा सकती है. कोई ऐप्लिकेशन, एपीआई पासकोड के मेटाडेटा के नामों में से सिर्फ़ एक नाम तय कर सकता है. अगर दोनों एट्रिब्यूट की वैल्यू दी जाती हैं, तो एपीआई एक अपवाद दिखाता है.
- प्रोग्राम के हिसाब से एपीआई पासकोड दें:
  सीक्रेट ग्रेडल प्लग इन, कुंजी को BuildConfig क्लास में उपलब्ध कराता है. अपने ऐप्लिकेशन को शुरू करने के लिए (उदाहरण के लिए, अपने Application.onCreate() तरीके में), इस तरीके को इस तरह कॉल करें:
  Kotlin
  1. इंपोर्ट करने के लिए ये स्टेटमेंट जोड़ें:
    import com.google.android.libraries.navigation.NavigationApi
  2. अपने Application.onCreate() तरीके में ये चीज़ें जोड़ें:
    NavigationApi.setApiKey(BuildConfig.MAPS_API_KEY)
  Java
  1. इंपोर्ट करने के लिए ये स्टेटमेंट जोड़ें:
    import com.google.android.libraries.navigation.NavigationApi;
  2. अपने Application.onCreate() तरीके में ये चीज़ें जोड़ें:
    NavigationApi.setApiKey(BuildConfig.MAPS_API_KEY);
  ध्यान दें: setApiKey() का इस्तेमाल करते समय, इन बातों का ध्यान रखें:
  - ऐसा एपीआई पासकोड दें जो खाली न हो.
  - अपने ऐप्लिकेशन के लाइफ़टाइम के दौरान, setApiKey() को सिर्फ़ एक बार कॉल करें. अगर इस तरीके को एक से ज़्यादा बार कॉल किया जाता है, तो यह IllegalStateException दिखाता है.
  - Navigation SDK के किसी अन्य कॉम्पोनेंट, जैसे कि Navigator को शुरू करने से पहले, setApiKey() को कॉल करें.
  - इस तरीके से दिया गया पासकोड, आपके AndroidManifest.xml में मौजूद किसी भी एपीआई पासकोड को बदल देता है.
  - Navigation SDK के 7.6 या इसके बाद के वर्शन का इस्तेमाल करें.

Android Studio में, मॉड्यूल-लेवल की build.gradle.kts या build.gradle फ़ाइल खोलें और secrets प्रॉपर्टी में बदलाव करें. अगर secrets प्रॉपर्टी मौजूद नहीं है, तो उसे जोड़ें.

प्लग इन की प्रॉपर्टी में बदलाव करके, propertiesFileName को "secrets.properties" पर सेट करें. साथ ही, defaultPropertiesFileName को "local.defaults.properties" पर सेट करें और अन्य प्रॉपर्टी सेट करें.

Kotlin

secrets {
    // To add your Maps API key to this project:
    // 1. If the secrets.properties file does not exist, create it in the root directory (the same folder as the root local.properties file).
    // 2. Add this line, where YOUR_API_KEY is your API key:
    //        MAPS_API_KEY=YOUR_API_KEY
    propertiesFileName = "secrets.properties"

    // A properties file containing default secret values. This file can be
    // checked in version control.
    defaultPropertiesFileName = "local.defaults.properties"
}

ग्रूवी

secrets {
    // To add your Maps API key to this project:
    // 1. If the secrets.properties file does not exist, create it in the root directory (the same folder as the root local.properties file).
    // 2. Add this line, where YOUR_API_KEY is your API key:
    //        MAPS_API_KEY=YOUR_API_KEY
    propertiesFileName = "secrets.properties"

    // A properties file containing default secret values. This file can be
    // checked in version control.
    defaultPropertiesFileName = "local.defaults.properties"
}

अपने ऐप्लिकेशन में ज़रूरी एट्रिब्यूशन शामिल करना

अगर आपके ऐप्लिकेशन में Android के लिए Navigation SDK का इस्तेमाल किया जाता है, तो आपको अपने ऐप्लिकेशन के कानूनी नोटिस वाले सेक्शन में, एट्रिब्यूशन टेक्स्ट और ओपन सोर्स लाइसेंस शामिल करने होंगे.

Android के लिए Navigation SDK की ZIP फ़ाइल में, ज़रूरी एट्रिब्यूशन टेक्स्ट और ओपन सोर्स लाइसेंस मिल सकते हैं:

NOTICE.txt
LICENSES.txt