এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

একটি অ্যান্ড্রয়েড স্টুডিও প্রকল্প সেট আপ করুন

আপনার অ্যাপটিকে Android এর জন্য Places SDK ব্যবহার করার জন্য কনফিগার করতে, এই পদক্ষেপগুলি অনুসরণ করুন। Android এর জন্য Places SDK ব্যবহার করে এমন সমস্ত অ্যাপের জন্য এগুলি প্রয়োজনীয়।

ধাপ ১: অ্যান্ড্রয়েড স্টুডিও সেট আপ করুন

এই ডকুমেন্টটি অ্যান্ড্রয়েড স্টুডিও হেজহগ এবং অ্যান্ড্রয়েড গ্রেডল প্লাগইন সংস্করণ 8.2 ব্যবহার করে একটি ডেভেলপমেন্ট পরিবেশ বর্ণনা করে।

ধাপ ২. SDK সেট আপ করুন

অ্যান্ড্রয়েড লাইব্রেরির জন্য প্লেসেস SDK গুগলের Maven রিপোজিটরির মাধ্যমে পাওয়া যায়। আপনার অ্যাপে SDK যোগ করতে, নিম্নলিখিতগুলি করুন:

আপনার টপ-লেভেল settings.gradle.kts ফাইলে, pluginManagement ব্লকের অধীনে Gradle plugin portal , Google Maven repository এবং Maven central repository অন্তর্ভুক্ত করুন। pluginManagement ব্লকটি স্ক্রিপ্টের অন্য যেকোনো স্টেটমেন্টের আগে উপস্থিত হওয়া আবশ্যক।
```
pluginManagement {
    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
} 
```
আপনার শীর্ষ-স্তরের settings.gradle.kts ফাইলে, dependencyResolutionManagement ব্লকের অধীনে Google এর Maven সংগ্রহস্থল এবং Maven কেন্দ্রীয় সংগ্রহস্থল অন্তর্ভুক্ত করুন:
```
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
} 
```
আপনার মডিউল -level build.gradle.kts ফাইলের dependencies বিভাগে, Android এর জন্য Places SDK-তে একটি dependency যোগ করুন:
দ্রষ্টব্য: অ্যান্ড্রয়েড সংস্করণ 3.5.0 এর জন্য Places SDK-এর জন্য kotlin-bom 1.8.0 বা তার পরবর্তী সংস্করণ প্রয়োজন। kotlin-bom নির্ভরতা সম্পর্কে আরও তথ্যের জন্য, transitive dependencies-এ সর্বশেষ kotlin-stdlib সংস্করণের ব্যবহার দেখুন।
খাঁজকাটা
```
dependencies {
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
    implementation("com.google.android.libraries.places:places:3.5.0")
}
```
কোটলিন
```
          dependencies {

    // Places and Maps SDKs
    implementation("com.google.android.libraries.places:places:5.0.0")
}
```
আপনার মডিউল-স্তরের build.gradle.kts ফাইলে, compileSdk এবং minSdk কে নিম্নলিখিত মানগুলিতে সেট করুন:
দ্রষ্টব্য: নিশ্চিত করুন যে compileSdk 34 বা তার বেশি এবং minSdk 23 বা তার বেশি সেট করা আছে।
খাঁজকাটা
```
android {
    compileSdk 34

    defaultConfig {
        minSdk 23
        // ...
    }
}
```
কোটলিন
```
android {
    compileSdk = 34

    defaultConfig {
        minSdk = 23
        // ...
    }
}
```
আপনার মডিউল-লেভেল build.gradle ফাইলের buildFeatures বিভাগে, BuildConfig ক্লাসটি যোগ করুন, যা আপনি এই পদ্ধতিতে পরে সংজ্ঞায়িত মেটাডেটা মানগুলি অ্যাক্সেস করতে ব্যবহার করেন:
খাঁজকাটা
```
android {
  // ...
  buildFeatures {
    buildConfig true
    // ...
  }
}
```
কোটলিন
```
android {
  // ...
  buildFeatures {
    buildConfig = true
    // ...
  }
}
```

ধাপ ৩: প্রকল্পে আপনার API কী যোগ করুন

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

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

আপনার গুগল ম্যাপস প্রজেক্টে অ্যান্ড্রয়েডের জন্য সিক্রেটস গ্রেডল প্লাগইন ইনস্টল করতে:

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

কোটলিন

plugins {
    alias(libs.plugins.android.application) apply false
    alias(libs.plugins.jetbrains.kotlin.android) apply false
    alias(libs.plugins.kotlin.compose) apply false
    alias(libs.plugins.secrets.gradle.plugin) apply false
}

খাঁজকাটা

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

আপনার মডিউল-স্তরের build.gradle.kts অথবা build.gradle ফাইলটি খুলুন এবং plugins উপাদানে নিম্নলিখিত কোডটি যোগ করুন।
কোটলিন
```
plugins {
    // ...
    alias(libs.plugins.secrets.gradle.plugin)
}
```
খাঁজকাটা
```
plugins {
    // ...
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
}
```
আপনার মডিউল-স্তরের build.gradle.kts অথবা build.gradle ফাইলে, নিশ্চিত করুন যে targetSdk এবং compileSdk 34 তে সেট করা আছে।
আপনার প্রকল্পটি Gradle এর সাথে সিঙ্ক করুন ।
আপনার টপ-লেভেল ডিরেক্টরিতে secrets.properties ফাইলটি খুলুন, এবং তারপর নিম্নলিখিত কোডটি যোগ করুন। YOUR_API_KEY আপনার API কী দিয়ে প্রতিস্থাপন করুন। এই ফাইলটিতে আপনার কীটি সংরক্ষণ করুন কারণ secrets.properties একটি সংস্করণ নিয়ন্ত্রণ সিস্টেমে চেক করা থেকে বাদ দেওয়া হয়।
দ্রষ্টব্য: যদি secrets.properties ফাইলটি বিদ্যমান না থাকে, তাহলে এটি local.properties ফাইলের মতো একই ফোল্ডারে তৈরি করুন।
```
PLACES_API_KEY=YOUR_API_KEY
```
আপনার টপ-লেভেল ডিরেক্টরিতে secrets.properties ফাইলের মতো একই ফোল্ডারে local.defaults.properties ফাইলটি তৈরি করুন এবং তারপর নিম্নলিখিত কোডটি যোগ করুন।
দ্রষ্টব্য: দেখানো কোডটি লিখুন। DEFAULT_API_KEY আপনার API কী দিয়ে প্রতিস্থাপন করবেন না।
```
PLACES_API_KEY=DEFAULT_API_KEY
```
এই ফাইলটির উদ্দেশ্য হল যদি secrets.properties ফাইলটি না পাওয়া যায়, তাহলে API কী-এর জন্য একটি ব্যাকআপ লোকেশন প্রদান করা যাতে বিল্ডগুলি ব্যর্থ না হয়। এটি ঘটতে পারে যদি আপনি এমন একটি সংস্করণ নিয়ন্ত্রণ ব্যবস্থা থেকে অ্যাপটি ক্লোন করেন যা secrets.properties বাদ দেয় এবং আপনি এখনও আপনার API কী প্রদানের জন্য স্থানীয়ভাবে একটি secrets.properties ফাইল তৈরি না করেন।

অ্যান্ড্রয়েড স্টুডিওতে, আপনার মডিউল-লেভেল build.gradle.kts অথবা build.gradle ফাইলটি খুলুন এবং secrets সম্পত্তিটি সম্পাদনা করুন। যদি secrets সম্পত্তিটি বিদ্যমান না থাকে, তাহলে এটি যোগ করুন।

প্লাগইনের বৈশিষ্ট্য সম্পাদনা করে propertiesFileName কে secrets.properties এ সেট করুন, 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 same folder as the 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 same folder as the 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 এর জন্য Places SDK আরম্ভ করতে, Places.initializeWithNewPlacesApiEnabled() কল করার সময় API কীটি পাস করুন:

কোটলিন

    // Define a variable to hold the Places API key.
    val apiKey = BuildConfig.PLACES_API_KEY

    // Log an error if apiKey is not set.
    if (apiKey.isEmpty() || apiKey == "DEFAULT_API_KEY") {
        Log.e("Places test", "No api key")
        finish()
        return
    }

    // Initialize the SDK
    Places.initializeWithNewPlacesApiEnabled(applicationContext, apiKey)

    // Create a new PlacesClient instance
    val placesClient = Places.createClient(this)

জাভা

    // Define a variable to hold the Places API key.
    String apiKey = BuildConfig.PLACES_API_KEY;

    // Log an error if apiKey is not set.
    if (TextUtils.isEmpty(apiKey) || apiKey.equals("DEFAULT_API_KEY")) {
      Log.e("Places test", "No api key");
      finish();
      return;
    }

    // Initialize the SDK
    Places.initializeWithNewPlacesApiEnabled(getApplicationContext(), apiKey);

    // Create a new PlacesClient instance
    PlacesClient placesClient = Places.createClient(this);

আপনি এখন অ্যান্ড্রয়েডের জন্য প্লেস SDK ব্যবহার শুরু করতে প্রস্তুত!

ধাপ ৫: একটি অ্যান্ড্রয়েড ডিভাইস সেট আপ করুন

Android এর জন্য Places SDK ব্যবহার করে এমন একটি অ্যাপ চালানোর জন্য, আপনাকে এটিকে এমন একটি Android ডিভাইস বা Android এমুলেটরে স্থাপন করতে হবে যা Android 5.0 বা উচ্চতর সংস্করণের উপর ভিত্তি করে এবং Google API অন্তর্ভুক্ত করে।

একটি অ্যান্ড্রয়েড ডিভাইস ব্যবহার করতে, হার্ডওয়্যার ডিভাইসে অ্যাপস চালান -এ দেওয়া নির্দেশাবলী অনুসরণ করুন।
অ্যান্ড্রয়েড এমুলেটর ব্যবহার করার জন্য, আপনি একটি ভার্চুয়াল ডিভাইস তৈরি করতে পারেন এবং অ্যান্ড্রয়েড স্টুডিওর সাথে আসা অ্যান্ড্রয়েড ভার্চুয়াল ডিভাইস (AVD) ম্যানেজার ব্যবহার করে এমুলেটরটি ইনস্টল করতে পারেন।
দ্রষ্টব্য: যদি আপনি একটি অ্যান্ড্রয়েড এমুলেটর ব্যবহার করতে চান, তাহলে নিশ্চিত করুন যে আপনি Play আইকন সহ একটি ডিভাইস বেছে নিয়েছেন, , প্লে স্টোর কলামের নিচে প্রদর্শিত হবে। এই আইকনটি নির্দেশ করে যে এই প্রোফাইলগুলি সম্পূর্ণরূপে CTS অনুগত এবং প্লে স্টোর অ্যাপ অন্তর্ভুক্ত সিস্টেম চিত্র ব্যবহার করতে পারে:

পরবর্তী পদক্ষেপ

আপনার প্রকল্পটি কনফিগার করার পরে, আপনি নমুনা অ্যাপগুলি অন্বেষণ করতে পারেন।