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

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

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

  1. অ্যান্ড্রয়েড স্টুডিও আর্কটিক ফক্স বা তার পরে প্রয়োজন। আপনি যদি ইতিমধ্যে এটি না করে থাকেন তবে এটি ডাউনলোড করুন এবং ইনস্টল করুন
  2. নিশ্চিত করুন যে আপনি Android স্টুডিওতে Android Gradle প্লাগইন সংস্করণ 7.0 বা তার পরবর্তী সংস্করণ ব্যবহার করছেন।

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

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

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

    dependencies {
        implementation 'com.google.android.libraries.places:places:3.1.0'
    }
    
  4. আপনার মডিউল-স্তরের build.gradle ফাইলে, compileSdk এবং minSdk নিম্নলিখিত মানগুলিতে সেট করুন:
    android {
        compileSdk 31
    
        defaultConfig {
            minSdk 21
            // ...
        }

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

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

এই কাজটি স্ট্রীমলাইন করতে, আমরা আপনাকে Android এর জন্য সিক্রেটস গ্রেডল প্লাগইন ব্যবহার করার পরামর্শ দিই। প্লাগইন ইনস্টল করতে এবং আপনার API কী সংরক্ষণ করতে:

  1. অ্যান্ড্রয়েড স্টুডিওতে, আপনার প্রকল্প-স্তরের build.gradle ফাইলটি খুলুন এবং buildscript অধীনে dependencies উপাদানে নিম্নলিখিত কোডটি যোগ করুন।
    plugins {
        // ...
        id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' version '2.0.1' apply false
    }
  2. এরপর, আপনার মডিউল-স্তরের build.gradle ফাইলটি খুলুন এবং plugins উপাদানটিতে নিম্নলিখিত কোডটি যোগ করুন।
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
        
  3. ফাইলটি সংরক্ষণ করুন এবং Gradle এর সাথে আপনার প্রকল্প সিঙ্ক করুন
  4. আপনার প্রজেক্ট লেভেল ডিরেক্টরিতে local.properties খুলুন এবং তারপরে নিম্নলিখিত কোডটি যোগ করুন। আপনার API কী দিয়ে YOUR_API_KEY প্রতিস্থাপন করুন।
    MAPS_API_KEY=YOUR_API_KEY
        
  5. ফাইলটি সংরক্ষণ করুন।
  6. আপনার AndroidManifest.xml ফাইলে, com.google.android.geo.API_KEY এ যান এবং android:value attribute নিম্নরূপ আপডেট করুন:
    <meta-data
        android:name="com.google.android.geo.API_KEY"
        android:value="${MAPS_API_KEY}" />
        

দ্রষ্টব্য: উপরে দেখানো হিসাবে, com.google.android.geo.API_KEY হল API কী-এর জন্য প্রস্তাবিত মেটাডেটা নাম। এই নামের একটি কী অ্যান্ড্রয়েড প্ল্যাটফর্মে একাধিক Google মানচিত্র-ভিত্তিক API-এ প্রমাণীকরণ করতে ব্যবহার করা যেতে পারে, যার মধ্যে Android এর জন্য স্থান SDK রয়েছে৷ পিছনের সামঞ্জস্যের জন্য, API com.google.android.maps.v2.API_KEY নামটিকেও সমর্থন করে। এই লিগ্যাসি নামটি শুধুমাত্র Android Maps API v2 তে প্রমাণীকরণের অনুমতি দেয়। একটি অ্যাপ্লিকেশন শুধুমাত্র API কী মেটাডেটা নামের একটি নির্দিষ্ট করতে পারে। উভয় নির্দিষ্ট করা থাকলে, API একটি ব্যতিক্রম নিক্ষেপ করে।

ধাপ 4. Places API ক্লায়েন্ট শুরু করুন

নিম্নলিখিত উদাহরণে দেখানো একটি কার্যকলাপ বা খণ্ডের মধ্যে Android-এর জন্য Places SDK শুরু করুন (মনে রাখবেন Places.initialize() কল করার সময় আপনি API কী পাস করেন ):

জাভা


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

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

      

কোটলিন


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

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

      

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

ধাপ 5: একটি Android ডিভাইস সেট আপ করুন

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

  • একটি অ্যান্ড্রয়েড ডিভাইস ব্যবহার করতে, একটি হার্ডওয়্যার ডিভাইসে অ্যাপ চালান -এ নির্দেশাবলী অনুসরণ করুন।
  • একটি অ্যান্ড্রয়েড এমুলেটর ব্যবহার করতে, আপনি একটি ভার্চুয়াল ডিভাইস তৈরি করতে পারেন এবং অ্যান্ড্রয়েড স্টুডিওর সাথে আসা অ্যান্ড্রয়েড ভার্চুয়াল ডিভাইস (এভিডি) ম্যানেজার ব্যবহার করে এমুলেটরটি ইনস্টল করতে পারেন।

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

আপনার প্রোজেক্ট কনফিগার হওয়ার পরে, আপনি নমুনা অ্যাপগুলি অন্বেষণ করতে পারেন৷