সেটআপ

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 কী সেট-আপ করতে হবে। এর জন্য নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

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

gcloud projects create "PROJECT"

ধাপ ২: API বা SDK চালু করা

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

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

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

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"

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

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

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

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

SDK চালু করতে, Google Cloud কনসোলে 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.1"
   # 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 ডিরেক্টরির মধ্যে থাকে।
   • ফাইলের একদম উপরে, plugins ব্লকে Secrets Gradle প্লাগ-ইন যোগ করুন:

   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
   

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

   MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER
   

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

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

2. <application> ট্যাগের ভিতরে, <activity> ট্যাগের আগে, আপনার API কী ঘোষণা করতে নিম্নলিখিত <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 ম্যাপ যোগ করতে পারবেন।