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

আপনার অ্যাপটিকে অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে (Places SDK for Android) ব্যবহার করার উপযোগী করে তুলতে, এই ধাপগুলো অনুসরণ করুন। অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে ব্যবহারকারী সকল অ্যাপের জন্য এগুলো আবশ্যক।

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

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

ধাপ ২. এসডিকে সেট আপ করুন।

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

1. আপনার শীর্ষ-স্তরের settings.gradle.kts ফাইলে, pluginManagement ব্লকের অধীনে Gradle প্লাগইন পোর্টাল , Google Maven রিপোজিটরি এবং Maven সেন্ট্রাল রিপোজিটরি অন্তর্ভুক্ত করুন। স্ক্রিপ্টে pluginManagement ব্লকটি অবশ্যই অন্য যেকোনো স্টেটমেন্টের আগে থাকতে হবে।

   pluginManagement {
       repositories {
           google()
           mavenCentral()
           gradlePluginPortal()
       }
   } 

2. আপনার শীর্ষ-স্তরের settings.gradle.kts ফাইলে, dependencyResolutionManagement ব্লকের অধীনে Google-এর Maven রিপোজিটরি এবং Maven সেন্ট্রাল রিপোজিটরি অন্তর্ভুক্ত করুন:

   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
       repositories {
           google()
           mavenCentral()
       }
   } 

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

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 দেখুন।

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

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

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 কী বসান।

   PLACES_API_KEY=YOUR_API_KEY

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

একটি অ্যাক্টিভিটি বা ফ্র্যাগমেন্টের মধ্যে অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে (Places SDK) চালু করতে, Places.initializeWithNewPlacesApiEnabled() কল করার সময় এপিআই কী (API key) পাস করুন:

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

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

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

অ্যান্ড্রয়েডের জন্য প্লেসেস এসডিকে (Places SDK for Android) ব্যবহার করে এমন কোনো অ্যাপ চালানোর জন্য, আপনাকে অবশ্যই এটিকে অ্যান্ড্রয়েড ৫.০ বা তার উচ্চতর সংস্করণের উপর ভিত্তি করে তৈরি এবং গুগল এপিআই (Google APIs) অন্তর্ভুক্ত কোনো অ্যান্ড্রয়েড ডিভাইস বা অ্যান্ড্রয়েড এমুলেটরে স্থাপন করতে হবে।

• অ্যান্ড্রয়েড ডিভাইস ব্যবহার করতে, ‘Run apps on a hardware device’- এর নির্দেশাবলী অনুসরণ করুন।
• অ্যান্ড্রয়েড এমুলেটর ব্যবহার করার জন্য, আপনি অ্যান্ড্রয়েড স্টুডিওর সাথে আসা অ্যান্ড্রয়েড ভার্চুয়াল ডিভাইস (AVD) ম্যানেজার ব্যবহার করে একটি ভার্চুয়াল ডিভাইস তৈরি ও এমুলেটরটি ইনস্টল করতে পারেন।

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