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 বা তার পরবর্তী ভার্সনের উপর ভিত্তি করে তৈরি এবং Google API অন্তর্ভুক্ত করে এমন Android ডিভাইস বা Android এমুলেটরে ডিপ্লয় করতে হবে।

  • 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 Views অ্যাক্টিভিটি বেছে নিন।

      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 Key তৈরি করার প্রসেস দেখানো হয়। আপনি প্রোডাকশনে API কী ব্যবহার করলে, আমরা API কী সীমাবদ্ধ করার জন্য জোরালো সাজেশন দিই। আপনি প্রোডাক্ট-নির্দিষ্ট API কী ব্যবহার করা পৃষ্ঠায় আরও তথ্য পেতে পারেন।

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

API key তৈরি করতে:

কনসোল

  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 ফাইল

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

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-এ সেট করে, যা maps অ্যাক্টিভিটি ফাইলে ব্যবহৃত ফ্র্যাগমেন্টের ধরন।

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 ভাষার বিভিন্ন ফিচার ব্যবহার করার সুবিধা দেয়।