Android Quickstart-এর জন্য মানচিত্র SDK

Android স্টুডিওর জন্য Google Maps Views টেমপ্লেট ব্যবহার করে একটি Android অ্যাপ তৈরি করুন যা একটি মানচিত্র প্রদর্শন করে। আপনার যদি একটি বিদ্যমান অ্যান্ড্রয়েড স্টুডিও প্রজেক্ট থাকে যা আপনি সেট আপ করতে চান, তাহলে একটি অ্যান্ড্রয়েড স্টুডিও প্রজেক্ট সেট আপ করুন দেখুন।

এই কুইকস্টার্টটি সেই ডেভেলপারদের জন্য যারা কোটলিন বা জাভা দিয়ে বেসিক অ্যান্ড্রয়েড ডেভেলপমেন্টের সাথে পরিচিত।

উন্নয়নের পরিবেশ সম্পর্কে

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

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

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

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

অ্যান্ড্রয়েড স্টুডিওতে একটি Google মানচিত্র প্রকল্প তৈরি করুন

অ্যান্ড্রয়েড স্টুডিওতে একটি গুগল ম্যাপ প্রকল্প তৈরি করার পদ্ধতিটি ফ্ল্যামিঙ্গো এবং পরে অ্যান্ড্রয়েড স্টুডিওর রিলিজে পরিবর্তন করা হয়েছিল।

  1. অ্যান্ড্রয়েড স্টুডিও খুলুন, এবং অ্যান্ড্রয়েড স্টুডিও উইন্ডোতে স্বাগতম নতুন প্রকল্পে ক্লিক করুন।

  2. নতুন প্রজেক্ট উইন্ডোতে, ফোন এবং ট্যাবলেট বিভাগের অধীনে, কোন কার্যকলাপ নির্বাচন করুন এবং তারপরে পরবর্তী ক্লিক করুন।

  3. নতুন প্রকল্প ফর্মটি পূরণ করুন:

    • জাভা বা কোটলিনে ভাষা সেট করুন। উভয় ভাষাই Android এর জন্য Maps SDK দ্বারা সম্পূর্ণরূপে সমর্থিত৷ কোটলিন সম্পর্কে আরও জানতে, কোটলিনের সাথে অ্যান্ড্রয়েড অ্যাপস ডেভেলপ করুন দেখুন।

    • আপনার টেস্ট ডিভাইসের সাথে সামঞ্জস্যপূর্ণ একটি SDK সংস্করণে ন্যূনতম SDK সেট করুন৷ আপনাকে অবশ্যই Android সংস্করণ 19.0.x এর জন্য Maps SDK-এর জন্য প্রয়োজনীয় ন্যূনতম সংস্করণের চেয়ে বড় সংস্করণ নির্বাচন করতে হবে, যা Android API স্তর 21 ("ললিপপ"; Android 5.0) বা উচ্চতর। SDK সংস্করণের প্রয়োজনীয়তার সর্বশেষ তথ্যের জন্য রিলিজ নোটগুলি দেখুন৷

    • কোটলিন ডিএসএল বা গ্রোভি ডিএসএল-এ বিল্ড কনফিগারেশন ভাষা সেট করুন। উভয় বিল্ড কনফিগারেশন ভাষার স্নিপেট নিম্নলিখিত পদ্ধতিতে দেখানো হয়েছে।

  4. শেষ ক্লিক করুন.

    অ্যান্ড্রয়েড স্টুডিও গ্রেডল শুরু করে এবং প্রকল্প তৈরি করে। এতে কিছুটা সময় লাগতে পারে।

  5. Google Maps Views কার্যকলাপ যোগ করুন:

    1. আপনার প্রজেক্টের app ফোল্ডারে রাইট-ক্লিক করুন।
    2. নতুন > Google > Google Maps Views কার্যকলাপ নির্বাচন করুন।

      একটি মানচিত্র কার্যকলাপ যোগ করুন.

    3. নতুন অ্যান্ড্রয়েড অ্যাক্টিভিটি ডায়ালগ বক্সে, লঞ্চার অ্যাক্টিভিটি চেকবক্স নির্বাচন করুন।

    4. সমাপ্তি নির্বাচন করুন।

      আরও তথ্যের জন্য, একটি টেমপ্লেট থেকে কোড যোগ করুন দেখুন

  6. নির্মাণ শেষ হলে, Android স্টুডিও AndroidManifest.xml এবং MapsActivity ফাইল খোলে। আপনার কার্যকলাপের একটি ভিন্ন নাম থাকতে পারে, কিন্তু এটি সেটআপের সময় আপনি কনফিগার করেছেন।

আপনার Google ক্লাউড প্রকল্প সেট আপ করুন

নিম্নলিখিত ট্যাবগুলিতে ক্লিক করে প্রয়োজনীয় ক্লাউড কনসোল সেটআপ পদক্ষেপগুলি সম্পূর্ণ করুন:

ধাপ 1

কনসোল

  1. Google ক্লাউড কনসোলে, প্রকল্প নির্বাচক পৃষ্ঠায়, একটি নতুন ক্লাউড প্রকল্প তৈরি করা শুরু করতে প্রকল্প তৈরি করুন ক্লিক করুন৷

    প্রকল্প নির্বাচক পৃষ্ঠায় যান

  2. নিশ্চিত করুন যে আপনার ক্লাউড প্রকল্পের জন্য বিলিং সক্ষম করা আছে৷ আপনার প্রকল্পের জন্য বিলিং সক্ষম হয়েছে তা নিশ্চিত করুন

    Google ক্লাউড একটি $0.00 চার্জ ট্রায়াল অফার করে৷ ট্রায়ালের মেয়াদ 90 দিনের শেষে বা অ্যাকাউন্ট $300 মূল্যের চার্জ জমা হওয়ার পরে, যেটি প্রথমে আসে। যেকোনো সময় বাতিল করুন। Google মানচিত্র প্ল্যাটফর্মে একটি পুনরাবৃত্ত $200 মাসিক ক্রেডিট রয়েছে৷ আরও তথ্যের জন্য, বিলিং অ্যাকাউন্ট ক্রেডিট এবং বিলিং দেখুন।

ক্লাউড SDK

gcloud projects create "PROJECT"

Google Cloud SDK , Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলি সম্পর্কে আরও পড়ুন:

ধাপ 2

Google মানচিত্র প্ল্যাটফর্ম ব্যবহার করার জন্য, আপনি আপনার প্রকল্পের সাথে ব্যবহার করার পরিকল্পনা করছেন এমন API বা SDK সক্ষম করতে হবে৷

কনসোল

Android এর জন্য মানচিত্র SDK সক্ষম করুন৷

ক্লাউড SDK

gcloud services enable \
    --project "PROJECT" \
    "maps-android-backend.googleapis.com"

Google Cloud SDK , Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলি সম্পর্কে আরও পড়ুন:

ধাপ 3

এই ধাপটি শুধুমাত্র API কী তৈরির প্রক্রিয়ার মধ্য দিয়ে যায়। আপনি যদি উত্পাদনে আপনার API কী ব্যবহার করেন, আমরা দৃঢ়ভাবে সুপারিশ করি যে আপনি আপনার API কী সীমাবদ্ধ করুন৷ আপনি API কী ব্যবহার করে পণ্য-নির্দিষ্ট পৃষ্ঠায় আরও তথ্য পেতে পারেন।

API কী একটি অনন্য শনাক্তকারী যা ব্যবহার এবং বিলিং উদ্দেশ্যে আপনার প্রকল্পের সাথে যুক্ত অনুরোধগুলিকে প্রমাণীকরণ করে৷ আপনার প্রোজেক্টের সাথে যুক্ত অন্তত একটি API কী থাকতে হবে।

একটি API কী তৈরি করতে:

কনসোল

  1. Google মানচিত্র প্ল্যাটফর্ম > শংসাপত্র পৃষ্ঠাতে যান।

    শংসাপত্র পৃষ্ঠায় যান

  2. শংসাপত্র পৃষ্ঠায়, শংসাপত্র তৈরি করুন > API কী ক্লিক করুন।
    API কী তৈরি ডায়ালগ আপনার নতুন তৈরি API কী প্রদর্শন করে।
  3. Close এ ক্লিক করুন।
    নতুন API কী API কী-এর অধীনে শংসাপত্র পৃষ্ঠায় তালিকাভুক্ত করা হয়েছে।
    (এটি উত্পাদনে ব্যবহার করার আগে API কী সীমাবদ্ধ করতে মনে রাখবেন।)

ক্লাউড SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Google Cloud SDK , Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলি সম্পর্কে আরও পড়ুন:

আপনার অ্যাপে 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 একটি সংস্করণ নিয়ন্ত্রণ সিস্টেমে চেক করা থেকে বাদ দেওয়া হয়েছে৷
    MAPS_API_KEY=YOUR_API_KEY
  6. ফাইলটি সংরক্ষণ করুন।
  7. আপনার শীর্ষ-স্তরের ডিরেক্টরিতে local.defaults.properties ফাইল তৈরি করুন, secrets.properties ফাইলের মতো একই ফোল্ডার, এবং তারপরে নিম্নলিখিত কোডটি যোগ করুন।

    MAPS_API_KEY=DEFAULT_API_KEY

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

  8. ফাইলটি সংরক্ষণ করুন।
  9. আপনার AndroidManifest.xml ফাইলে, com.google.android.geo.API_KEY এ যান এবং android:value attribute আপডেট করুন। যদি <meta-data> ট্যাগটি বিদ্যমান না থাকে, তাহলে এটিকে <application> ট্যাগের একটি চাইল্ড হিসেবে তৈরি করুন।
    <meta-data
        android:name="com.google.android.geo.API_KEY"
        android:value="${MAPS_API_KEY}" />

    Note: com.google.android.geo.API_KEY is the recommended metadata name for the API key. A key with this name can be used to authenticate to multiple Google Maps-based APIs on the Android platform, including the Maps SDK for Android. For backwards compatibility, the API also supports the name com.google.android.maps.v2.API_KEY. This legacy name allows authentication to the Android Maps API v2 only. An application can specify only one of the API key metadata names. If both are specified, the API throws an exception.

  10. In Android Studio, open your module-level build.gradle.kts or build.gradle file and edit the secrets property. If the secrets property does not exist, add it.

    Edit the properties of the plugin to set propertiesFileName to secrets.properties, set defaultPropertiesFileName to local.defaults.properties, and set any other 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 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.*"
    }
            

কোডটি দেখুন

টেমপ্লেট দ্বারা সরবরাহ করা কোড পরীক্ষা করুন. বিশেষ করে, আপনার অ্যান্ড্রয়েড স্টুডিও প্রকল্পের নিম্নলিখিত ফাইলগুলি দেখুন।

মানচিত্র কার্যকলাপ ফাইল

ম্যাপ অ্যাক্টিভিটি ফাইলটি অ্যাপের প্রধান অ্যাক্টিভিটি , এবং এতে ম্যাপ পরিচালনা ও প্রদর্শনের কোড থাকে। ডিফল্টরূপে, যে ফাইলটি কার্যকলাপ সংজ্ঞায়িত করে সেটির নাম MapsActivity.java বা আপনি যদি Kotlin কে আপনার অ্যাপের ভাষা হিসেবে সেট করেন, MapsActivity.kt

মানচিত্র কার্যকলাপের প্রধান উপাদান:

  • SupportMapFragment অবজেক্ট মানচিত্রের জীবনচক্র পরিচালনা করে এবং অ্যাপের UI এর মূল উপাদান।

  • GoogleMap অবজেক্ট ম্যাপ ডেটা এবং ভিউতে অ্যাক্সেস প্রদান করে। এটি Android এর জন্য Maps SDK-এর প্রধান ক্লাস। ম্যাপ অবজেক্ট গাইড আরও বিস্তারিতভাবে SupportMapFragment এবং GoogleMap অবজেক্টের বর্ণনা করে।

  • moveCamera ফাংশনটি সিডনি অস্ট্রেলিয়ার LatLng স্থানাঙ্কে মানচিত্রকে কেন্দ্র করে। একটি মানচিত্র যোগ করার সময় কনফিগার করার প্রথম সেটিংস সাধারণত মানচিত্রের অবস্থান এবং ক্যামেরা সেটিংস হয়; যেমন দেখার কোণ, মানচিত্র অভিযোজন, এবং জুম স্তর। বিস্তারিত জানার জন্য ক্যামেরা এবং ভিউ নির্দেশিকা দেখুন।

  • addMarker ফাংশন সিডনির জন্য স্থানাঙ্কে একটি মার্কার যোগ করে। বিস্তারিত জানার জন্য মার্কার গাইড দেখুন।

মডিউল গ্রেডল ফাইল

মডিউল build.gradle.kts ফাইলে নিম্নলিখিত মানচিত্র নির্ভরতা রয়েছে, যা Android এর জন্য Maps SDK-এর জন্য প্রয়োজনীয়।

dependencies {

    // Maps SDK for Android
    implementation("com.google.android.gms:play-services-maps:19.0.0")
}

মানচিত্র নির্ভরতা পরিচালনা সম্পর্কে আরও জানতে, সংস্করণ দেখুন।

XML লেআউট ফাইল

activity_maps.xml ফাইল হল XML লেআউট ফাইল যা অ্যাপের UI এর গঠন সংজ্ঞায়িত করে। ফাইলটি res/layout ডিরেক্টরিতে অবস্থিত। activity_maps.xml ফাইল একটি খণ্ড ঘোষণা করে যা নিম্নলিখিত উপাদানগুলিকে অন্তর্ভুক্ত করে:

  • tools:context MapsActivity তে খণ্ডটির ডিফল্ট কার্যকলাপ সেট করে, যা মানচিত্র কার্যকলাপ ফাইলে সংজ্ঞায়িত করা হয়।
  • android:name ফ্র্যাগমেন্টের ক্লাসের নাম SupportMapFragment এ সেট করে, যা ম্যাপ অ্যাক্টিভিটি ফাইলে ব্যবহৃত ফ্র্যাগমেন্টের ধরন।

XML লেআউট ফাইলে নিম্নলিখিত কোড রয়েছে:

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:map="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/map"
    android:name="com.google.android.gms.maps.SupportMapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MapsActivity" />

অ্যাপটি স্থাপন করুন এবং চালান

সিন্ডনি অস্ট্রেলিয়া কেন্দ্রিক মানচিত্র এবং মার্কার সহ স্ক্রিনশট।

আপনি যখন অ্যাপটি সফলভাবে চালাবেন, তখন এটি একটি মানচিত্র প্রদর্শন করবে যা সিডনি অস্ট্রেলিয়াকে কেন্দ্র করে শহরের একটি মার্কার সহ নিম্নলিখিত স্ক্রিনশটে দেখা যাবে।

অ্যাপটি স্থাপন এবং চালানোর জন্য:

  1. অ্যান্ড্রয়েড স্টুডিওতে, আপনার অ্যাপ চালানোর জন্য রান মেনু বিকল্পে (বা প্লে বোতাম আইকন) ক্লিক করুন।
  2. একটি ডিভাইস চয়ন করার জন্য অনুরোধ করা হলে, নিম্নলিখিত বিকল্পগুলির মধ্যে একটি চয়ন করুন:
    • আপনার কম্পিউটারের সাথে সংযুক্ত Android ডিভাইসটি নির্বাচন করুন৷
    • বিকল্পভাবে, লঞ্চ এমুলেটর রেডিও বোতামটি নির্বাচন করুন এবং আপনার সেট আপ করা ভার্চুয়াল ডিভাইসটি চয়ন করুন।
  3. ওকে ক্লিক করুন। অ্যান্ড্রয়েড স্টুডিও আপনার অ্যাপ তৈরি করতে Gradle শুরু করবে এবং তারপর আপনার ডিভাইস বা এমুলেটরে ফলাফল প্রদর্শন করবে। অ্যাপটি চালু হতে কয়েক মিনিট সময় লাগতে পারে।

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

,

Android স্টুডিওর জন্য Google Maps Views টেমপ্লেট ব্যবহার করে একটি Android অ্যাপ তৈরি করুন যা একটি মানচিত্র প্রদর্শন করে। আপনার যদি একটি বিদ্যমান অ্যান্ড্রয়েড স্টুডিও প্রজেক্ট থাকে যা আপনি সেট আপ করতে চান, তাহলে একটি অ্যান্ড্রয়েড স্টুডিও প্রজেক্ট সেট আপ করুন দেখুন।

এই কুইকস্টার্টটি সেই ডেভেলপারদের জন্য যারা কোটলিন বা জাভা দিয়ে বেসিক অ্যান্ড্রয়েড ডেভেলপমেন্টের সাথে পরিচিত।

উন্নয়নের পরিবেশ সম্পর্কে

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

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

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

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

অ্যান্ড্রয়েড স্টুডিওতে একটি Google মানচিত্র প্রকল্প তৈরি করুন

অ্যান্ড্রয়েড স্টুডিওতে একটি গুগল ম্যাপ প্রকল্প তৈরি করার পদ্ধতিটি ফ্ল্যামিঙ্গো এবং পরে অ্যান্ড্রয়েড স্টুডিওর রিলিজে পরিবর্তন করা হয়েছিল।

  1. অ্যান্ড্রয়েড স্টুডিও খুলুন, এবং অ্যান্ড্রয়েড স্টুডিও উইন্ডোতে স্বাগতম নতুন প্রকল্পে ক্লিক করুন।

  2. নতুন প্রজেক্ট উইন্ডোতে, ফোন এবং ট্যাবলেট বিভাগের অধীনে, কোন কার্যকলাপ নির্বাচন করুন এবং তারপরে পরবর্তী ক্লিক করুন।

  3. নতুন প্রকল্প ফর্মটি পূরণ করুন:

    • জাভা বা কোটলিনে ভাষা সেট করুন। উভয় ভাষাই Android এর জন্য Maps SDK দ্বারা সম্পূর্ণরূপে সমর্থিত৷ কোটলিন সম্পর্কে আরও জানতে, কোটলিনের সাথে অ্যান্ড্রয়েড অ্যাপস ডেভেলপ করুন দেখুন।

    • আপনার টেস্ট ডিভাইসের সাথে সামঞ্জস্যপূর্ণ একটি SDK সংস্করণে ন্যূনতম SDK সেট করুন৷ আপনাকে অবশ্যই Android সংস্করণ 19.0.x এর জন্য Maps SDK-এর জন্য প্রয়োজনীয় ন্যূনতম সংস্করণের চেয়ে বড় সংস্করণ নির্বাচন করতে হবে, যা Android API স্তর 21 ("ললিপপ"; Android 5.0) বা উচ্চতর। SDK সংস্করণের প্রয়োজনীয়তার সর্বশেষ তথ্যের জন্য রিলিজ নোটগুলি দেখুন৷

    • কোটলিন ডিএসএল বা গ্রোভি ডিএসএল-এ বিল্ড কনফিগারেশন ভাষা সেট করুন। উভয় বিল্ড কনফিগারেশন ভাষার স্নিপেট নিম্নলিখিত পদ্ধতিতে দেখানো হয়েছে।

  4. শেষ ক্লিক করুন.

    অ্যান্ড্রয়েড স্টুডিও গ্রেডল শুরু করে এবং প্রকল্প তৈরি করে। এতে কিছুটা সময় লাগতে পারে।

  5. Google Maps Views কার্যকলাপ যোগ করুন:

    1. আপনার প্রজেক্টের app ফোল্ডারে রাইট-ক্লিক করুন।
    2. নতুন > Google > Google Maps Views কার্যকলাপ নির্বাচন করুন।

      একটি মানচিত্র কার্যকলাপ যোগ করুন.

    3. নতুন অ্যান্ড্রয়েড অ্যাক্টিভিটি ডায়ালগ বক্সে, লঞ্চার অ্যাক্টিভিটি চেকবক্স নির্বাচন করুন।

    4. সমাপ্তি নির্বাচন করুন।

      আরও তথ্যের জন্য, একটি টেমপ্লেট থেকে কোড যোগ করুন দেখুন

  6. নির্মাণ শেষ হলে, Android স্টুডিও AndroidManifest.xml এবং MapsActivity ফাইল খোলে। আপনার কার্যকলাপের একটি ভিন্ন নাম থাকতে পারে, কিন্তু এটি সেটআপের সময় আপনি কনফিগার করেছেন।

আপনার Google ক্লাউড প্রকল্প সেট আপ করুন

নিম্নলিখিত ট্যাবগুলিতে ক্লিক করে প্রয়োজনীয় ক্লাউড কনসোল সেটআপ পদক্ষেপগুলি সম্পূর্ণ করুন:

ধাপ 1

কনসোল

  1. Google ক্লাউড কনসোলে, প্রকল্প নির্বাচক পৃষ্ঠায়, একটি নতুন ক্লাউড প্রকল্প তৈরি করা শুরু করতে প্রকল্প তৈরি করুন ক্লিক করুন৷

    প্রকল্প নির্বাচক পৃষ্ঠায় যান

  2. নিশ্চিত করুন যে আপনার ক্লাউড প্রকল্পের জন্য বিলিং সক্ষম করা আছে৷ আপনার প্রকল্পের জন্য বিলিং সক্ষম হয়েছে তা নিশ্চিত করুন

    Google ক্লাউড একটি $0.00 চার্জ ট্রায়াল অফার করে৷ ট্রায়ালের মেয়াদ 90 দিনের শেষে বা অ্যাকাউন্ট $300 মূল্যের চার্জ জমা হওয়ার পরে, যেটি প্রথমে আসে। যেকোনো সময় বাতিল করুন। Google মানচিত্র প্ল্যাটফর্মে একটি পুনরাবৃত্ত $200 মাসিক ক্রেডিট রয়েছে৷ আরও তথ্যের জন্য, বিলিং অ্যাকাউন্ট ক্রেডিট এবং বিলিং দেখুন।

ক্লাউড SDK

gcloud projects create "PROJECT"

Google Cloud SDK , Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলি সম্পর্কে আরও পড়ুন:

ধাপ 2

Google মানচিত্র প্ল্যাটফর্ম ব্যবহার করার জন্য, আপনি আপনার প্রকল্পের সাথে ব্যবহার করার পরিকল্পনা করছেন এমন API বা SDK সক্ষম করতে হবে৷

কনসোল

Android এর জন্য মানচিত্র SDK সক্ষম করুন৷

ক্লাউড SDK

gcloud services enable \
    --project "PROJECT" \
    "maps-android-backend.googleapis.com"

Google Cloud SDK , Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলি সম্পর্কে আরও পড়ুন:

ধাপ 3

এই ধাপটি শুধুমাত্র API কী তৈরির প্রক্রিয়ার মধ্য দিয়ে যায়। আপনি যদি উত্পাদনে আপনার API কী ব্যবহার করেন, আমরা দৃঢ়ভাবে সুপারিশ করি যে আপনি আপনার API কী সীমাবদ্ধ করুন৷ আপনি API কী ব্যবহার করে পণ্য-নির্দিষ্ট পৃষ্ঠায় আরও তথ্য পেতে পারেন।

API কী একটি অনন্য শনাক্তকারী যা ব্যবহার এবং বিলিং উদ্দেশ্যে আপনার প্রকল্পের সাথে যুক্ত অনুরোধগুলিকে প্রমাণীকরণ করে৷ আপনার প্রোজেক্টের সাথে যুক্ত অন্তত একটি API কী থাকতে হবে।

একটি API কী তৈরি করতে:

কনসোল

  1. Google মানচিত্র প্ল্যাটফর্ম > শংসাপত্র পৃষ্ঠাতে যান।

    শংসাপত্র পৃষ্ঠায় যান

  2. শংসাপত্র পৃষ্ঠায়, শংসাপত্র তৈরি করুন > API কী ক্লিক করুন।
    API কী তৈরি ডায়ালগ আপনার নতুন তৈরি API কী প্রদর্শন করে।
  3. Close এ ক্লিক করুন।
    নতুন API কী API কী-এর অধীনে শংসাপত্র পৃষ্ঠায় তালিকাভুক্ত করা হয়েছে।
    (এটি উত্পাদনে ব্যবহার করার আগে API কী সীমাবদ্ধ করতে মনে রাখবেন।)

ক্লাউড SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Google Cloud SDK , Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলি সম্পর্কে আরও পড়ুন:

আপনার অ্যাপে 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 একটি সংস্করণ নিয়ন্ত্রণ সিস্টেমে চেক করা থেকে বাদ দেওয়া হয়েছে৷
    MAPS_API_KEY=YOUR_API_KEY
  6. ফাইলটি সংরক্ষণ করুন।
  7. আপনার শীর্ষ-স্তরের ডিরেক্টরিতে local.defaults.properties ফাইল তৈরি করুন, secrets.properties ফাইলের মতো একই ফোল্ডার, এবং তারপরে নিম্নলিখিত কোডটি যোগ করুন।

    MAPS_API_KEY=DEFAULT_API_KEY

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

  8. ফাইলটি সংরক্ষণ করুন।
  9. আপনার AndroidManifest.xml ফাইলে, com.google.android.geo.API_KEY এ যান এবং android:value attribute আপডেট করুন। যদি <meta-data> ট্যাগটি বিদ্যমান না থাকে, তাহলে এটিকে <application> ট্যাগের একটি চাইল্ড হিসেবে তৈরি করুন।
    <meta-data
        android:name="com.google.android.geo.API_KEY"
        android:value="${MAPS_API_KEY}" />

    Note: com.google.android.geo.API_KEY is the recommended metadata name for the API key. A key with this name can be used to authenticate to multiple Google Maps-based APIs on the Android platform, including the Maps SDK for Android. For backwards compatibility, the API also supports the name com.google.android.maps.v2.API_KEY. This legacy name allows authentication to the Android Maps API v2 only. An application can specify only one of the API key metadata names. If both are specified, the API throws an exception.

  10. In Android Studio, open your module-level build.gradle.kts or build.gradle file and edit the secrets property. If the secrets property does not exist, add it.

    Edit the properties of the plugin to set propertiesFileName to secrets.properties, set defaultPropertiesFileName to local.defaults.properties, and set any other 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 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.*"
    }
            

কোডটি দেখুন

টেমপ্লেট দ্বারা সরবরাহ করা কোড পরীক্ষা করুন. বিশেষ করে, আপনার অ্যান্ড্রয়েড স্টুডিও প্রকল্পের নিম্নলিখিত ফাইলগুলি দেখুন।

মানচিত্র কার্যকলাপ ফাইল

ম্যাপ অ্যাক্টিভিটি ফাইলটি অ্যাপের প্রধান অ্যাক্টিভিটি , এবং এতে ম্যাপ পরিচালনা ও প্রদর্শনের কোড থাকে। ডিফল্টরূপে, যে ফাইলটি কার্যকলাপ সংজ্ঞায়িত করে সেটির নাম MapsActivity.java বা আপনি যদি Kotlin কে আপনার অ্যাপের ভাষা হিসেবে সেট করেন, MapsActivity.kt

মানচিত্র কার্যকলাপের প্রধান উপাদান:

  • SupportMapFragment অবজেক্ট মানচিত্রের জীবনচক্র পরিচালনা করে এবং অ্যাপের UI এর মূল উপাদান।

  • GoogleMap অবজেক্ট ম্যাপ ডেটা এবং ভিউতে অ্যাক্সেস প্রদান করে। এটি Android এর জন্য Maps SDK-এর প্রধান ক্লাস। ম্যাপ অবজেক্ট গাইড আরও বিস্তারিতভাবে SupportMapFragment এবং GoogleMap অবজেক্টের বর্ণনা করে।

  • moveCamera ফাংশনটি সিডনি অস্ট্রেলিয়ার LatLng স্থানাঙ্কে মানচিত্রকে কেন্দ্র করে। একটি মানচিত্র যোগ করার সময় কনফিগার করার প্রথম সেটিংস সাধারণত মানচিত্রের অবস্থান এবং ক্যামেরা সেটিংস হয়; যেমন দেখার কোণ, মানচিত্র অভিযোজন, এবং জুম স্তর। বিস্তারিত জানার জন্য ক্যামেরা এবং ভিউ নির্দেশিকা দেখুন।

  • addMarker ফাংশন সিডনির জন্য স্থানাঙ্কে একটি মার্কার যোগ করে। বিস্তারিত জানার জন্য মার্কার গাইড দেখুন।

মডিউল গ্রেডল ফাইল

মডিউল build.gradle.kts ফাইলে নিম্নলিখিত মানচিত্র নির্ভরতা রয়েছে, যা Android এর জন্য Maps SDK-এর জন্য প্রয়োজনীয়।

dependencies {

    // Maps SDK for Android
    implementation("com.google.android.gms:play-services-maps:19.0.0")
}

মানচিত্র নির্ভরতা পরিচালনা সম্পর্কে আরও জানতে, সংস্করণ দেখুন।

XML লেআউট ফাইল

activity_maps.xml ফাইল হল XML লেআউট ফাইল যা অ্যাপের UI এর গঠন সংজ্ঞায়িত করে। ফাইলটি res/layout ডিরেক্টরিতে অবস্থিত। activity_maps.xml ফাইল একটি খণ্ড ঘোষণা করে যা নিম্নলিখিত উপাদানগুলিকে অন্তর্ভুক্ত করে:

  • tools:context MapsActivity তে খণ্ডটির ডিফল্ট কার্যকলাপ সেট করে, যা মানচিত্র কার্যকলাপ ফাইলে সংজ্ঞায়িত করা হয়।
  • android:name ফ্র্যাগমেন্টের ক্লাসের নাম SupportMapFragment এ সেট করে, যা ম্যাপ অ্যাক্টিভিটি ফাইলে ব্যবহৃত ফ্র্যাগমেন্টের ধরন।

XML লেআউট ফাইলে নিম্নলিখিত কোড রয়েছে:

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:map="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/map"
    android:name="com.google.android.gms.maps.SupportMapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MapsActivity" />

অ্যাপটি স্থাপন করুন এবং চালান

সিন্ডনি অস্ট্রেলিয়া কেন্দ্রিক মানচিত্র এবং মার্কার সহ স্ক্রিনশট।

আপনি যখন অ্যাপটি সফলভাবে চালাবেন, তখন এটি একটি মানচিত্র প্রদর্শন করবে যা সিডনি অস্ট্রেলিয়াকে কেন্দ্র করে শহরের একটি মার্কার সহ নিম্নলিখিত স্ক্রিনশটে দেখা যাবে।

অ্যাপটি স্থাপন এবং চালানোর জন্য:

  1. অ্যান্ড্রয়েড স্টুডিওতে, আপনার অ্যাপ চালানোর জন্য রান মেনু বিকল্পে (বা প্লে বোতাম আইকন) ক্লিক করুন।
  2. একটি ডিভাইস চয়ন করার জন্য অনুরোধ করা হলে, নিম্নলিখিত বিকল্পগুলির মধ্যে একটি চয়ন করুন:
    • আপনার কম্পিউটারের সাথে সংযুক্ত Android ডিভাইসটি নির্বাচন করুন৷
    • বিকল্পভাবে, লঞ্চ এমুলেটর রেডিও বোতামটি নির্বাচন করুন এবং আপনার সেট আপ করা ভার্চুয়াল ডিভাইসটি চয়ন করুন।
  3. ওকে ক্লিক করুন। অ্যান্ড্রয়েড স্টুডিও আপনার অ্যাপ তৈরি করতে Gradle শুরু করবে এবং তারপর আপনার ডিভাইস বা এমুলেটরে ফলাফল প্রদর্শন করবে। অ্যাপটি চালু হতে কয়েক মিনিট সময় লাগতে পারে।

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

,

Android স্টুডিওর জন্য Google Maps Views টেমপ্লেট ব্যবহার করে একটি Android অ্যাপ তৈরি করুন যা একটি মানচিত্র প্রদর্শন করে। আপনার যদি একটি বিদ্যমান অ্যান্ড্রয়েড স্টুডিও প্রজেক্ট থাকে যা আপনি সেট আপ করতে চান, তাহলে একটি অ্যান্ড্রয়েড স্টুডিও প্রজেক্ট সেট আপ করুন দেখুন।

এই কুইকস্টার্টটি সেই ডেভেলপারদের জন্য যারা কোটলিন বা জাভা দিয়ে বেসিক অ্যান্ড্রয়েড ডেভেলপমেন্টের সাথে পরিচিত।

উন্নয়নের পরিবেশ সম্পর্কে

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

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

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

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

অ্যান্ড্রয়েড স্টুডিওতে একটি Google মানচিত্র প্রকল্প তৈরি করুন

অ্যান্ড্রয়েড স্টুডিওতে একটি গুগল ম্যাপ প্রকল্প তৈরি করার পদ্ধতিটি ফ্ল্যামিঙ্গো এবং পরে অ্যান্ড্রয়েড স্টুডিওর রিলিজে পরিবর্তন করা হয়েছিল।

  1. অ্যান্ড্রয়েড স্টুডিও খুলুন, এবং অ্যান্ড্রয়েড স্টুডিও উইন্ডোতে স্বাগতম নতুন প্রকল্পে ক্লিক করুন।

  2. নতুন প্রজেক্ট উইন্ডোতে, ফোন এবং ট্যাবলেট বিভাগের অধীনে, কোন কার্যকলাপ নির্বাচন করুন এবং তারপরে পরবর্তী ক্লিক করুন।

  3. নতুন প্রকল্প ফর্মটি পূরণ করুন:

    • জাভা বা কোটলিনে ভাষা সেট করুন। উভয় ভাষাই Android এর জন্য Maps SDK দ্বারা সম্পূর্ণরূপে সমর্থিত৷ কোটলিন সম্পর্কে আরও জানতে, কোটলিনের সাথে অ্যান্ড্রয়েড অ্যাপস ডেভেলপ করুন দেখুন।

    • আপনার টেস্ট ডিভাইসের সাথে সামঞ্জস্যপূর্ণ একটি SDK সংস্করণে ন্যূনতম SDK সেট করুন৷ আপনাকে অবশ্যই Android সংস্করণ 19.0.x এর জন্য Maps SDK-এর জন্য প্রয়োজনীয় ন্যূনতম সংস্করণের চেয়ে বড় সংস্করণ নির্বাচন করতে হবে, যা Android API স্তর 21 ("ললিপপ"; Android 5.0) বা উচ্চতর। SDK সংস্করণের প্রয়োজনীয়তার সর্বশেষ তথ্যের জন্য রিলিজ নোটগুলি দেখুন৷

    • কোটলিন ডিএসএল বা গ্রোভি ডিএসএল-এ বিল্ড কনফিগারেশন ভাষা সেট করুন। উভয় বিল্ড কনফিগারেশন ভাষার স্নিপেট নিম্নলিখিত পদ্ধতিতে দেখানো হয়েছে।

  4. শেষ ক্লিক করুন.

    অ্যান্ড্রয়েড স্টুডিও গ্রেডল শুরু করে এবং প্রকল্প তৈরি করে। এতে কিছুটা সময় লাগতে পারে।

  5. Google Maps Views কার্যকলাপ যোগ করুন:

    1. আপনার প্রজেক্টের app ফোল্ডারে রাইট-ক্লিক করুন।
    2. নতুন > Google > Google Maps Views কার্যকলাপ নির্বাচন করুন।

      একটি মানচিত্র কার্যকলাপ যোগ করুন.

    3. নতুন অ্যান্ড্রয়েড অ্যাক্টিভিটি ডায়ালগ বক্সে, লঞ্চার অ্যাক্টিভিটি চেকবক্স নির্বাচন করুন।

    4. সমাপ্তি নির্বাচন করুন।

      আরও তথ্যের জন্য, একটি টেমপ্লেট থেকে কোড যোগ করুন দেখুন

  6. নির্মাণ শেষ হলে, Android স্টুডিও AndroidManifest.xml এবং MapsActivity ফাইল খোলে। আপনার কার্যকলাপের একটি ভিন্ন নাম থাকতে পারে, কিন্তু এটি সেটআপের সময় আপনি কনফিগার করেছেন।

আপনার Google ক্লাউড প্রকল্প সেট আপ করুন

নিম্নলিখিত ট্যাবগুলিতে ক্লিক করে প্রয়োজনীয় ক্লাউড কনসোল সেটআপ পদক্ষেপগুলি সম্পূর্ণ করুন:

ধাপ 1

কনসোল

  1. Google ক্লাউড কনসোলে, প্রকল্প নির্বাচক পৃষ্ঠায়, একটি নতুন ক্লাউড প্রকল্প তৈরি করা শুরু করতে প্রকল্প তৈরি করুন ক্লিক করুন৷

    প্রকল্প নির্বাচক পৃষ্ঠায় যান

  2. নিশ্চিত করুন যে আপনার ক্লাউড প্রকল্পের জন্য বিলিং সক্ষম করা আছে৷ আপনার প্রকল্পের জন্য বিলিং সক্ষম হয়েছে তা নিশ্চিত করুন

    Google ক্লাউড একটি $0.00 চার্জ ট্রায়াল অফার করে৷ ট্রায়ালের মেয়াদ 90 দিনের শেষে বা অ্যাকাউন্ট $300 মূল্যের চার্জ জমা হওয়ার পরে, যেটি প্রথমে আসে। যেকোনো সময় বাতিল করুন। Google মানচিত্র প্ল্যাটফর্মে একটি পুনরাবৃত্ত $200 মাসিক ক্রেডিট রয়েছে৷ আরও তথ্যের জন্য, বিলিং অ্যাকাউন্ট ক্রেডিট এবং বিলিং দেখুন।

ক্লাউড SDK

gcloud projects create "PROJECT"

Google Cloud SDK , Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলি সম্পর্কে আরও পড়ুন:

ধাপ 2

Google মানচিত্র প্ল্যাটফর্ম ব্যবহার করার জন্য, আপনি আপনার প্রকল্পের সাথে ব্যবহার করার পরিকল্পনা করছেন এমন API বা SDK সক্ষম করতে হবে৷

কনসোল

Android এর জন্য মানচিত্র SDK সক্ষম করুন৷

ক্লাউড SDK

gcloud services enable \
    --project "PROJECT" \
    "maps-android-backend.googleapis.com"

Google Cloud SDK , Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলি সম্পর্কে আরও পড়ুন:

ধাপ 3

এই ধাপটি শুধুমাত্র API কী তৈরির প্রক্রিয়ার মধ্য দিয়ে যায়। আপনি যদি উত্পাদনে আপনার API কী ব্যবহার করেন, আমরা দৃঢ়ভাবে সুপারিশ করি যে আপনি আপনার API কী সীমাবদ্ধ করুন৷ আপনি API কী ব্যবহার করে পণ্য-নির্দিষ্ট পৃষ্ঠায় আরও তথ্য পেতে পারেন।

API কী একটি অনন্য শনাক্তকারী যা ব্যবহার এবং বিলিং উদ্দেশ্যে আপনার প্রকল্পের সাথে যুক্ত অনুরোধগুলিকে প্রমাণীকরণ করে৷ আপনার প্রোজেক্টের সাথে যুক্ত অন্তত একটি API কী থাকতে হবে।

একটি API কী তৈরি করতে:

কনসোল

  1. Google মানচিত্র প্ল্যাটফর্ম > শংসাপত্র পৃষ্ঠাতে যান।

    শংসাপত্র পৃষ্ঠায় যান

  2. শংসাপত্র পৃষ্ঠায়, শংসাপত্র তৈরি করুন > API কী ক্লিক করুন।
    API কী তৈরি ডায়ালগ আপনার নতুন তৈরি API কী প্রদর্শন করে।
  3. Close এ ক্লিক করুন।
    নতুন API কী API কী-এর অধীনে শংসাপত্র পৃষ্ঠায় তালিকাভুক্ত করা হয়েছে।
    (এটি উত্পাদনে ব্যবহার করার আগে API কী সীমাবদ্ধ করতে মনে রাখবেন।)

ক্লাউড SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Google Cloud SDK , Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলি সম্পর্কে আরও পড়ুন:

আপনার অ্যাপে 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 একটি সংস্করণ নিয়ন্ত্রণ সিস্টেমে চেক করা থেকে বাদ দেওয়া হয়েছে৷
    MAPS_API_KEY=YOUR_API_KEY
  6. ফাইলটি সংরক্ষণ করুন।
  7. আপনার শীর্ষ-স্তরের ডিরেক্টরিতে local.defaults.properties ফাইল তৈরি করুন, secrets.properties ফাইলের মতো একই ফোল্ডার, এবং তারপরে নিম্নলিখিত কোডটি যোগ করুন।

    MAPS_API_KEY=DEFAULT_API_KEY

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

  8. ফাইলটি সংরক্ষণ করুন।
  9. আপনার AndroidManifest.xml ফাইলে, com.google.android.geo.API_KEY এ যান এবং android:value attribute আপডেট করুন। যদি <meta-data> ট্যাগটি বিদ্যমান না থাকে, তাহলে এটিকে <application> ট্যাগের একটি চাইল্ড হিসেবে তৈরি করুন।
    <meta-data
        android:name="com.google.android.geo.API_KEY"
        android:value="${MAPS_API_KEY}" />

    Note: com.google.android.geo.API_KEY is the recommended metadata name for the API key. A key with this name can be used to authenticate to multiple Google Maps-based APIs on the Android platform, including the Maps SDK for Android. For backwards compatibility, the API also supports the name com.google.android.maps.v2.API_KEY. This legacy name allows authentication to the Android Maps API v2 only. An application can specify only one of the API key metadata names. If both are specified, the API throws an exception.

  10. In Android Studio, open your module-level build.gradle.kts or build.gradle file and edit the secrets property. If the secrets property does not exist, add it.

    Edit the properties of the plugin to set propertiesFileName to secrets.properties, set defaultPropertiesFileName to local.defaults.properties, and set any other 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 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.*"
    }
            

কোডটি দেখুন

টেমপ্লেট দ্বারা সরবরাহ করা কোড পরীক্ষা করুন. বিশেষ করে, আপনার অ্যান্ড্রয়েড স্টুডিও প্রকল্পের নিম্নলিখিত ফাইলগুলি দেখুন।

মানচিত্র কার্যকলাপ ফাইল

ম্যাপ অ্যাক্টিভিটি ফাইলটি অ্যাপের প্রধান অ্যাক্টিভিটি , এবং এতে ম্যাপ পরিচালনা ও প্রদর্শনের কোড থাকে। ডিফল্টরূপে, যে ফাইলটি কার্যকলাপ সংজ্ঞায়িত করে সেটির নাম MapsActivity.java বা আপনি যদি Kotlin কে আপনার অ্যাপের ভাষা হিসেবে সেট করেন, MapsActivity.kt

মানচিত্র কার্যকলাপের প্রধান উপাদান:

  • SupportMapFragment অবজেক্ট মানচিত্রের জীবনচক্র পরিচালনা করে এবং অ্যাপের UI এর মূল উপাদান।

  • GoogleMap অবজেক্ট ম্যাপ ডেটা এবং ভিউতে অ্যাক্সেস প্রদান করে। এটি Android এর জন্য Maps SDK-এর প্রধান ক্লাস। ম্যাপ অবজেক্ট গাইড আরও বিস্তারিতভাবে SupportMapFragment এবং GoogleMap অবজেক্টের বর্ণনা করে।

  • moveCamera ফাংশনটি সিডনি অস্ট্রেলিয়ার LatLng স্থানাঙ্কে মানচিত্রকে কেন্দ্র করে। একটি মানচিত্র যোগ করার সময় কনফিগার করার প্রথম সেটিংস সাধারণত মানচিত্রের অবস্থান এবং ক্যামেরা সেটিংস হয়; যেমন দেখার কোণ, মানচিত্র অভিযোজন, এবং জুম স্তর। বিস্তারিত জানার জন্য ক্যামেরা এবং ভিউ নির্দেশিকা দেখুন।

  • addMarker ফাংশন সিডনির জন্য স্থানাঙ্কে একটি মার্কার যোগ করে। বিস্তারিত জানার জন্য মার্কার গাইড দেখুন।

মডিউল গ্রেডল ফাইল

মডিউল build.gradle.kts ফাইলটিতে নিম্নলিখিত মানচিত্রের নির্ভরতা অন্তর্ভুক্ত রয়েছে, যা অ্যান্ড্রয়েডের জন্য মানচিত্র এসডিকে দ্বারা প্রয়োজনীয়।

dependencies {

    // Maps SDK for Android
    implementation("com.google.android.gms:play-services-maps:19.0.0")
}

মানচিত্রের নির্ভরতা পরিচালনা সম্পর্কে আরও জানতে, সংস্করণ দেখুন।

এক্সএমএল লেআউট ফাইল

activity_maps.xml ফাইলটি হ'ল এক্সএমএল লেআউট ফাইল যা অ্যাপের ইউআইয়ের কাঠামোকে সংজ্ঞায়িত করে। ফাইলটি res/layout ডিরেক্টরিতে অবস্থিত। activity_maps.xml ফাইলটি একটি খণ্ড ঘোষণা করে যা নিম্নলিখিত উপাদানগুলি অন্তর্ভুক্ত করে:

  • tools:context MapsActivity খণ্ডের ডিফল্ট ক্রিয়াকলাপ সেট করে, যা মানচিত্রের ক্রিয়াকলাপ ফাইলটিতে সংজ্ঞায়িত করা হয়।
  • android:name খণ্ডের শ্রেণীর নামটি SupportMapFragment সেট করে, যা মানচিত্রের ক্রিয়াকলাপ ফাইলটিতে ব্যবহৃত খণ্ডের ধরণ।

এক্সএমএল লেআউট ফাইলটিতে নিম্নলিখিত কোড রয়েছে:

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:map="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/map"
    android:name="com.google.android.gms.maps.SupportMapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MapsActivity" />

অ্যাপটি মোতায়েন করুন এবং চালান

স্ক্রিনশটটি মানচিত্রের সাথে এবং সিন্ডনি অস্ট্রেলিয়াকে কেন্দ্র করে চিহ্নিতকারী।

আপনি যখন অ্যাপ্লিকেশনটি সফলভাবে চালাচ্ছেন, এটি সিডনি অস্ট্রেলিয়ায় কেন্দ্রিক এমন একটি মানচিত্র প্রদর্শন করবে যা নিম্নলিখিত স্ক্রিনশটটিতে দেখা গেছে শহরে একটি চিহ্নিতকারী সহ।

অ্যাপটি মোতায়েন এবং চালাতে:

  1. অ্যান্ড্রয়েড স্টুডিওতে, আপনার অ্যাপ্লিকেশনটি চালানোর জন্য রান মেনু বিকল্প (বা প্লে বোতাম আইকন) ক্লিক করুন।
  2. যখন কোনও ডিভাইস চয়ন করার অনুরোধ জানানো হয়, নিম্নলিখিত বিকল্পগুলির মধ্যে একটি চয়ন করুন:
    • আপনার কম্পিউটারের সাথে সংযুক্ত অ্যান্ড্রয়েড ডিভাইসটি নির্বাচন করুন।
    • বিকল্পভাবে, লঞ্চ এমুলেটর রেডিও বোতামটি নির্বাচন করুন এবং আপনি যে ভার্চুয়াল ডিভাইসটি সেট আপ করেছেন তা চয়ন করুন।
  3. ওকে ক্লিক করুন। অ্যান্ড্রয়েড স্টুডিও আপনার অ্যাপ্লিকেশনটি তৈরি করতে গ্রেডল শুরু করবে এবং তারপরে আপনার ডিভাইস বা এমুলেটরে ফলাফলগুলি প্রদর্শন করবে। অ্যাপটি চালু হওয়ার আগে কয়েক মিনিট সময় নিতে পারে।

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

,

একটি অ্যান্ড্রয়েড অ্যাপ্লিকেশন তৈরি করুন যা অ্যান্ড্রয়েড স্টুডিওর জন্য গুগল ম্যাপস ভিউ টেমপ্লেট ব্যবহার করে একটি মানচিত্র প্রদর্শন করে। আপনার যদি একটি বিদ্যমান অ্যান্ড্রয়েড স্টুডিও প্রকল্প থাকে যা আপনি সেট আপ করতে চান তবে একটি অ্যান্ড্রয়েড স্টুডিও প্রকল্প সেট আপ করুন

এই কুইকস্টার্টটি এমন বিকাশকারীদের জন্য উদ্দেশ্যে করা হয়েছে যারা কোটলিন বা জাভা দিয়ে বেসিক অ্যান্ড্রয়েড বিকাশের সাথে পরিচিত।

উন্নয়নের পরিবেশ সম্পর্কে

এই কুইকস্টার্টটি অ্যান্ড্রয়েড স্টুডিও হেজহোগ এবং অ্যান্ড্রয়েড গ্রেডল প্লাগইন সংস্করণ 8.2 ব্যবহার করে তৈরি করা হয়েছিল।

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

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

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

অ্যান্ড্রয়েড স্টুডিওতে একটি গুগল ম্যাপ প্রকল্প তৈরি করুন

অ্যান্ড্রয়েড স্টুডিওতে একটি গুগল ম্যাপস প্রকল্প তৈরির পদ্ধতিটি ফ্লেমিংগো এবং পরবর্তীতে অ্যান্ড্রয়েড স্টুডিওর রিলিজগুলিতে পরিবর্তন করা হয়েছিল।

  1. অ্যান্ড্রয়েড স্টুডিও খুলুন এবং অ্যান্ড্রয়েড স্টুডিও উইন্ডোতে নতুন প্রকল্পে ক্লিক করুন।

  2. নতুন প্রকল্প উইন্ডোতে, ফোন এবং ট্যাবলেট বিভাগের অধীনে, কোনও ক্রিয়াকলাপ নির্বাচন করুন এবং তারপরে পরবর্তী ক্লিক করুন।

  3. নতুন প্রকল্প ফর্মটি সম্পূর্ণ করুন:

    • জাভা বা কোটলিনে ভাষা সেট করুন। উভয় ভাষা সম্পূর্ণরূপে অ্যান্ড্রয়েডের জন্য মানচিত্র এসডিকে দ্বারা সমর্থিত। কোটলিন সম্পর্কে আরও জানতে, কোটলিনের সাথে অ্যান্ড্রয়েড অ্যাপ্লিকেশনগুলি বিকাশ করুন

    • আপনার পরীক্ষার ডিভাইসের সাথে সামঞ্জস্যপূর্ণ একটি এসডিকে সংস্করণে ন্যূনতম এসডিকে সেট করুন। অ্যান্ড্রয়েড সংস্করণ 19.0.x এর জন্য মানচিত্র এসডিকে দ্বারা প্রয়োজনীয় ন্যূনতম সংস্করণের চেয়ে বৃহত্তর একটি সংস্করণ নির্বাচন করতে হবে, যা অ্যান্ড্রয়েড এপিআই স্তর 21 ("ললিপপ"; অ্যান্ড্রয়েড 5.0) বা উচ্চতর। এসডিকে সংস্করণ প্রয়োজনীয়তার সর্বশেষ তথ্যের জন্য রিলিজ নোটগুলি দেখুন।

    • কোটলিন ডিএসএল বা গ্রোভি ডিএসএলে বিল্ড কনফিগারেশন ভাষা সেট করুন। উভয় বিল্ড কনফিগারেশন ভাষাগুলির জন্য স্নিপেটগুলি নিম্নলিখিত পদ্ধতিতে প্রদর্শিত হয়।

  4. শেষ ক্লিক করুন.

    অ্যান্ড্রয়েড স্টুডিও গ্রেডল শুরু করে এবং প্রকল্পটি তৈরি করে। এতে কিছুটা সময় লাগতে পারে।

  5. গুগল ম্যাপ ভিউ ক্রিয়াকলাপ যুক্ত করুন:

    1. আপনার প্রকল্পের app ফোল্ডারে ডান ক্লিক করুন।
    2. নতুন> গুগল> গুগল ম্যাপস ভিউ ক্রিয়াকলাপ নির্বাচন করুন।

      একটি মানচিত্রের ক্রিয়াকলাপ যুক্ত করুন।

    3. নতুন অ্যান্ড্রয়েড ক্রিয়াকলাপ ডায়ালগ বাক্সে, লঞ্চার ক্রিয়াকলাপ চেকবক্সটি নির্বাচন করুন।

    4. সমাপ্তি নির্বাচন করুন।

      আরও তথ্যের জন্য, একটি টেম্পলেট থেকে কোড যুক্ত করুন দেখুন

  6. বিল্ডটি শেষ হয়ে গেলে, অ্যান্ড্রয়েড স্টুডিও AndroidManifest.xml এবং MapsActivity ফাইলগুলি খুলবে। আপনার ক্রিয়াকলাপের আলাদা নাম থাকতে পারে তবে এটি সেটআপের সময় আপনি কনফিগার করেছেন।

আপনার গুগল ক্লাউড প্রকল্প সেট আপ করুন

নিম্নলিখিত ট্যাবগুলির মাধ্যমে ক্লিক করে প্রয়োজনীয় ক্লাউড কনসোল সেটআপ পদক্ষেপগুলি সম্পূর্ণ করুন:

ধাপ 1

কনসোল

  1. গুগল ক্লাউড কনসোলে, প্রকল্প নির্বাচনকারী পৃষ্ঠায়, একটি নতুন ক্লাউড প্রকল্প তৈরি শুরু করতে প্রকল্প তৈরি করুন ক্লিক করুন।

    প্রকল্প নির্বাচক পৃষ্ঠায় যান

  2. আপনার ক্লাউড প্রকল্পের জন্য বিলিং সক্ষম হয়েছে তা নিশ্চিত করুন। আপনার প্রকল্পের জন্য বিলিং সক্ষম করা হয়েছে তা নিশ্চিত করুন

    গুগল ক্লাউড একটি $ 0.00 চার্জ ট্রায়াল সরবরাহ করে। ট্রায়ালটি 90 দিনের উভয় প্রান্তে বা অ্যাকাউন্টটি 300 ডলার মূল্যের চার্জ অর্জনের পরে শেষ হয়, যেটি প্রথমে আসে। যেকোনো সময় বাতিল করুন। গুগল ম্যাপস প্ল্যাটফর্মে একটি পুনরাবৃত্তি $ 200 মাসিক ক্রেডিট বৈশিষ্ট্যযুক্ত। আরও তথ্যের জন্য, বিলিং অ্যাকাউন্ট ক্রেডিট এবং বিলিং দেখুন।

ক্লাউড SDK

gcloud projects create "PROJECT"

গুগল ক্লাউড এসডিকে , ক্লাউড এসডিকে ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলি সম্পর্কে আরও পড়ুন:

ধাপ 2

গুগল ম্যাপস প্ল্যাটফর্মটি ব্যবহার করতে, আপনাকে অবশ্যই আপনার প্রকল্পের সাথে ব্যবহার করার পরিকল্পনা করছেন এপিআই বা এসডিকে সক্ষম করতে হবে।

কনসোল

অ্যান্ড্রয়েডের জন্য মানচিত্রগুলি এসডিকে সক্ষম করুন

ক্লাউড SDK

gcloud services enable \
    --project "PROJECT" \
    "maps-android-backend.googleapis.com"

গুগল ক্লাউড এসডিকে , ক্লাউড এসডিকে ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলি সম্পর্কে আরও পড়ুন:

ধাপ 3

এই পদক্ষেপটি কেবল এপিআই কী তৈরির প্রক্রিয়াটির মধ্য দিয়ে যায়। আপনি যদি উত্পাদনে আপনার এপিআই কী ব্যবহার করেন তবে আমরা দৃ strongly ়ভাবে সুপারিশ করি যে আপনি আপনার এপিআই কীটি সীমাবদ্ধ করুন। আপনি এপিআই কী পৃষ্ঠা ব্যবহার করে পণ্য-নির্দিষ্টতে আরও তথ্য পেতে পারেন।

API কী একটি অনন্য শনাক্তকারী যা ব্যবহার এবং বিলিং উদ্দেশ্যে আপনার প্রকল্পের সাথে যুক্ত অনুরোধগুলিকে প্রমাণীকরণ করে৷ আপনার প্রোজেক্টের সাথে যুক্ত অন্তত একটি API কী থাকতে হবে।

একটি API কী তৈরি করতে:

কনসোল

  1. Google মানচিত্র প্ল্যাটফর্ম > শংসাপত্র পৃষ্ঠাতে যান।

    শংসাপত্র পৃষ্ঠায় যান

  2. শংসাপত্র পৃষ্ঠায়, শংসাপত্র তৈরি করুন > API কী ক্লিক করুন।
    API কী তৈরি ডায়ালগ আপনার নতুন তৈরি API কী প্রদর্শন করে।
  3. Close এ ক্লিক করুন।
    নতুন এপিআই কীটি এপিআই কীগুলির অধীনে শংসাপত্র পৃষ্ঠায় তালিকাভুক্ত করা হয়েছে।
    ( এপিআই কীটি প্রযোজনায় ব্যবহার করার আগে এটি সীমাবদ্ধ করতে ভুলবেন না))

ক্লাউড SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

গুগল ক্লাউড এসডিকে , ক্লাউড এসডিকে ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলি সম্পর্কে আরও পড়ুন:

আপনার অ্যাপে API কী যোগ করুন

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

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

আপনার গুগল ম্যাপস প্রকল্পে অ্যান্ড্রয়েডের জন্য সিক্রেটস গ্রেডল প্লাগইন ইনস্টল করতে:

  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. ফাইলটি সংরক্ষণ করুন এবং আপনার প্রকল্পটি গ্রেডের সাথে সিঙ্ক করুন
  5. আপনার শীর্ষ-স্তরের ডিরেক্টরিতে secrets.properties ফাইলগুলি খুলুন এবং তারপরে নিম্নলিখিত কোডটি যুক্ত করুন। আপনার এপিআই কী দিয়ে YOUR_API_KEY প্রতিস্থাপন করুন। এই ফাইলটিতে আপনার কীটি সংরক্ষণ করুন কারণ secrets.properties কোনও সংস্করণ নিয়ন্ত্রণ সিস্টেমে চেক করা থেকে বাদ দেওয়া হয়।
    MAPS_API_KEY=YOUR_API_KEY
  6. ফাইলটি সংরক্ষণ করুন।
  7. আপনার শীর্ষ-স্তরের ডিরেক্টরিতে local.defaults.properties ফাইল তৈরি করুন, secrets.properties ফাইলের মতো একই ফোল্ডার এবং তারপরে নিম্নলিখিত কোডটি যুক্ত করুন।

    MAPS_API_KEY=DEFAULT_API_KEY

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

  8. ফাইলটি সংরক্ষণ করুন।
  9. আপনার AndroidManifest.xml ফাইলে, com.google.android.geo.API_KEY এ যান এবং android:value attribute । যদি <meta-data> ট্যাগটি বিদ্যমান না থাকে তবে এটি <application> অ্যাপ্লিকেশন> ট্যাগের সন্তান হিসাবে তৈরি করুন।
    <meta-data
        android:name="com.google.android.geo.API_KEY"
        android:value="${MAPS_API_KEY}" />

    Note: com.google.android.geo.API_KEY is the recommended metadata name for the API key. A key with this name can be used to authenticate to multiple Google Maps-based APIs on the Android platform, including the Maps SDK for Android. For backwards compatibility, the API also supports the name com.google.android.maps.v2.API_KEY. This legacy name allows authentication to the Android Maps API v2 only. An application can specify only one of the API key metadata names. If both are specified, the API throws an exception.

  10. In Android Studio, open your module-level build.gradle.kts or build.gradle file and edit the secrets property. If the secrets property does not exist, add it.

    Edit the properties of the plugin to set propertiesFileName to secrets.properties, set defaultPropertiesFileName to local.defaults.properties, and set any other 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 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.*"
    }
            

কোডটি দেখুন

টেমপ্লেট দ্বারা সরবরাহিত কোড পরীক্ষা করুন। বিশেষত, আপনার অ্যান্ড্রয়েড স্টুডিও প্রকল্পের নিম্নলিখিত ফাইলগুলি দেখুন।

মানচিত্র ক্রিয়াকলাপ ফাইল

মানচিত্রের ক্রিয়াকলাপ ফাইলটি অ্যাপ্লিকেশনটির প্রধান ক্রিয়াকলাপ এবং এটি মানচিত্রটি পরিচালনা এবং প্রদর্শন করার জন্য কোড রয়েছে। ডিফল্টরূপে, ক্রিয়াকলাপটি সংজ্ঞায়িত করা ফাইলটির নাম MapsActivity.java বা আপনি যদি কোটলিনকে আপনার অ্যাপ্লিকেশন, MapsActivity.kt এর ভাষা হিসাবে সেট করেন।

মানচিত্রের ক্রিয়াকলাপের প্রধান উপাদানগুলি:

  • SupportMapFragment অবজেক্টটি মানচিত্রের জীবনচক্র পরিচালনা করে এবং এটি অ্যাপের ইউআইয়ের মূল উপাদান।

  • GoogleMap অবজেক্টটি মানচিত্রের ডেটা এবং ভিউতে অ্যাক্সেস সরবরাহ করে। এটি অ্যান্ড্রয়েডের জন্য মানচিত্র এসডিকে মূল শ্রেণি। মানচিত্র অবজেক্টস গাইড আরও বিশদে SupportMapFragment এবং GoogleMap অবজেক্টগুলিকে বর্ণনা করে।

  • moveCamera ফাংশন সিডনি অস্ট্রেলিয়ার জন্য LatLng স্থানাঙ্কে মানচিত্রকে কেন্দ্র করে। মানচিত্র যুক্ত করার সময় কনফিগার করার জন্য প্রথম সেটিংস সাধারণত মানচিত্রের অবস্থান এবং ক্যামেরা সেটিংস; যেমন কোণ, মানচিত্র ওরিয়েন্টেশন এবং জুম স্তর দেখার মতো। বিশদ জন্য ক্যামেরা এবং দেখুন গাইড দেখুন।

  • addMarker ফাংশন সিডনির স্থানাঙ্কগুলিতে একটি চিহ্নিতকারী যুক্ত করে। বিশদের জন্য চিহ্নিতকারী গাইড দেখুন।

মডিউল গ্রেডল ফাইল

মডিউল build.gradle.kts ফাইলটিতে নিম্নলিখিত মানচিত্রের নির্ভরতা অন্তর্ভুক্ত রয়েছে, যা অ্যান্ড্রয়েডের জন্য মানচিত্র এসডিকে দ্বারা প্রয়োজনীয়।

dependencies {

    // Maps SDK for Android
    implementation("com.google.android.gms:play-services-maps:19.0.0")
}

মানচিত্রের নির্ভরতা পরিচালনা সম্পর্কে আরও জানতে, সংস্করণ দেখুন।

এক্সএমএল লেআউট ফাইল

activity_maps.xml ফাইলটি হ'ল এক্সএমএল লেআউট ফাইল যা অ্যাপের ইউআইয়ের কাঠামোকে সংজ্ঞায়িত করে। ফাইলটি res/layout ডিরেক্টরিতে অবস্থিত। activity_maps.xml ফাইলটি একটি খণ্ড ঘোষণা করে যা নিম্নলিখিত উপাদানগুলি অন্তর্ভুক্ত করে:

  • tools:context MapsActivity খণ্ডের ডিফল্ট ক্রিয়াকলাপ সেট করে, যা মানচিত্রের ক্রিয়াকলাপ ফাইলটিতে সংজ্ঞায়িত করা হয়।
  • android:name খণ্ডের শ্রেণীর নামটি SupportMapFragment সেট করে, যা মানচিত্রের ক্রিয়াকলাপ ফাইলটিতে ব্যবহৃত খণ্ডের ধরণ।

এক্সএমএল লেআউট ফাইলটিতে নিম্নলিখিত কোড রয়েছে:

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:map="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/map"
    android:name="com.google.android.gms.maps.SupportMapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MapsActivity" />

অ্যাপটি মোতায়েন করুন এবং চালান

স্ক্রিনশটটি মানচিত্রের সাথে এবং সিন্ডনি অস্ট্রেলিয়াকে কেন্দ্র করে চিহ্নিতকারী।

আপনি যখন অ্যাপ্লিকেশনটি সফলভাবে চালাচ্ছেন, এটি সিডনি অস্ট্রেলিয়ায় কেন্দ্রিক এমন একটি মানচিত্র প্রদর্শন করবে যা নিম্নলিখিত স্ক্রিনশটটিতে দেখা গেছে শহরে একটি চিহ্নিতকারী সহ।

অ্যাপটি মোতায়েন এবং চালাতে:

  1. অ্যান্ড্রয়েড স্টুডিওতে, আপনার অ্যাপ্লিকেশনটি চালানোর জন্য রান মেনু বিকল্প (বা প্লে বোতাম আইকন) ক্লিক করুন।
  2. যখন কোনও ডিভাইস চয়ন করার অনুরোধ জানানো হয়, নিম্নলিখিত বিকল্পগুলির মধ্যে একটি চয়ন করুন:
    • আপনার কম্পিউটারের সাথে সংযুক্ত অ্যান্ড্রয়েড ডিভাইসটি নির্বাচন করুন।
    • বিকল্পভাবে, লঞ্চ এমুলেটর রেডিও বোতামটি নির্বাচন করুন এবং আপনি যে ভার্চুয়াল ডিভাইসটি সেট আপ করেছেন তা চয়ন করুন।
  3. ওকে ক্লিক করুন। অ্যান্ড্রয়েড স্টুডিও আপনার অ্যাপ্লিকেশনটি তৈরি করতে গ্রেডল শুরু করবে এবং তারপরে আপনার ডিভাইস বা এমুলেটরে ফলাফলগুলি প্রদর্শন করবে। অ্যাপটি চালু হওয়ার আগে কয়েক মিনিট সময় নিতে পারে।

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