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

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

মনে রাখবেন: এই কুইকস্টার্ট Google Maps Views অ্যাক্টিভিটি টেমপ্লেট ব্যবহার করে, যা SupportMapFragment সহ একটি XML লেআউট তৈরি করে। আপনি Jetpack Compose-এর সাহায্যে UI তৈরি করলে, পরিবর্তে Maps Compose লাইব্রেরি দেখুন।

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

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

আমরা সাজেস্ট করি যে আপনি Android Studio এবং Android Gradle প্লাগ-ইন-এর লেটেস্ট স্টেবল ভার্সন ব্যবহার করুন।

মনে রাখবেন: আপনার ডেভেলপমেন্ট এনভায়রনমেন্টে Android Studio বা Gradle-এর অন্য কোনও ভার্সন ব্যবহার করা হলে, আপনার এনভায়রনমেন্টের উপর ভিত্তি করে আপনাকে ধাপগুলি পরিবর্তন করতে হতে পারে। Android Studio এবং Gradle ভার্সন সম্পর্কে আরও তথ্যের জন্য, Android Gradle প্লাগ-ইন এবং Android Studio-এর মানানসই হওয়া দেখুন।

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

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

• Android ডিভাইস ব্যবহার করতে, হার্ডওয়্যার ডিভাইসে অ্যাপ রান করুন লিঙ্কে দেওয়া নির্দেশাবলী অনুসরণ করুন।
• Android এমুলেটর ব্যবহার করতে, আপনি ভার্চুয়াল ডিভাইস তৈরি করতে এবং ডিভাইস ম্যানেজার ব্যবহার করে এমুলেটর ইনস্টল করতে পারবেন যা Android Studio-এর সাথে আসে।
  মনে রাখবেন: আপনি Android এমুলেটর ব্যবহার করার সিদ্ধান্ত নিলে, নিশ্চিত করুন যে আপনি Google Play আইকন সহ একটি ডিভাইস প্রোফাইল বেছে নিয়েছেন, , যা Play কলামে দেখানো হয়েছে। এই আইকন থেকে বোঝা যায় যে এইসব প্রোফাইল সম্পূর্ণভাবে CTS কমপ্লায়েন্ট এবং সিস্টেম ইমেজ ব্যবহার করতে পারে যার মধ্যে Play Store অ্যাপ অন্তর্ভুক্ত:

  

  Android Studio ডিভাইস ম্যানেজারে ডিভাইস যোগ করুন ডায়ালগ, Play কলামে Google Play আইকন সহ ভার্চুয়াল ডিভাইস প্রোফাইল দেখাচ্ছে।

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

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

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

   মনে রাখবেন: আপনি যদি কোনও অ্যাক্টিভিটি নেই-এর পরিবর্তে ডিফল্ট খালি অ্যাক্টিভিটি (Jetpack Compose) টেমপ্লেট থেকে শুরু করেন এবং পরে একটি Google Maps Views অ্যাক্টিভিটি যোগ করেন, তাহলে MapsActivity (AppCompatActivity) লঞ্চ করার সময় IllegalStateException: You need to use a Theme.AppCompat theme (or descendant) with this activity-এর সাথে ক্র্যাশ করে কারণ Compose টেমপ্লেট res/values/themes.xml-এ থিম প্যারেন্টকে android:Theme.Material.Light.NoActionBar-এ সেট করে। এই ক্র্যাশ এড়াতে, আপনার থিমের parent res/values/themes.xml-এ আপডেট করে Theme.AppCompat.DayNight.NoActionBar করুন এবং নিশ্চিত করুন যে .MapsActivity AndroidManifest.xml-এ MAIN/LAUNCHER অ্যাক্টিভিটি হিসেবে কনফিগার করা আছে।

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

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

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

     মনে রাখবেন: কোন SDK ভার্সন বেছে নেবেন সেই ব্যাপারে নিশ্চিত না হলে, বেছে নিতে আমাকে সাহায্য করুন লিঙ্কে ক্লিক করে কাজ করে এমন Android SDK-এর ডিস্ট্রিবিউশন সংক্রান্ত তথ্য দেখুন। যেমন, আপনি যদি Android API লেভেল ২৩ ("Marshmallow"; Android 6.0) বেছে নেন, তাহলে আপনার অ্যাপ ৯৯%-এর বেশি Android ডিভাইসে কাজ করবে।

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

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

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

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

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

   2. নতুন > Google > Google Maps Views অ্যাক্টিভিটি বেছে নিন:

      

      Android Studio-তে app প্রাসঙ্গিক মেনু থেকে Google Maps Views অ্যাক্টিভিটি যোগ করা।

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

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

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

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

   সতর্কতা: Google Maps Views অ্যাক্টিভিটি টেমপ্লেট দ্বারা তৈরি করা প্রোজেক্ট অতিরিক্ত কনফিগারেশন ছাড়া চলবে না। যদিও টেমপ্লেটটি libs.versions.toml এবং build.gradle.kts-এ Android-এর জন্য Secrets Gradle প্লাগ-ইন যোগ করে, এটি secrets.properties কনফিগার করে না এবং এর পরিবর্তে AndroidManifest.xml-এ সরাসরি একটি YOUR_API_KEY প্লেসহোল্ডার রাখে (local.properties-কে রেফারেন্স করা লিগ্যাসি কমেন্ট সহ)। আপনার API কী সরাসরি AndroidManifest.xml-এ পেস্ট করবেন না বা local.properties-এ যোগ করবেন না। পরিবর্তে, MAPS_API_KEY-কে secrets.properties ফাইলে সেভ করতে, আপনার মডিউল-লেভেল Gradle ফাইলে secrets ব্লক কনফিগার করতে এবং android:value="${MAPS_API_KEY}"-কে AndroidManifest.xml-এ সেট করতে, আপনার Google Cloud প্রোজেক্ট সেট-আপ করুন এবং আপনার অ্যাপে API কী যোগ করুন লিঙ্কে দেওয়া নির্দেশাবলী অনুসরণ করুন।

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

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

ধাপ ১: আপনার প্রোজেক্ট সেট-আপ করুন

কনসোল

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

   প্রোজেক্ট সিলেক্টর পৃষ্ঠায় যান

2. আপনার ক্লাউড প্রোজেক্টের জন্য বিলিং চালু করা আছে কিনা তা নিশ্চিত করুন। আপনার প্রোজেক্টের জন্য বিলিং চালু করা আছে কিনা তা কনফার্ম করুন।

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

Cloud SDK

gcloud projects create "PROJECT"

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

• gcloud projects create

মনে রাখবেন: আপনি যদি লার্নিং এক্সারসাইজে তৈরি করা রিসোর্স রাখতে না চান, তাহলে আগে থেকে থাকা প্রোজেক্ট বেছে নেওয়ার পরিবর্তে একটি প্রোজেক্ট তৈরি করুন। অনুশীলন শেষ করার পরে, আপনি প্রোজেক্টটি মুছে ফেলতে পারেন, প্রোজেক্টের সাথে যুক্ত সমস্ত রিসোর্স সরিয়ে ফেলতে পারেন।

ধাপ ২: API বা 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 ইনস্টলেশন এবং নিম্নলিখিত কমান্ড সম্পর্কে আরও পড়ুন:

• gcloud services enable
• gcloud services disable

ধাপ ৩: API key পাওয়া

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

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

কনসোল

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

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

2. প্রম্পট করা হলে, আপনার প্রোজেক্ট বেছে নিন।

3. নিম্নলিখিতগুলির মধ্যে থেকে যেকোনও একটি করুন:

   • নতুন 'কী' তৈরি করুন:

     1. ক্রেডেনশিয়াল তৈরি করুন > API key বিকল্পে ক্লিক করুন।
     2. API key তৈরি করুন প্যানেলে, API সংক্রান্ত বিধিনিষেধ বেছে নিন তালিকা খুলুন।
     3. এই 'কী'-এর প্রয়োজন নেই এমন যেকোনও API মুছে দিন এবং নিশ্চিত করুন যে Android-এর জন্য Maps SDK বেছে নেওয়া আছে।
     4. তৈরি করুন বিকল্পে ক্লিক করুন। প্যানেলে আপনার নতুন API কী দেখা যাবে।

   • আগে থেকে থাকা 'কী' ব্যবহার করুন:

     1. 'কী'-এর নামে ক্লিক করুন।
     2. API সংক্রান্ত বিধিনিষেধ বেছে নিন তালিকা থেকে, Maps SDK for Android বেছে নিন।
     3. সেভ করুন বিকল্পে ক্লিক করুন।

   এখানে API বেছে নিলে তা চালু হয় না। Maps SDK for Android এর API লাইব্রেরি পৃষ্ঠায় চালু করা আছে কিনা তা নিশ্চিত করুন।

4. পরে কী স্ট্রিং দেখতে, কী ও ক্রেডেনশিয়াল পৃষ্ঠায় যান এবং কী-এর জন্য কী দেখুন বিকল্পে ক্লিক করুন।

কনসোলটি যদি এই ধাপগুলির থেকে আলাদা দেখায়, তাহলে Google Cloud ডকুমেন্টেশনে একটি API কী তৈরি করুন এবং API বিধিনিষেধ যোগ করুন দেখুন।

Cloud SDK

নিচের কমান্ডে PROJECT_ID-এর জায়গায় আপনার প্রোজেক্ট আইডি লিখুন।

• নতুন 'কী' তৈরি করুন: নিম্নলিখিত কমান্ড রান করুন এবং DISPLAY_NAME-এর জায়গায় 'কী'-এর নাম লিখুন।

  gcloud services api-keys create \
      --project="PROJECT_ID" \
      --display-name="DISPLAY_NAME" \
      --api-target=service=maps-android-backend.googleapis.com

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

  • gcloud services api-keys create

• আগে থেকে থাকা 'কী' ব্যবহার করুন: নিম্নলিখিত কমান্ড রান করুন এবং KEY_ID-এর জায়গায় 'কী'-এর আইডি লিখুন। --append ফ্ল্যাগ সেইসব API রাখে যেগুলি 'কী' আগে থেকেই অনুমোদন করে। এটি না থাকলে, কমান্ডটি সেগুলি পরিবর্তন করে।

  gcloud services api-keys update KEY_ID \
      --project="PROJECT_ID" \
      --append \
      --api-target=service=maps-android-backend.googleapis.com

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

  • gcloud services api-keys update
  • gcloud services api-keys list

  'কী' আইডি হল 'কী' স্ট্রিং বা ডিসপ্লে নাম নয়। এটি খুঁজতে, gcloud services api-keys list --project="PROJECT_ID" রান করুন। আইডি হল name ফিল্ডের শেষ অংশ: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID।

কী স্ট্রিং দেখতে, gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID" রান করুন।

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

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

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

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

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

   Kotlin

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

   Groovy

   plugins {
       // ...
       id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' version '2.0.1' apply false
   }

2. আপনার মডিউল-লেভেল build.gradle.kts বা build.gradle ফাইল খুলুন এবং নিম্নলিখিত কোডটি plugins এলিমেন্টে যোগ করুন।

   Kotlin

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

   Groovy

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

3. আপনি Android Studio ব্যবহার করলে, Gradle-এর সাথে আপনার প্রোজেক্ট সিঙ্ক করুন।
4. আপনার টপ-লেভেল ডিরেক্টরিতে secrets.properties ফাইলটি খুলুন, এবং তারপরে নিম্নলিখিত কোডটি যোগ করুন। আপনার API key দিয়ে YOUR_API_KEY প্রতিস্থাপন করুন। আপনার .gitignore ফাইলে secrets.properties যোগ করতে ভুলবেন না (অথবা আপনার ভার্সন কন্ট্রোল সিস্টেম থেকে এটি বাদ দিন) যাতে আপনি ভার্সন কন্ট্রোলে আপনার API কী চেক না করেন।
   মনে রাখবেন: যদি secrets.properties ফাইল না থাকে, তাহলে local.properties ফাইলের মতো একই ফোল্ডারে এটি তৈরি করুন।

   MAPS_API_KEY=YOUR_API_KEY

5. আপনার টপ-লেভেল ডিরেক্টরিতে local.defaults.properties ফাইল তৈরি করুন, secrets.properties ফাইলের মতো একই ফোল্ডার এবং তারপর নিম্নলিখিত কোড যোগ করুন।

   মনে রাখবেন: যেভাবে দেখানো হয়েছে সেইভাবে কোড লিখুন। আপনার API key দিয়ে DEFAULT_API_KEY পরিবর্তন করবেন না।

   MAPS_API_KEY=DEFAULT_API_KEY

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

6. আপনার 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}" />
       

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

7. Android Studio-তে, আপনার মডিউল-লেভেল build.gradle.kts বা build.gradle ফাইল খুলুন এবং secrets প্রপার্টি এডিট করুন। secrets প্রপার্টি না থাকলে, এটি যোগ করুন।

   propertiesFileName-কে "secrets.properties"-এ সেট করতে, defaultPropertiesFileName-কে "local.defaults.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 root directory (the same folder as the root 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"
   }

   Groovy

   secrets {
       // To add your Maps API key to this project:
       // 1. If the secrets.properties file does not exist, create it in the root directory (the same folder as the root 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"
   }

মনে রাখবেন: Logcat যদি E/Google Maps Android API: Authorization failure রিপোর্ট করে অথবা ম্যাপ টাইল লোড হতে না পারে, তাহলে আপনার Google Cloud প্রোজেক্টে Maps SDK for Android চালু আছে কিনা, আপনার মার্জ করা AndroidManifest.xml-এ API কী সঠিক কিনা এবং আপনার API কী Android অ্যাপ সীমাবদ্ধতা ব্যবহার করলে, আপনার প্রোজেক্টের প্যাকেজের নাম (যেমন com.example.myfirstmapsapp) এবং আপনার সাইনিং কীস্টোরের SHA-1 ফিঙ্গারপ্রিন্ট (যেমন ~/.android/debug.keystore) Google Cloud-এ API কী-এর অনুমোদিত Android অ্যাপ্লিকেশনে যোগ করা হয়েছে কিনা তা যাচাই করুন।

কোডটি দেখুন

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

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

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

Maps অ্যাক্টিভিটির প্রধান এলিমেন্ট:

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

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

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

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

Kotlin

// Add a marker in Sydney and move the camera
val sydney = LatLng(-34.0, 151.0)
map.addMarker(
    MarkerOptions()
        .position(sydney)
        .title("Marker in Sydney"),
)
map.moveCamera(CameraUpdateFactory.newLatLng(sydney))

      

Java

// Add a marker in Sydney and move the camera
LatLng sydney = new LatLng(-34, 151);
map.addMarker(new MarkerOptions().position(sydney).title("Marker in Sydney"));
map.moveCamera(CameraUpdateFactory.newLatLng(sydney));

      

মডিউল Gradle ফাইল

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

Kotlin

dependencies {

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

Groovy

dependencies {

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

আপনার প্রোজেক্ট Gradle ভার্সন ক্যাটালগ (gradle/libs.versions.toml) ব্যবহার করলে, libs.versions.toml-এ play-services-maps ডিপেন্ডেন্সি নির্ধারণ করুন:

[versions]
play-services-maps = "20.0.0"

[libraries]
play-services-maps = { module = "com.google.android.gms:play-services-maps", version.ref = "play-services-maps" }

মনে রাখবেন: Maps SDK for Android-এর বর্তমান ভার্সনের উপর ভিত্তি করে সঠিক ভার্সন পরিবর্তন হতে পারে।

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) লাইব্রেরি আপনাকে Android-এর জন্য Maps SDK ব্যবহার করার সময় Kotlin ভাষার বিভিন্ন ফিচারের সুবিধা নিতে দেয়।