সেটআপ

Android-এর জন্য Maps 3D SDK-এর সাহায্যে তৈরি করা শুরু করার জন্য আপনাকে কী কী করতে হবে তা এই পৃষ্ঠায় বর্ণনা করা হয়েছে। সেট-আপ প্রসেসে SDK-এর সাথে ব্যবহারের জন্য Google Cloud প্রোজেক্ট ও API কনফিগার করা এবং তারপর Android Studio প্রোজেক্ট সেট-আপ করা অন্তর্ভুক্ত। আপনার অ্যাপে প্রথম 3D ম্যাপ যোগ করার আগে এইসব ধাপ সম্পূর্ণ করুন।

পূর্বশর্ত

Android-এর জন্য Maps 3D SDK ব্যবহার করতে, আপনার প্রোজেক্ট এবং টার্গেট ডিভাইসে নিম্নলিখিত প্রয়োজনীয়তা পূরণ করতে হবে:

• ন্যূনতম API লেভেল: Android API লেভেল ২৪ (Android 7.0) বা তার চেয়ে বেশি। আপনার অ্যাপকে অবশ্যই 24 বা এর থেকে বেশি minSdk ভার্সনে টার্গেট করতে হবে।
• Google Play পরিষেবা: Android-এর জন্য Maps 3D SDK, Google Play পরিষেবার উপর নির্ভর করে। টার্গেট ডিভাইসে (এবং Google API সহ এমুলেটরে) Google Play পরিষেবা ইনস্টল করা থাকতে হবে।

Google Cloud প্রোজেক্ট ও API কী সেট-আপ করা

Android-এর জন্য Maps 3D SDK ব্যবহার করে তৈরি করা শুরু করার আগে, আপনাকে Android-এর জন্য Maps 3D SDK-এর সাথে ব্যবহার করার জন্য একটি Google Cloud প্রোজেক্ট এবং API কী সেট-আপ করতে হবে। এর জন্য নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

ধাপ ১

কনসোল

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

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

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

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

Cloud SDK

gcloud projects create "PROJECT"

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

• gcloud projects create

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

ধাপ ২

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

মনে রাখবেন, কিছু ইন্টিগ্রেশনের জন্য আপনাকে একাধিক API/SDK চালু করতে হবে। কোন API বা SDK চালু করতে হবে তা নিশ্চিত না হলে, ক্যাপাবিলিটি এক্সপ্লোরার ব্যবহার করে দেখুন অথবা আপনি যে API/SDK ব্যবহার করতে চান তার ডকুমেন্টেশন দেখুন।

এক বা একাধিক API বা SDK চালু করতে:

কনসোল

1. Google Maps Platform API এবং SDK দেখুন যা আপনি Cloud কনসোলে Maps API লাইব্রেরি পৃষ্ঠায় গিয়ে চালু করতে পারবেন:

   Maps API লাইব্রেরি পৃষ্ঠাতে যান

2. আপনি যে API বা SDK চালু করতে চান সেটিতে ক্লিক করুন।
   • বোতামে চালু করুন লেখা থাকলে, API বা SDK চালু করতে বোতামে ক্লিক করুন।
   • বোতামে ম্যানেজ করুন লেখা থাকলে, API বা SDK আগেই চালু করা আছে এবং আপনাকে আর কিছু করতে হবে না।
   • যেকোনও একটি বোতামে ক্লিক করলে API বা SDK-এর জন্য ড্যাশবোর্ড দেখা যাবে। (এই প্রোজেক্ট থেকে API বা SDK সরাতে, বন্ধ করুন বোতামে ক্লিক করুন ।)

Cloud SDK

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

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

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

• gcloud services enable
• gcloud services disable

Environment API চালু করতে এই কমান্ড ব্যবহার করুন:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

মনে রাখবেন: Places API চালু করলে, Places Library, Maps JavaScript API, Android-এর জন্য Places SDK এবং iOS-এর জন্য Places SDK-ও চালু হয়ে যায়।

ধাপ ৩

এই ধাপে শুধু API Key তৈরি করার প্রসেস দেখানো হয়। আপনি প্রোডাকশনে 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 ইনস্টলেশন , এবং নিম্নলিখিত কমান্ড সম্পর্কে আরও পড়ুন:

• gcloud services api-keys create

SDK চালু করতে, Google Cloud Console-এ Android-এর জন্য Maps 3D SDK পৃষ্ঠা দেখুন। এইসব ধাপ সম্পূর্ণ করার ব্যাপারে আরও তথ্য পেতে, Google Maps Platform ব্যবহার শুরু করা দেখুন।

Android Studio প্রোজেক্ট সেট-আপ করা

এই বিভাগে, Android-এর জন্য Maps 3D SDK-এর সাথে ব্যবহার করার জন্য কীভাবে Android Studio প্রোজেক্ট তৈরি ও কনফিগার করতে হয় তা ব্যাখ্যা করা হয়েছে।

পার্ট ১: আপনার প্রোজেক্ট ও Gradle কনফিগারেশন সেট-আপ করা

1. Empty Views Activity টেমপ্লেট ব্যবহার করে নতুন Android Studio প্রোজেক্ট তৈরি করুন। প্রোজেক্ট কনফিগারেশনে, ন্যূনতম SDK API 24 বা তার পরবর্তী ভার্সনে সেট করুন।

2. আপনি সোর্স কন্ট্রোলের জন্য Git ব্যবহার করলে, আপনার সিক্রেট ফাইল যাতে ভার্সন কন্ট্রোলে কমিট না হয় তার জন্য প্রোজেক্টের .gitignore ফাইলটি পরিবর্তন করুন:

   • আপনার প্রোজেক্টের রুট ডিরেক্টরিতে, .gitignore ফাইল খুলুন।
   • নিম্নলিখিত লাইন যোগ করুন:

   secrets.properties
   

3. প্রোজেক্ট-লেভেল build.gradle.kts ফাইল আপডেট করুন:

   • আপনার প্রোজেক্টের রুট ডিরেক্টরিতে, build.gradle.kts ফাইল খুলুন।
   • plugins ব্লকে, Secrets Gradle প্লাগ-ইন যোগ করুন:

   plugins {
     alias(libs.plugins.android.application) apply false
     alias(libs.plugins.kotlin.android) apply false
     alias(libs.plugins.secrets.gradle.plugin) apply false // Add this line
   }
   

4. gradle/libs.versions.toml ফাইল আপডেট করুন:

   • gradle/libs.versions.toml ফাইল খুলুন, যা সাধারণত প্রোজেক্ট রুট ডিরেক্টরির মধ্যে gradle ডিরেক্টরিতে থাকে।
   • [versions] বিভাগে, SDK এবং Secrets Gradle প্লাগ-ইনের জন্য ভার্সন যোগ করুন:

   # See https://developers.google.com/android/guides/setup?device=phone-tablet for available releases
   maps3dSdk = "16.0.0"
   # See https://github.com/google/secrets-gradle-plugin/releases for available releases
   secretsGradlePlugin = "2.0.1"
   

   • [library] বিভাগে, SDK লাইব্রেরি যোগ করুন:

   play-services-maps3d = { module = "com.google.android.gms:play-services-maps3d", version.ref = "maps3dSdk" }
   

   • [plugins] বিভাগে, Secrets Gradle প্লাগ-ইন যোগ করুন:

   secrets-gradle-plugin = { id = "com.google.android.libraries.mapsplatform.secrets-gradle-plugin", version.ref = "secretsGradlePlugin" }
   

5. মডিউল-লেভেল app/build.gradle.kts ফাইল আপডেট করুন:

   • মডিউল-লেভেল build.gradle.kts ফাইল খুলুন, যা সাধারণত app ডিরেক্টরির মধ্যে থাকে।
   • ফাইলের সবচেয়ে উপরে, Secrets Gradle প্লাগ-ইনটি plugins ব্লকে যোগ করুন:

   plugins {
       alias(libs.plugins.android.application)
       alias(libs.plugins.kotlin.android)
       alias(libs.plugins.secrets.gradle.plugin) // Add this line
   }
   

   • dependencies ব্লকে, Android-এর জন্য Maps 3D SDK-এর Google Play পরিষেবা ডিপেন্ডেন্সি যোগ করুন:

   dependencies {
       // ... other dependencies
       implementation(libs.play.services.maps3d) // Add this line
   }
   

   • ফাইলের শেষে, android এবং dependencies ব্লকের বাইরে, সিক্রেট কনফিগারেশন যোগ করুন:

   secrets {
       // Optionally specify a different filename containing your secrets.
       // The plugin defaults to "local.properties"
       propertiesFileName = "secrets.properties"
   
       // A properties file containing default secret values. This file can be
       // checked in version control.
       defaultPropertiesFileName = "local.defaults.properties"
   }
   

পার্ট ২: আপনার প্রোজেক্টে API key যোগ করা

1. secrets.properties ফাইল তৈরি করুন:

   • অ্যাপ মডিউল রুট ডিরেক্টরিতে (সাধারণত app ডিরেক্টরি), secrets.properties নামে একটি নতুন ফাইল তৈরি করুন।
   • ফাইলে আপনার API key যোগ করুন:

   MAPS3D_API_KEY=YOUR_API_KEY_HERE
   

   মনে রাখবেন: Android-এর জন্য Maps 3D SDK-এর সাথে ব্যবহার করার জন্য আপনি যে API কী কনফিগার করেছেন, সেটি দিয়ে YOUR_API_KEY_HERE পরিবর্তন করতে ভুলবেন না।

2. local.defaults.properties ফাইল তৈরি করুন: - অ্যাপ মডিউল রুট ডিরেক্টরিতে, local.defaults.properties নামে একটি নতুন ফাইল তৈরি করুন। - ফাইলে একটি ডিফল্ট বা প্লেসহোল্ডার API কী যোগ করুন। এই ফাইলটি ভার্সন কন্ট্রোলে চেক করা যেতে পারে:

   MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER
   

পার্ট ৩: আপনার AndroidManifest.xml ফাইল আপডেট করা

1. app/src/main/AndroidManifest.xml ফাইলটি খুলুন।

2. <application> ট্যাগের ভিতরে, <activity> ট্যাগের আগে, আপনার API key ঘোষণা করতে নিম্নলিখিত <meta-data> এলিমেন্ট যোগ করুন:

   <application
       ...>
   
       <meta-data
           android:name="com.google.android.geo.maps3d.API_KEY"
           android:value="${MAPS3D_API_KEY}" />
   
       <activity
           ...>
       </activity>
   </application>
   

   বিল্ড প্রসেস চলাকালীন, Secrets Gradle প্লাগ-ইন আপনার secrets.properties ফাইল থেকে কী দিয়ে ${MAPS3D_API_KEY} প্লেসহোল্ডার পরিবর্তন করবে।

প্রোগ্র্যামাটিক ভিউ ইনিশিয়ালাইজেশন (ঐচ্ছিক)

আপনি যদি XML লেআউটের পরিবর্তে প্রোগ্রাম্যাটিকভাবে আপনার ম্যাপ ভিউ শুরু করতে চান, তাহলে Map3DInitConfig ব্যবহার করুন।

import com.google.android.gms.maps3d.Map3DInitConfig
import com.google.android.gms.maps3d.Map3DView
import com.google.android.gms.maps3d.model.Map3DMode

// Set configuration options using the factory method
val config = Map3DInitConfig.create(
    mapMode = Map3DMode.HYBRID,
    centerLat = 38.544012,
    centerLng = -107.670428
)

val map3DView = Map3DView(context, config)

পরবর্তী ধাপ

এখন আপনার কাছে Google Cloud প্রোজেক্ট, API কী এবং Android-এর জন্য Maps 3D SDK-এর সাথে ব্যবহার করার জন্য সেট-আপ করা Android Studio প্রোজেক্ট আছে, আপনি আপনার অ্যাপে 3D ম্যাপ যোগ করতে পারবেন।