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

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

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

এই নথিটি Android Studio Hedgehog এবং Android Gradle প্লাগইন সংস্করণ 8.2 ব্যবহার করে একটি উন্নয়ন পরিবেশ বর্ণনা করে।

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

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

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

    গ্রোভি

    dependencies {
        // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable
        implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
        implementation 'com.google.android.libraries.places:places:3.3.0'
    }

    কোটলিন

    dependencies {
        implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
        implementation("com.google.android.libraries.places:places:3.5.0")
    }
  4. আপনার মডিউল-স্তরের build.gradle ফাইলে, 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
        // ...
      }
    }

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

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

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

আপনার Google মানচিত্র প্রকল্পে Android এর জন্য Secrets Gradle Plugin ইনস্টল করতে:

  1. অ্যান্ড্রয়েড স্টুডিওতে, আপনার শীর্ষ-স্তরের build.gradle.kts বা 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.kts বা build.gradle ফাইল খুলুন এবং plugins উপাদানে নিম্নলিখিত কোড যোগ করুন।

    কোটলিন

    plugins {
        // ...
        id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
    }

    গ্রোভি

    plugins {
        // ...
        id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
    }
  3. আপনার মডিউল-স্তরের build.gradle.kts বা build.gradle ফাইলে, নিশ্চিত করুন যে targetSdk এবং compileSdk 34-এ সেট করা আছে।
  4. ফাইলটি সংরক্ষণ করুন এবং Gradle এর সাথে আপনার প্রকল্প সিঙ্ক করুন
  5. আপনার শীর্ষ-স্তরের ডিরেক্টরিতে secrets.properties ফাইলটি খুলুন এবং তারপরে নিম্নলিখিত কোডটি যোগ করুন। আপনার API কী দিয়ে YOUR_API_KEY প্রতিস্থাপন করুন। এই ফাইলে আপনার কী সংরক্ষণ করুন কারণ secrets.properties একটি সংস্করণ নিয়ন্ত্রণ সিস্টেমে চেক করা থেকে বাদ দেওয়া হয়েছে৷
    PLACES_API_KEY=YOUR_API_KEY
  6. ফাইলটি সংরক্ষণ করুন।
  7. আপনার শীর্ষ-স্তরের ডিরেক্টরিতে local.defaults.properties ফাইল তৈরি করুন, secrets.properties ফাইলের মতো একই ফোল্ডার, এবং তারপরে নিম্নলিখিত কোডটি যোগ করুন।

    PLACES_API_KEY=DEFAULT_API_KEY

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

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

    secrets.propertiespropertiesFileName সেট করতে প্লাগইনের বৈশিষ্ট্যগুলি সম্পাদনা করুন, defaultPropertiesFileName to 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"
    
        // Configure which keys should be ignored by the plugin by providing regular expressions.
        // "sdk.dir" is ignored by default.
        ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore"
        ignoreList.add("sdk.*")       // Ignore all keys matching the regexp "sdk.*"
    }
            

    গ্রোভি

    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"
    
        // Configure which keys should be ignored by the plugin by providing regular expressions.
        // "sdk.dir" is ignored by default.
        ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore"
        ignoreList.add("sdk.*")       // Ignore all keys matching the regexp "sdk.*"
    }
            

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

একটি কার্যকলাপ বা খণ্ডের মধ্যে Android এর জন্য স্থান SDK সূচনা করুন৷ আপনাকে প্রথমে SDK-এর কোন সংস্করণটি ব্যবহার করতে হবে তা নির্ধারণ করতে হবে: Android এর জন্য স্থান SDK বা Android এর জন্য স্থান SDK (নতুন)৷ পণ্য সংস্করণ সম্পর্কে আরও তথ্যের জন্য, আপনার SDK সংস্করণ চয়ন করুন দেখুন।

নিম্নলিখিত উদাহরণ দেখায় কিভাবে উভয় সংস্করণের জন্য SDK শুরু করতে হয়।

Android এর জন্য 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);
    

Android এর জন্য SDK রাখে

Places.initialize() কল করার সময় 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.initialize(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.initialize(getApplicationContext(), apiKey);

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

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

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

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

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

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

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