সেটআপ

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

একটি Google ক্লাউড প্রোজেক্ট এবং API কী সেট আপ করুন

অ্যান্ড্রয়েডের জন্য ম্যাপস 3D SDK দিয়ে তৈরি করা শুরু করার আগে, আপনাকে নিম্নলিখিত পদক্ষেপগুলি সম্পন্ন করে অ্যান্ড্রয়েডের জন্য ম্যাপস 3D SDK এর সাথে ব্যবহারের জন্য একটি Google ক্লাউড প্রকল্প এবং API কী সেট আপ করতে হবে:

gcloud projects create "PROJECT"

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"

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

SDK সক্ষম করতে, Google ক্লাউড কনসোলে Android এর জন্য Maps 3D SDK পৃষ্ঠাটি দেখুন। এই পদক্ষেপগুলি সম্পূর্ণ করার বিষয়ে আরও তথ্যের জন্য, Google Maps প্ল্যাটফর্ম দিয়ে শুরু করা দেখুন।

একটি অ্যান্ড্রয়েড স্টুডিও প্রকল্প সেট আপ করুন

এই বিভাগটি ব্যাখ্যা করে যে কীভাবে Android এর জন্য Maps 3D SDK ব্যবহার করে একটি Android Studio প্রকল্প তৈরি এবং কনফিগার করতে হয়।

পর্ব ১: আপনার প্রকল্প এবং গ্রেডল কনফিগারেশন সেট আপ করুন

1. খালি দৃশ্য কার্যকলাপ টেমপ্লেট ব্যবহার করে একটি নতুন অ্যান্ড্রয়েড স্টুডিও প্রকল্প তৈরি করুন।

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

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

   secrets.properties
   

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

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

   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 ডিরেক্টরিতে অবস্থিত। - সংস্করণ বিভাগে, SDK এবং Secrets Gradle প্লাগইনের জন্য সংস্করণগুলি যুক্ত করুন:

   maps3dSdk = "0.0.1" # Update this value to match the SDK version to include
   secretsGradlePlugin = "2.0.1"
   

   -   In the library section, add the SDK library:
   

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

   -   In the plugin section, add the Secrets Gradle plugin:
   

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

5. module-level app/build.gradle.kts ফাইলটি আপডেট করুন: - module-level 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
   }
   

   -   In the `dependencies` block, add the SDK:
   

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

   -   At the end of the file, outside of the `android` and `dependencies`
       blocks, add the secrets configuration:
   

   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 কী যোগ করুন

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

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

   MAPS3D_API_KEY=YOUR_API_KEY_HERE
   ``` Note: Make sure you
       replace `YOUR_API_KEY_HERE` with the API key that you configured for use
   with the Maps 3D SDK for Android.
   

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

   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 Plugin আপনার secrets.properties ফাইলের কী দিয়ে ${MAPS3D_API_KEY} প্লেসহোল্ডার প্রতিস্থাপন করবে।

পরবর্তী পদক্ষেপ

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