আপনার প্রকল্প সেট আপ করুন -- সংস্করণ 4.99 এবং তার আগের

এই নির্দেশিকায় অ্যান্ড্রয়েডের জন্য নেভিগেশন এসডিকে (Navigation SDK) ব্যবহারের জন্য প্রয়োজনীয় বিল্ড কনফিগারেশনের তালিকা দেওয়া হয়েছে। এই নির্দেশাবলীতে ধরে নেওয়া হয়েছে যে আপনার একটি অ্যান্ড্রয়েড আইডিই (IDE) ইনস্টল করা আছে এবং আপনি অ্যান্ড্রয়েড ডেভেলপমেন্টের সাথে পরিচিত।

নেভিগেশন এসডিকে ব্যবহারের জন্য ন্যূনতম প্রয়োজনীয়তা

এই শর্তাবলী Navigation SDK for Android সংস্করণ 4.99 এবং তার পূর্ববর্তী সংস্করণগুলোর ক্ষেত্রে প্রযোজ্য।

  • একটি গুগল ক্লাউড কনসোল

    নেভিগেশন এসডিকে সক্রিয় করা প্রজেক্ট। প্রোভিশনিং-এর জন্য আপনার গুগল ম্যাপস প্ল্যাটফর্ম প্রতিনিধির সাথে যোগাযোগ করুন।

  • আপনার অ্যাপটিকে অবশ্যই এপিআই লেভেল ৩০ বা তার বেশি টার্গেট করতে হবে।

  • নেভিগেশন এসডিকে দিয়ে তৈরি কোনো অ্যাপ চালানোর জন্য অ্যান্ড্রয়েড ডিভাইসটিতে গুগল প্লে সার্ভিসেস ইনস্টল এবং সক্রিয় থাকতে হবে।

  • অ্যাপটিতে অ্যাট্রিবিউশন এবং লাইসেন্সিং টেক্সট অবশ্যই যোগ করতে হবে।

আপনার প্রজেক্টগুলো সেট আপ করুন: ক্লাউড কনসোল প্রজেক্ট এবং অ্যান্ড্রয়েড প্রজেক্ট

একটি অ্যাপ বিল্ড বা টেস্ট করার আগে, আপনাকে একটি ক্লাউড কনসোল প্রজেক্ট তৈরি করতে হবে এবং এপিআই কী ক্রেডেনশিয়াল যোগ করতে হবে। নেভিগেশন এসডিকে অ্যাক্সেস করার জন্য প্রজেক্টটিতে অবশ্যই প্রোভিজনিং থাকতে হবে। ক্লাউড কনসোল প্রজেক্টের মধ্যে থাকা সমস্ত কী-কে নেভিগেশন এসডিকে-তে একই অ্যাক্সেস দেওয়া হয়। একটি কী-এর সাথে একাধিক ডেভেলপমেন্ট প্রজেক্ট যুক্ত থাকতে পারে। যদি আপনার আগে থেকেই একটি কনসোল প্রজেক্ট থাকে, তবে আপনি আপনার বর্তমান প্রজেক্টে একটি কী যোগ করতে পারেন।

সেট আপ করতে

  1. আপনার পছন্দের ওয়েব ব্রাউজারে ক্লাউড কনসোলে সাইন ইন করুন এবং আপনার ক্লাউড কনসোল প্রজেক্ট তৈরি করুন।
  2. আপনার IDE- তে, যেমন অ্যান্ড্রয়েড স্টুডিওতে, একটি অ্যান্ড্রয়েড অ্যাপ ডেভেলপমেন্ট প্রজেক্ট তৈরি করুন এবং প্যাকেজ নামটি নোট করে রাখুন।
  3. আপনার ক্লাউড কনসোল প্রোজেক্টের জন্য নেভিগেশন এসডিকে-তে অ্যাক্সেস পেতে আপনার গুগল ম্যাপস প্ল্যাটফর্ম প্রতিনিধির সাথে যোগাযোগ করুন।
  4. আপনার ওয়েব ব্রাউজারে ক্লাউড কনসোল ড্যাশবোর্ডে থাকাকালীন, সীমাবদ্ধতাসহ একটি এপিআই কী তৈরি করার জন্য ক্রেডেনশিয়াল তৈরি করুন।
  5. এপিআই কী পেজে , অ্যাপ্লিকেশন সীমাবদ্ধতা অংশে অ্যান্ড্রয়েড অ্যাপস-এ ক্লিক করুন।
  6. 'Add the package name and fingerprint'-এ ক্লিক করুন, এবং তারপরে আপনার ডেভেলপমেন্ট প্রজেক্টের প্যাকেজ নাম এবং সেই কী-এর SHA-1 ফিঙ্গারপ্রিন্টটি প্রবেশ করান।
  7. সংরক্ষণ করুন- এ ক্লিক করুন।

আপনার প্রজেক্টে নেভিগেশন SDK যোগ করুন

ন্যাভিগেশন এসডিকে-টি মেভেন ব্যবহার করে অথবা একটি এএআর বান্ডেল হিসেবে পাওয়া যায়। আপনার ডেভেলপমেন্ট প্রজেক্ট তৈরি করার পর, আপনি নিম্নলিখিত পদ্ধতিগুলোর যেকোনো একটি ব্যবহার করে এসডিকে-টি এতে ইন্টিগ্রেট করতে পারেন।

Maven for Navigation SDK v4.5 এবং পরবর্তী সংস্করণ ব্যবহার করুন (প্রস্তাবিত)।

নিম্নলিখিতটিতে google() Maven রিপোজিটরি ব্যবহার করা হয়েছে, যা আপনার প্রোজেক্টে নেভিগেশন SDK যোগ করার সবচেয়ে সহজ এবং প্রস্তাবিত উপায়।

  1. আপনার Gradle বা Maven কনফিগারেশনে নিম্নলিখিত ডিপেন্ডেন্সিটি যোগ করুন, যেখানে VERSION_NUMBER প্লেসহোল্ডারটির জায়গায় Android-এর জন্য Navigation SDK-এর ভার্সনটি বসান।

    গ্রেডল

    আপনার মডিউল-স্তরের 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'
       }
}
}

    ম্যাভেন

    আপনার pom.xml এ নিম্নলিখিতটি যোগ করুন:

    <dependencies>
...
<dependency>
     <groupId>com.google.android.libraries.navigation</groupId>
     <artifactId>navigation</artifactId>
     <version>VERSION_NUMBER</version>
</dependency>
</dependencies>

    আপনার যদি এমন কোনো ডিপেন্ডেন্সি থাকে যা ম্যাপস এসডিকে (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>

Maven for Navigation SDK v4.5-এর পূর্ববর্তী সংস্করণ, অথবা Driver SDK-এর সাথে ব্যবহার করুন।

v4 সংস্করণগুলোর বাকি অংশ জুড়ে নেভিগেশন SDK মূল Maven রিপোজিটরি ব্যবহার করে পাওয়া যাবে। এটি পূর্ববর্তী সংস্করণের মতোই একই লাইব্রেরি এবং এতে সমস্ত আপডেট রয়েছে। এটি রূপান্তরের সময় ড্রাইভার SDK এবং অন্যান্য লাইব্রেরির সাথে সামঞ্জস্যতা প্রদান করে। এই ডিপেন্ডেন্সিটি ব্যবহার করার জন্য কম্পাইল করার সময় gcloud ব্যবহার করে আপনার ক্লাউড প্রজেক্টে লগ ইন করতে হবে।

  1. কনজিউমার এসডিকে ডকুমেন্টেশনের পূর্বশর্ত বিভাগে বর্ণিত পদ্ধতি অনুসারে গুগলের ম্যাভেন রিপোজিটরি অ্যাক্সেস করার জন্য আপনার পরিবেশ প্রস্তুত করুন। নেভিগেশন এসডিকে-তে অ্যাক্সেস একটি ওয়ার্কস্পেস গ্রুপের মাধ্যমে নিয়ন্ত্রিত হয়।

  2. আপনার Gradle বা Maven কনফিগারেশনে নিম্নলিখিত ডিপেন্ডেন্সিটি যোগ করুন, যেখানে VERSION_NUMBER প্লেসহোল্ডারটির জায়গায় Navigation SDK-এর ভার্সনটি বসান।

    গ্রেডল

    আপনার মডিউল-স্তরের 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'
        }
}
}

    ম্যাভেন

    আপনার pom.xml এ নিম্নলিখিতটি যোগ করুন:

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

    আপনার যদি এমন কোনো ডিপেন্ডেন্সি থাকে যা ম্যাপস এসডিকে (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>

ডাউনলোড করা AAR বান্ডেল ব্যবহার করুন (যা সুপারিশ করা হয় না)

ন্যাভিগেশন এসডিকে একটি এএআর বান্ডেল হিসেবেও পাওয়া যায়। ডেভেলপমেন্ট প্রজেক্ট তৈরি করার পর, আপনি এসডিকে-টি ইন্টিগ্রেট করতে পারবেন। এই নির্দেশাবলীতে ধরে নেওয়া হয়েছে যে আপনি আপনার আইডিই (IDE) হিসেবে অ্যান্ড্রয়েড স্টুডিও ব্যবহার করছেন।

  1. শেয়ার করা গুগল ড্রাইভ থেকে নেভিগেশন এসডিকে-এর সর্বশেষ সংস্করণটি ডাউনলোড করে এক্সট্র্যাক্ট করুন। আপনার অ্যাক্সেস না থাকলে, আপনার প্রতিনিধির সাথে যোগাযোগ করুন।

  2. অ্যান্ড্রয়েড স্টুডিওতে একটি প্রজেক্ট খুলুন এবং এসডিকে ম্যানেজার ব্যবহার করে গুগল প্লে সার্ভিসেস প্যাকেজটি যুক্ত করুন ।

  3. zip ফাইল ডিরেক্টরি থেকে libs/google_navigation_navmap.aar ফাইলটি আপনার প্রোজেক্টের app/libs ডিরেক্টরিতে কপি করুন।

  4. আপনার মডিউল-স্তরের 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'
       }
   }
}

বিল্ডটি কনফিগার করুন

প্রজেক্টটি তৈরি করার পরে, আপনি নেভিগেশন এসডিকে-এর সফল বিল্ড ও ব্যবহারের জন্য সেটিংস কনফিগার করতে পারেন।

স্থানীয় সম্পত্তি আপডেট করুন

  • Gradle Scripts ফোল্ডারে , local.properties ফাইলটি খুলুন এবং android.useDeprecatedNdk=true যোগ করুন।

গ্রেডল বিল্ড স্ক্রিপ্ট আপডেট করুন

  • build.gradle (Module:app) ফাইলটি খুলুন এবং নেভিগেশন SDK-এর প্রয়োজনীয়তা পূরণের জন্য নিম্নলিখিত নির্দেশিকা ব্যবহার করে সেটিংস আপডেট করুন, সেইসাথে অপটিমাইজেশন অপশনগুলোও সেট করার কথা বিবেচনা করুন।

    নেভিগেশন এসডিকে-এর জন্য প্রয়োজনীয় সেটিংস

    1. minSdkVersion ২৩ বা তার বেশি সেট করুন।
    2. targetSdkVersion ৩০ বা তার বেশি সেট করুন।
    3. একটি dexOptions সেটিং যোগ করুন যা javaMaxHeapSize বৃদ্ধি করে।
    4. অতিরিক্ত লাইব্রেরিগুলোর জন্য অবস্থান নির্ধারণ করুন।
    5. নেভিগেশন এসডিকে-এর জন্য repositories এবং dependencies যোগ করুন।
    6. ডিপেন্ডেন্সিগুলোতে থাকা ভার্সন নম্বরগুলো সর্বশেষ উপলব্ধ ভার্সন দিয়ে প্রতিস্থাপন করুন।

    বিল্ড টাইম কমানোর জন্য ঐচ্ছিক সেটিংস

    • ডিপেন্ডেন্সি থেকে অব্যবহৃত কোড এবং রিসোর্স অপসারণ করতে R8/ProGuard ব্যবহার করে কোড সঙ্কুচিতকরণ এবং রিসোর্স সঙ্কুচিতকরণ সক্ষম করুন। যদি R8/ProGuard ধাপটি চলতে খুব বেশি সময় নেয়, তবে ডেভেলপমেন্টের কাজের জন্য মাল্টিডেক্স সক্ষম করার কথা বিবেচনা করুন।
    • বিল্ডে অন্তর্ভুক্ত ভাষা অনুবাদের সংখ্যা কমান: ডেভেলপমেন্টের সময় একটি ভাষার জন্য resConfigs সেট করুন। চূড়ান্ত বিল্ডের জন্য, আপনি প্রকৃতপক্ষে যে ভাষাগুলো ব্যবহার করেন সেগুলোর জন্য resConfigs সেট করুন। ডিফল্টরূপে, Gradle নেভিগেশন 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'
}

আপনার অ্যাপে এপিআই কী যোগ করুন

এই বিভাগে বর্ণনা করা হয়েছে কীভাবে আপনার API কী সংরক্ষণ করবেন, যাতে আপনার অ্যাপ এটিকে নিরাপদে ব্যবহার করতে পারে। আপনার ভার্সন কন্ট্রোল সিস্টেমে API কী চেক ইন করা উচিত নয়, তাই আমরা এটিকে secrets.properties ফাইলে সংরক্ষণ করার পরামর্শ দিই, যা আপনার প্রোজেক্টের রুট ডিরেক্টরিতে অবস্থিত। secrets.properties ফাইল সম্পর্কে আরও তথ্যের জন্য, Gradle properties files দেখুন।

এই কাজটি সহজ করার জন্য, আমরা আপনাকে অ্যান্ড্রয়েডের জন্য সিক্রেটস গ্রেডল প্লাগইন ব্যবহার করার পরামর্শ দিই।

অ্যান্ড্রয়েডের জন্য সিক্রেটস গ্রেডল প্লাগইন ইনস্টল করতে এবং আপনার এপিআই কী সংরক্ষণ করতে:

  1. অ্যান্ড্রয়েড স্টুডিওতে, আপনার রুট-লেভেলের build.gradle ফাইলটি খুলুন এবং buildscript অধীনে dependencies এলিমেন্টে নিম্নলিখিত কোডটি যোগ করুন।

    গ্রুভি 

    buildscript {
    dependencies {
        // ...
        classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1"
    }
}

    কোটলিন 

    buildscript {
    dependencies {
        // ...
        classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1")
    }
}
  2. আপনার অ্যাপ-লেভেলের build.gradle ফাইলটি খুলুন এবং plugins এলিমেন্টে নিম্নলিখিত কোডটি যোগ করুন।

    গ্রুভি 

    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")
}
  3. আপনি যদি অ্যান্ড্রয়েড স্টুডিও ব্যবহার করেন, তাহলে আপনার প্রজেক্টটি গ্রেডলের সাথে সিঙ্ক করুন ।
  4. আপনার প্রজেক্ট লেভেল ডিরেক্টরিতে থাকা local.properties ফাইলটি খুলুন এবং নিচের কোডটি যোগ করুন। YOUR_API_KEY এর জায়গায় আপনার API কী বসান। 
    MAPS_API_KEY=YOUR_API_KEY
  5. আপনি আপনার AndroidManifest.xml ফাইলে API কী যোগ করতে পারেন অথবা প্রোগ্রাম্যাটিকভাবে API কী প্রদান করতে পারেন।
    • আপনার API কী AndroidManifest.xml এ যোগ করুন: 
      <meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="${MAPS_API_KEY}" />

      দ্রষ্টব্য: এপিআই কী-এর জন্য com.google.android.geo.API_KEY হলো প্রস্তাবিত মেটাডেটা নাম। এই নামের একটি কী অ্যান্ড্রয়েড প্ল্যাটফর্মে একাধিক গুগল ম্যাপস-ভিত্তিক এপিআই-তে প্রমাণীকরণের জন্য ব্যবহার করা যেতে পারে, যার মধ্যে অ্যান্ড্রয়েডের জন্য নেভিগেশন এসডিকে অন্তর্ভুক্ত। পূর্ববর্তী সংস্করণের সাথে সামঞ্জস্যের জন্য, এপিআইটি com.google.android.maps.v2.API_KEY নামটি সমর্থন করে। এই পুরোনো নামটি শুধুমাত্র অ্যান্ড্রয়েড ম্যাপস এপিআই v2-তে প্রমাণীকরণের অনুমতি দেয়। একটি অ্যাপ্লিকেশন এপিআই কী মেটাডেটা নামগুলোর মধ্যে শুধুমাত্র একটি নির্দিষ্ট করতে পারে। যদি উভয়ই নির্দিষ্ট করা হয়, তাহলে এপিআই একটি ব্যতিক্রমী ত্রুটি (exception) দেখায়।

    • প্রোগ্রামের মাধ্যমে এপিআই কী প্রদান করুন:

      Secrets Gradle Plugin-টি BuildConfig ক্লাসে key-টি উপলব্ধ করে। আপনার অ্যাপের ইনিশিয়ালাইজেশনের সময় (উদাহরণস্বরূপ, আপনার Application.onCreate() মেথডে), নিম্নলিখিতভাবে মেথডটি কল করুন:

      কোটলিন

      1. নিম্নলিখিত ইম্পোর্ট স্টেটমেন্টগুলো যোগ করুন: 
        import com.google.android.libraries.navigation.NavigationApi
      2. আপনার Application.onCreate() মেথডে নিম্নলিখিতটি যোগ করুন: 
        NavigationApi.setApiKey(BuildConfig.MAPS_API_KEY)

      জাভা

      1. নিম্নলিখিত ইম্পোর্ট স্টেটমেন্টগুলো যোগ করুন: 
        import com.google.android.libraries.navigation.NavigationApi;
      2. আপনার Application.onCreate() মেথডে নিম্নলিখিতটি যোগ করুন: 
        NavigationApi.setApiKey(BuildConfig.MAPS_API_KEY);
      দ্রষ্টব্য: setApiKey() ব্যবহার করার সময় নিম্নলিখিত বিষয়গুলো মনে রাখবেন:
      • একটি নন-নাল ও নন-এম্পটি এপিআই কী প্রদান করুন।
      • আপনার অ্যাপ্লিকেশনের জীবনকালে setApiKey() শুধুমাত্র একবার কল করুন। একাধিকবার কল করা হলে পদ্ধতিটি একটি IllegalStateException থ্রো করে।
      • Navigator মতো অন্য যেকোনো নেভিগেশন SDK কম্পোনেন্ট ইনিশিয়ালাইজ করার আগে setApiKey() কল করুন।
      • এই মেথডের সাথে আপনি যে কী প্রদান করেন, তা আপনার AndroidManifest.xml এ থাকা যেকোনো API কী-কে ওভাররাইড করে।
      • নেভিগেশন এসডিকে সংস্করণ ৭.৬ বা তার উচ্চতর সংস্করণ ব্যবহার করুন।

আপনার অ্যাপে প্রয়োজনীয় অ্যাট্রিবিউশন অন্তর্ভুক্ত করুন।

আপনি যদি আপনার অ্যাপে অ্যান্ড্রয়েডের জন্য নেভিগেশন এসডিকে ব্যবহার করেন, তাহলে আপনাকে অবশ্যই আপনার অ্যাপের আইনি বিজ্ঞপ্তি বিভাগের অংশ হিসেবে অ্যাট্রিবিউশন টেক্সট এবং ওপেন সোর্স লাইসেন্স অন্তর্ভুক্ত করতে হবে।

আপনি Navigation SDK for Android zip ফাইলটিতে প্রয়োজনীয় অ্যাট্রিবিউশন টেক্সট এবং ওপেন সোর্স লাইসেন্সগুলো খুঁজে পাবেন:

  • NOTICE.txt
  • LICENSES.txt