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

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

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

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

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

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

  1. আপনার টপ-লেভেল settings.gradle.kts ফাইলে, pluginManagement ব্লকের অধীনে Gradle plugin portal , Google Maven repository এবং Maven central repository অন্তর্ভুক্ত করুন। pluginManagement ব্লকটি স্ক্রিপ্টের অন্য যেকোনো স্টেটমেন্টের আগে উপস্থিত হওয়া আবশ্যক। 
    pluginManagement {
    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}
  2. আপনার শীর্ষ-স্তরের settings.gradle.kts ফাইলে, dependencyResolutionManagement ব্লকের অধীনে Google এর Maven সংগ্রহস্থল এবং Maven কেন্দ্রীয় সংগ্রহস্থল অন্তর্ভুক্ত করুন: 
    dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

  3. আপনার মডিউল -level build.gradle.kts ফাইলের dependencies বিভাগে, Android এর জন্য Places SDK-তে একটি dependency যোগ করুন:

    খাঁজকাটা 

    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")
}
  4. আপনার মডিউল-স্তরের build.gradle.kts ফাইলে, compileSdk এবং minSdk কে নিম্নলিখিত মানগুলিতে সেট করুন:

    খাঁজকাটা 

    android {
    compileSdk 34

    defaultConfig {
        minSdk 23
        // ...
    }
}

    কোটলিন 

    android {
    compileSdk = 34

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

    খাঁজকাটা 

    android {
  // ...
  buildFeatures {
    buildConfig true
    // ...
  }
}

    কোটলিন 

    android {
  // ...
  buildFeatures {
    buildConfig = true
    // ...
  }
}

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

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

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

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

  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. আপনি যদি অ্যান্ড্রয়েড স্টুডিও ব্যবহার করেন, তাহলে আপনার প্রকল্পটি Gradle এর সাথে সিঙ্ক করুন ।
  4. আপনার প্রজেক্ট লেভেল ডিরেক্টরিতে local.properties খুলুন, এবং তারপর নিম্নলিখিত কোডটি যোগ করুন। YOUR_API_KEY আপনার API কী দিয়ে প্রতিস্থাপন করুন। 
    PLACES_API_KEY=YOUR_API_KEY

ধাপ ৪. প্লেস এপিআই ক্লায়েন্ট আরম্ভ করুন

কোনও কার্যকলাপ বা খণ্ডের মধ্যে 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) ম্যানেজার ব্যবহার করে এমুলেটরটি ইনস্টল করতে পারেন।

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

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