আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

Android Studio প্রোজেক্ট সেট-আপ করা

Android-এর জন্য Places SDK ব্যবহার করতে আপনার অ্যাপ কনফিগার করতে, এই ধাপগুলি অনুসরণ করুন। Android-এর জন্য Places SDK ব্যবহার করা সব অ্যাপের জন্য এগুলি প্রয়োজন।

ধাপ ১: Android Studio সেট-আপ করা

এই ডকুমেন্টে Android Studio Hedgehog এবং Android Gradle প্লাগ-ইন ভার্সন ৮.২ ব্যবহার করে ডেভেলপমেন্ট এনভায়রনমেন্টের বর্ণনা দেওয়া হয়েছে।

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

Android লাইব্রেরির জন্য Places SDK, Google-এর Maven রিপোজিটরি-এর মাধ্যমে উপলভ্য। আপনার অ্যাপে SDK যোগ করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

আপনার টপ-লেভেল settings.gradle.kts ফাইলে, pluginManagement ব্লকের অধীনে Gradle প্লাগ-ইন পোর্টাল, Google Maven রিপোজিটরি এবং Maven সেন্ট্রাল রিপোজিটরি অন্তর্ভুক্ত করুন। স্ক্রিপ্টের অন্য যেকোনও স্টেটমেন্টের আগে pluginManagement ব্লকটি অবশ্যই থাকতে হবে।
```
pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
} 
```
আপনার টপ-লেভেল settings.gradle.kts ফাইলে, dependencyResolutionManagement ব্লকের মধ্যে Google-এর Maven রিপোজিটরি এবং Maven সেন্ট্রাল রিপোজিটরি অন্তর্ভুক্ত করুন:
```
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    repositories {
        google()
        mavenCentral()
    }
} 
```
আপনার মডিউল-লেভেল build.gradle.kts ফাইলের dependencies বিভাগে, Android-এর জন্য Places SDK-তে একটি ডিপেন্ডেন্সি যোগ করুন:

মনে রাখবেন: Android ভার্সন 3.5.0-এর জন্য Places SDK-তে kotlin-bom 1.8.0 বা তার পরবর্তী ভার্সন প্রয়োজন। kotlin-bom ডিপেন্ডেন্সি সম্পর্কে আরও জানতে, ট্রানজিটিভ ডিপেন্ডেন্সিতে লেটেস্ট kotlin-stdlib ভার্সনের ব্যবহার দেখুন।
Groovy
```
dependencies {
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
    implementation("com.google.android.libraries.places:places:3.5.0")
}
```
Kotlin
```
          dependencies {

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

    defaultConfig {
        minSdk 23
        // ...
    }
}
```
Kotlin
```
android {
    compileSdk = 34

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

ধাপ ৩: প্রোজেক্টে আপনার API key যোগ করুন

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

এই টাস্ক আরও সহজ করতে, আমরা আপনাকে Android-এর জন্য Secrets Gradle প্লাগ-ইন ব্যবহার করার সাজেশন দিই।

Android-এর জন্য Secrets Gradle প্লাগ-ইন ইনস্টল করতে এবং আপনার API key স্টোর করতে:

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
}

Groovy

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")
}

Groovy

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

আপনি Android Studio ব্যবহার করলে, Gradle-এর সাথে আপনার প্রজেক্ট সিঙ্ক করুন।
আপনার টপ-লেভেল ডিরেক্টরিতে secrets.properties ফাইলটি খুলুন, এবং তারপরে নিম্নলিখিত কোডটি যোগ করুন। আপনার API key দিয়ে YOUR_API_KEY পরিবর্তন করুন। আপনার .gitignore ফাইলে secrets.properties যোগ করতে ভুলবেন না (অথবা আপনার ভার্সন কন্ট্রোল সিস্টেম থেকে এটি বাদ দিন) যাতে আপনি ভার্সন কন্ট্রোলে আপনার API কী চেক না করেন।
মনে রাখবেন: যদি secrets.properties ফাইলটি না থাকে, তাহলে local.properties ফাইলের মতো একই ফোল্ডারে এটি তৈরি করুন।
```
PLACES_API_KEY=YOUR_API_KEY
```
আপনার টপ-লেভেল ডিরেক্টরিতে local.defaults.properties ফাইল তৈরি করুন, secrets.properties ফাইলের মতো একই ফোল্ডার এবং তারপর নিম্নলিখিত কোড যোগ করুন।

মনে রাখবেন: যেভাবে দেখানো হয়েছে সেইভাবেই কোডটি লিখুন। আপনার API key দিয়ে DEFAULT_API_KEY পরিবর্তন করবেন না।
```
PLACES_API_KEY=DEFAULT_API_KEY
```
এই ফাইলের উদ্দেশ্য হল API কী-এর জন্য একটি ব্যাক-আপ লোকেশন প্রদান করা যদি secrets.properties ফাইলটি খুঁজে না পাওয়া যায় যাতে বিল্ড ব্যর্থ না হয়। আপনি যদি কোনও ভার্সন কন্ট্রোল সিস্টেম থেকে অ্যাপ ক্লোন করেন যা secrets.properties বাদ দেয় এবং আপনি এখনও API কী প্রদান করার জন্য স্থানীয়ভাবে secrets.properties ফাইল তৈরি না করে থাকেন, তাহলে এটি হতে পারে।

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"
}

Groovy

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"
}

ধাপ ৪. Places API ক্লায়েন্ট শুরু করা

কোনও অ্যাক্টিভিটি বা ফ্র্যাগমেন্টের মধ্যে Android-এর জন্য Places SDK শুরু করতে, Places.initializeWithNewPlacesApiEnabled() কল করার সময় API কী পাস করুন:

Kotlin

    // 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)

Java

    // 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);

আপনি এখন Android-এর জন্য Places SDK ব্যবহার করা শুরু করার জন্য প্রস্তুত!

ধাপ ৫: Android ডিভাইস সেট-আপ করা

Android-এর জন্য Places SDK ব্যবহার করে এমন অ্যাপ চালাতে, আপনাকে অবশ্যই এটি একটি Android ডিভাইস বা Android এমুলেটরে ডিপ্লয় করতে হবে যা Android 6.0 বা তার পরবর্তী ভার্সনের উপর ভিত্তি করে এবং এতে Google API অন্তর্ভুক্ত রয়েছে।

Android ডিভাইস ব্যবহার করতে, হার্ডওয়্যার ডিভাইসে অ্যাপ রান করান লিঙ্কে গিয়ে নির্দেশাবলী অনুসরণ করুন।
Android এমুলেটর ব্যবহার করতে, আপনি ভার্চুয়াল ডিভাইস তৈরি করতে এবং ডিভাইস ম্যানেজার ব্যবহার করে এমুলেটর ইনস্টল করতে পারবেন যা Android Studio-এর সাথে আসে।
মনে রাখবেন: আপনি Android এমুলেটর ব্যবহার করার বিকল্প বেছে নিলে, নিশ্চিত করুন যে আপনি এমন একটি ডিভাইস প্রোফাইল বেছে নিয়েছেন যার মধ্যে Play আইকন, , Play Store কলামের অধীনে দেখানো হয়েছে। এই আইকন থেকে বোঝা যায় যে এইসব প্রোফাইল সম্পূর্ণভাবে CTS মেনে চলে এবং সিস্টেম ইমেজ ব্যবহার করতে পারে যার মধ্যে Play Store অ্যাপ অন্তর্ভুক্ত।

পরবর্তী ধাপ

আপনার প্রোজেক্ট কনফিগার করার পরে, আপনি স্যাম্পেল অ্যাপ এক্সপ্লোর করতে পারবেন।