Android-এর জন্য Maps SDK কুইকস্টার্ট

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

এই কুইকস্টার্ট সেইসব ডেভেলপারদের জন্য যারা Kotlin বা Java-এর মাধ্যমে Android ডেভেলপমেন্টের প্রাথমিক বিষয়গুলি সম্পর্কে পরিচিত।

ডেভেলপমেন্ট এনভায়রনমেন্ট সম্পর্কে

এই কুইকস্টার্ট Android Studio Hedgehog এবং Android Gradle প্লাগ-ইন ভার্সন ৮.২ ব্যবহার করে ডেভেলপ করা হয়েছে।

Android ডিভাইস সেট-আপ করা

Maps SDK for Android ব্যবহার করে এমন কোনও অ্যাপ চালাতে, আপনাকে অবশ্যই Android 6.0 বা তার পরের যেকোনও ভার্সনের উপর ভিত্তি করে তৈরি করা Android ডিভাইস বা Android এমুলেটরে এটি ডেপ্লয় করতে হবে এবং এতে Google API অন্তর্ভুক্ত থাকতে হবে।

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

Android Studio-তে Google Maps প্রোজেক্ট তৈরি করা

Android Studio-তে Google Maps প্রোজেক্ট তৈরি করার পদ্ধতি Android Studio-এর Flamingo ও পরবর্তী রিলিজগুলিতে পরিবর্তন করা হয়েছে।

  1. Android Studio খুলুন এবং Android Studio-তে স্বাগতম উইন্ডোতে নতুন প্রোজেক্ট বিকল্পে ক্লিক করুন।

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

  3. নতুন প্রোজেক্ট ফর্ম পূরণ করুন:

    • ভাষা হিসেবে Java বা Kotlin সেট করুন। Maps SDK for Android-এ দুটি ভাষাই সম্পূর্ণভাবে কাজ করে। Kotlin সম্পর্কে আরও জানতে, Kotlin-এর মাধ্যমে Android অ্যাপ ডেভেলপ করুন দেখুন।

    • আপনার টেস্ট ডিভাইসের সাথে মানানসই SDK ভার্সনে ন্যূনতম SDK সেট করুন। আপনাকে অবশ্যই Maps SDK for Android ভার্সন 20.0.x-এর প্রয়োজনীয় ন্যূনতম ভার্সনের থেকে বেশি ভার্সন বেছে নিতে হবে, যা হল Android API লেভেল 23 ("Marshmallow"; Android 6.0) বা তার পরবর্তী যেকোনও ভার্সন। SDK ভার্সন সংক্রান্ত প্রয়োজনীয়তার ব্যাপারে লেটেস্ট তথ্য পেতে রিলিজ নোট দেখুন।

    • বিল্ড কনফিগারেশন ভাষা Kotlin DSL বা Groovy DSL হিসেবে সেট করুন। নিচে উল্লেখ করা পদ্ধতি অনুসরণ করে, দুটি বিল্ড কনফিগারেশন ভাষার জন্য স্নিপেট দেখানো হয়।

  4. সম্পূর্ণ করুন বিকল্প বেছে নিন।

    Android Studio, Gradle শুরু করে এবং প্রোজেক্ট তৈরি করে। এতে কিছুটা সময় লাগতে পারে।

  5. Google Maps Views অ্যাক্টিভিটি যোগ করুন:

    1. আপনার প্রোজেক্টে app ফোল্ডারে ডানদিকের বোতামে ক্লিক করুন।

    2. নতুন > Google > Google Maps ভিউ অ্যাক্টিভিটি বিকল্প বেছে নিন।

      Maps অ্যাক্টিভিটি যোগ করুন।

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

    4. সম্পূর্ণ করুন বিকল্প বেছে নিন।

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

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

আপনার Google Cloud প্রোজেক্ট সেট-আপ করা

নিচের ট্যাবগুলিতে ক্লিক করে Cloud Console সেট-আপের প্রয়োজনীয় ধাপগুলি সম্পূর্ণ করুন:

ধাপ ১

কনসোল

  1. Google Cloud কনসোলে, প্রোজেক্ট বাছাইকারী পৃষ্ঠায়, নতুন Cloud প্রোজেক্ট তৈরি করা শুরু করতে, প্রোজেক্ট তৈরি করুন বিকল্পে ক্লিক করুন।

    প্রোজেক্ট বাছাইকারী পৃষ্ঠায় যান

  2. আপনার Cloud প্রোজেক্টের জন্য বিলিং চালু করা আছে কিনা তা ভাল করে দেখে নিন। আপনার প্রোজেক্টের জন্য বিলিং চালু করা আছে কিনা তা কনফার্ম করুন।

    Google Cloud $0.00 চার্জের ট্রায়াল অফার করে। ৯০ দিনের শেষে অথবা অ্যাকাউন্টে $৩০০ মূল্যের চার্জ জমা হলে, যেটি আগে ঘটবে, তখনই ট্রায়ালের মেয়াদ শেষ হয়ে যাবে। যেকোনও সময় বাতিল করুন। আরও তথ্যের জন্য, বিলিং অ্যাকাউন্ট ক্রেডিট ও বিলিং দেখুন।

Cloud SDK

gcloud projects create "PROJECT"

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

ধাপ ২

Google Maps Platform ব্যবহার করতে, আপনার প্রোজেক্টের সাথে যে API বা SDK ব্যবহার করার পরিকল্পনা করেছেন, সেগুলি অবশ্যই চালু করতে হবে।

কনসোল

Android-এর জন্য Maps SDK চালু করুন

Cloud SDK

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

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

ধাপ ৩

এই ধাপে শুধু API কী তৈরি করার প্রসেস দেখানো হয়। আপনি প্রোডাকশনে API কী ব্যবহার করলে, আমরা API কী সীমাবদ্ধ করার জন্য জোরালো সাজেশন দিই। প্রোডাক্ট-নির্দিষ্ট API কী ব্যবহার করা পৃষ্ঠায় আপনি আরও তথ্য পাবেন।

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

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

কনসোল

  1. Google Maps Platform > ক্রেডেনশিয়াল পৃষ্ঠায় যান।

    ক্রেডেনশিয়াল পৃষ্ঠায় যান

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

Cloud SDK

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

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

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

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

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

Android-এর জন্য Secrets Gradle প্লাগ-ইন ইনস্টল করতে এবং আপনার API key সেভ করতে:

  1. Android Studio-তে, আপনার রুট-লেভেল build.gradle ফাইল খুলুন এবং buildscript-এর অধীনে থাকা dependencies এলিমেন্টে নিম্নলিখিত কোড যোগ করুন।

    Groovy

    buildscript {
    dependencies {
        // ...
        classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1"
    }
}

    Kotlin

    buildscript {
    dependencies {
        // ...
        classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1")
    }
}
  2. আপনার অ্যাপ-লেভেল build.gradle ফাইল খুলুন এবং plugins এলিমেন্টে নিম্নলিখিত কোড যোগ করুন।

    Groovy

    plugins {
    id 'com.android.application'
    // ...
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
}

    Kotlin

    plugins {
    id("com.android.application")
    // ...
    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
}
  3. আপনি Android Studio ব্যবহার করলে, Gradle-এর সাথে আপনার প্রোজেক্ট সিঙ্ক করুন।
  4. আপনার প্রোজেক্ট লেভেল ডিরেক্টরিতে local.properties খুলুন এবং তারপরে নিচের কোডটি যোগ করুন। আপনার API key দিয়ে YOUR_API_KEY পরিবর্তন করুন। 
    MAPS_API_KEY=YOUR_API_KEY
  5. আপনার AndroidManifest.xml ফাইলে গিয়ে com.google.android.geo.API_KEY বিকল্পে যান এবং android:value অ্যাট্রিবিউটটি এইভাবে আপডেট করুন: 
    <meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="${MAPS_API_KEY}" />

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

কোডটি দেখুন

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

Maps অ্যাক্টিভিটি ফাইল

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

Maps অ্যাক্টিভিটির প্রধান উপাদান:

  • SupportMapFragment অবজেক্ট ম্যাপের লাইফসাইকেল ম্যানেজ করে এবং এটি অ্যাপের UI-এর পেরেন্ট এলিমেন্ট।

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

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

  • addMarker ফাংশনটি সিডনির কোঅর্ডিনেটে একটি মার্কার যোগ করে। আরও বিবরণের জন্য মার্কার গাইড দেখুন।

মডিউল Gradle ফাইল

Maps SDK for Android-এর জন্য প্রয়োজনীয় মডিউল build.gradle.kts ফাইলে নিম্নলিখিত ম্যাপের নির্ভরতা অন্তর্ভুক্ত থাকে।

dependencies {

    // Maps SDK for Android
    implementation(libs.play.services.maps)
}

Maps-এর উপর নির্ভরতা ম্যানেজ করা সম্পর্কে আরও জানতে, ভার্সনিং দেখুন।

XML লেআউট ফাইল

activity_maps.xml ফাইল হল XML লেআউট ফাইল যা অ্যাপের UI-এর স্ট্রাকচারকে নির্ধারণ করে। ফাইলটি res/layout ডিরেক্টরিতে আছে। activity_maps.xml ফাইল এমন একটি ফ্র্যাগমেন্ট ঘোষণা করে যার মধ্যে নিম্নলিখিত এলিমেন্ট অন্তর্ভুক্ত:

  • tools:context ফ্র্যাগমেন্টের ডিফল্ট অ্যাক্টিভিটি MapsActivity হিসেবে সেট করে, যা Maps অ্যাক্টিভিটি ফাইলে সংজ্ঞায়িত করা আছে।
  • 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. Android Studio-তে, আপনার অ্যাপ রান করাতে রান করুন মেনু বিকল্পে (বা প্লে বোতাম আইকনে) ক্লিক করুন।
  2. ডিভাইস বেছে নিতে বলা হলে, নিম্নলিখিত বিকল্পগুলির মধ্যে একটি বেছে নিন:
    • আপনার কম্পিউটারের সাথে কানেক্ট করা Android ডিভাইসটি বেছে নিন।
    • অথবা, ইমুলেটর লঞ্চ করুন রেডিও বোতাম বেছে নিন এবং আপনার সেট-আপ করা ভার্চুয়াল ডিভাইস বেছে নিন।
  3. ঠিক আছে বিকল্পে ক্লিক করুন। Android Studio আপনার অ্যাপ তৈরি করার জন্য Gradle শুরু করবে এবং তারপরে আপনার ডিভাইস বা এমুলেটরে ফলাফল দেখাবে। অ্যাপটি চালু হতে কয়েক মিনিট সময় লাগতে পারে।

পরবর্তী ধাপ

  • ম্যাপ সেট-আপ করা: এই ডকুমেন্ট আপনার ম্যাপের প্রাথমিক ও রানটাইম সেটিংস কীভাবে সেট-আপ করবেন তা বর্ণনা করে, যেমন ক্যামেরার পজিশন, ম্যাপের ধরন, UI কম্পোনেন্ট ও জেসচার।

  • আপনার Android অ্যাপে ম্যাপ যোগ করুন (Kotlin): এই কোডল্যাব আপনাকে এমন একটি অ্যাপের মাধ্যমে নিয়ে যায় যা Android-এর জন্য Maps SDK-এর কিছু অতিরিক্ত ফিচার দেখায়।

  • Maps Android KTX লাইব্রেরি ব্যবহার করুন: এই Kotlin এক্সটেনশন (KTX) লাইব্রেরি আপনাকে Maps SDK for Android ব্যবহার করার সময় Kotlin ভাষার বিভিন্ন ফিচার ব্যবহার করার সুবিধা দেয়।