সেটআপ

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

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

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

ধাপ 1

কনসোল

  1. Google ক্লাউড কনসোলে, প্রকল্প নির্বাচক পৃষ্ঠায়, একটি নতুন ক্লাউড প্রকল্প তৈরি করা শুরু করতে প্রকল্প তৈরি করুন ক্লিক করুন৷

    প্রকল্প নির্বাচক পৃষ্ঠায় যান

  2. নিশ্চিত করুন যে আপনার ক্লাউড প্রকল্পের জন্য বিলিং সক্ষম করা আছে৷ আপনার প্রকল্পের জন্য বিলিং সক্ষম হয়েছে তা নিশ্চিত করুন ৷

    Google ক্লাউড একটি $0.00 চার্জ ট্রায়াল অফার করে৷ ট্রায়ালের মেয়াদ 90 দিনের শেষে বা অ্যাকাউন্ট $300 মূল্যের চার্জ জমা হওয়ার পরে, যেটি প্রথমে আসে। যেকোনো সময় বাতিল করুন। আরও তথ্যের জন্য, বিলিং অ্যাকাউন্ট ক্রেডিট এবং বিলিং দেখুন।

ক্লাউড SDK 

gcloud projects create "PROJECT"

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

ধাপ 2

Google মানচিত্র প্ল্যাটফর্ম ব্যবহার করার জন্য, আপনাকে অবশ্যই আপনার প্রকল্পের সাথে ব্যবহার করার পরিকল্পনা করছেন এমন API বা SDK সক্ষম করতে হবে৷

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

এক বা একাধিক API বা SDK সক্ষম করতে:

কনসোল

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

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

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

ক্লাউড SDK

নিম্নলিখিত কমান্ডটি সমস্ত মানচিত্র, রুট এবং স্থান API গুলিকে সক্ষম করে:

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 \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com"

ধাপ 3

এই ধাপটি শুধুমাত্র API কী তৈরির প্রক্রিয়ার মধ্য দিয়ে যায়। আপনি যদি উত্পাদনে আপনার API কী ব্যবহার করেন, আমরা দৃঢ়ভাবে সুপারিশ করি যে আপনি আপনার API কী সীমাবদ্ধ করুন৷ আপনি API কী ব্যবহার করে পণ্য-নির্দিষ্ট পৃষ্ঠায় আরও তথ্য পেতে পারেন।

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

একটি API কী তৈরি করতে:

কনসোল

  1. Google মানচিত্র প্ল্যাটফর্ম > শংসাপত্র পৃষ্ঠাতে যান।

    শংসাপত্র পৃষ্ঠায় যান

  2. শংসাপত্র পৃষ্ঠায়, শংসাপত্র তৈরি করুন > API কী ক্লিক করুন।
    API কী তৈরি ডায়ালগ আপনার নতুন তৈরি API কী প্রদর্শন করে।
  3. Close এ ক্লিক করুন।
    নতুন API কী API কী-এর অধীনে শংসাপত্র পৃষ্ঠায় তালিকাভুক্ত করা হয়েছে।
    (এটি উত্পাদনে ব্যবহার করার আগে API কী সীমাবদ্ধ করতে মনে রাখবেন।)

ক্লাউড SDK 

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

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

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

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

এই বিভাগটি ব্যাখ্যা করে কিভাবে Android এর জন্য Maps 3D SDK-এর সাথে ব্যবহারের জন্য একটি Android স্টুডিও প্রকল্প তৈরি এবং কনফিগার করতে হয়।

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

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

  2. আপনি যদি সোর্স কন্ট্রোলের জন্য গিট ব্যবহার করে থাকেন, তাহলে আপনার সিক্রেট ফাইলটিকে ভার্সন কন্ট্রোলে প্রতিশ্রুতিবদ্ধ হওয়া থেকে আটকাতে প্রকল্প .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. মডিউল-স্তরের app/build.gradle.kts ফাইলটি আপডেট করুন: - মডিউল-স্তরের build.gradle.kts ফাইলটি খুলুন, যা সাধারণত app ডিরেক্টরির মধ্যে থাকে। - ফাইলের শীর্ষে, plugins ব্লকে সিক্রেটস গ্রেডল প্লাগইন যোগ করুন: 

    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"
}

অংশ 2: আপনার প্রকল্পে আপনার 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

পার্ট 3: আপনার 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>

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

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

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