এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

সেটআপ

এই পণ্য বা ফিচারটি পরীক্ষামূলক (প্রি-জিএ)। প্রি-জিএ পণ্য এবং ফিচারগুলিতে সীমিত সাপোর্ট থাকতে পারে, এবং এতে করা পরিবর্তনগুলি অন্যান্য প্রি-জিএ ভার্সনের সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রি-জিএ অফারিংগুলি গুগল ম্যাপস প্ল্যাটফর্ম সার্ভিস স্পেসিফিক টার্মস (Google Maps Platform Service Specific Terms) দ্বারা নিয়ন্ত্রিত। আরও তথ্যের জন্য, লঞ্চ স্টেজের বিবরণ দেখুন।

অ্যান্ড্রয়েডের জন্য ম্যাপস 3D SDK ব্যবহার করে অ্যাপ তৈরি শুরু করার জন্য আপনাকে কী কী করতে হবে, তা এই পৃষ্ঠায় বর্ণনা করা হয়েছে। সেটআপ প্রক্রিয়ার মধ্যে রয়েছে SDK ব্যবহারের জন্য একটি গুগল ক্লাউড প্রজেক্ট ও এপিআই কনফিগার করা এবং তারপর একটি অ্যান্ড্রয়েড স্টুডিও প্রজেক্ট তৈরি করা। আপনার অ্যাপে প্রথম 3D ম্যাপ যোগ করার আগে এই ধাপগুলো সম্পন্ন করুন।

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

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

ধাপ ১

কনসোল

গুগল ক্লাউড কনসোলের প্রজেক্ট সিলেক্টর পেজে, একটি নতুন ক্লাউড প্রজেক্ট তৈরি করা শুরু করতে 'Create Project'-এ ক্লিক করুন।
প্রজেক্ট সিলেক্টর পেজে যান
আপনার ক্লাউড প্রজেক্টের জন্য বিলিং চালু আছে কিনা তা নিশ্চিত করুন। আপনার প্রজেক্টের জন্য বিলিং চালু আছে কিনা তা যাচাই করুন ।
গুগল ক্লাউড $0.00 চার্জের একটি ট্রায়াল অফার করে। এই ট্রায়ালটি ৯০ দিন শেষে অথবা অ্যাকাউন্টে $300 মূল্যের চার্জ জমা হওয়ার পর, দুটির মধ্যে যেটি আগে ঘটবে, তখন শেষ হয়ে যাবে। যেকোনো সময় এটি বাতিল করা যাবে। আরও তথ্যের জন্য, বিলিং অ্যাকাউন্ট ক্রেডিট এবং বিলিং দেখুন।

ক্লাউড এসডিকে

gcloud projects create "PROJECT"

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

gcloud projects create

ধাপ ২

গুগল ম্যাপস প্ল্যাটফর্ম ব্যবহার করতে হলে, আপনার প্রোজেক্টে যে এপিআই বা এসডিকেগুলো ব্যবহার করার পরিকল্পনা করছেন, সেগুলো অবশ্যই সক্রিয় করতে হবে।

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

এক বা একাধিক এপিআই বা এসডিকে সক্রিয় করতে:

কনসোল

ক্লাউড কনসোলের ম্যাপস এপিআই লাইব্রেরি পৃষ্ঠায় গিয়ে আপনি গুগল ম্যাপস প্ল্যাটফর্ম এপিআই এবং এসডিকেগুলো দেখতে পারেন যা আপনি সক্রিয় করতে পারবেন:
ম্যাপস এপিআই লাইব্রেরি পৃষ্ঠায় যান
যে API বা SDK-টি সক্রিয় করতে চান, সেটিতে ক্লিক করুন।
- যদি বাটনটিতে ENABLE লেখা থাকে, তাহলে API বা SDK চালু করতে বাটনটিতে ক্লিক করুন।
- যদি বাটনটিতে ‘MANAGE’ লেখা থাকে, তাহলে API বা SDK ইতিমধ্যেই সক্রিয় করা আছে এবং আপনাকে আর কিছু করতে হবে না।
- যেকোনো একটি বোতামে ক্লিক করলে API বা SDK-এর ড্যাশবোর্ড প্রদর্শিত হবে। (এই প্রজেক্ট থেকে API বা SDK সরিয়ে ফেলতে DISABLE বোতামটি ক্লিক করুন।)

ক্লাউড এসডিকে

নিম্নলিখিত কমান্ডটি Maps, Routes, এবং Places 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"

এনভায়রনমেন্ট এপিআইগুলো সক্রিয় করতে এই কমান্ডটি ব্যবহার করুন:

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

ধাপ ৩

এই ধাপে শুধুমাত্র এপিআই কী (API Key) তৈরির প্রক্রিয়াটি বর্ণনা করা হয়েছে। আপনি যদি প্রোডাকশনে আপনার এপিআই কী ব্যবহার করেন, তবে আমরা আপনাকে এটি সীমাবদ্ধ করার জন্য দৃঢ়ভাবে সুপারিশ করছি। আপনি পণ্য-নির্দিষ্ট 'এপিআই কী ব্যবহার' (Using API Keys) পৃষ্ঠায় আরও তথ্য পেতে পারেন।

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

একটি এপিআই কী তৈরি করতে:

কনসোল

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

ক্লাউড এসডিকে

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

gcloud services api-keys create

এসডিকে সক্রিয় করতে, গুগল ক্লাউড কনসোলে থাকা ‘ম্যাপস ৩ডি এসডিকে ফর অ্যান্ড্রয়েড’ পৃষ্ঠাটি দেখুন। এই ধাপগুলো সম্পন্ন করার বিষয়ে আরও তথ্যের জন্য, ‘গুগল ম্যাপস প্ল্যাটফর্ম দিয়ে শুরু করা’ দেখুন।

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

এই অংশে অ্যান্ড্রয়েডের জন্য ম্যাপস ৩ডি এসডিকে (Maps 3D SDK for Android) ব্যবহারের উপযোগী একটি অ্যান্ড্রয়েড স্টুডিও প্রজেক্ট কীভাবে তৈরি ও কনফিগার করতে হয়, তা ব্যাখ্যা করা হয়েছে।

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

Empty Views Activity টেমপ্লেট ব্যবহার করে একটি নতুন অ্যান্ড্রয়েড স্টুডিও প্রজেক্ট তৈরি করুন।
আপনি যদি সোর্স কন্ট্রোলের জন্য গিট ব্যবহার করেন, তাহলে আপনার সিক্রেটস ফাইলটি যাতে ভার্সন কন্ট্রোলে কমিট না হয়, সেজন্য প্রোজেক্টের .gitignore ফাইলটি পরিবর্তন করুন:
- আপনার প্রোজেক্টের রুট ডিরেক্টরিতে .gitignore ফাইলটি খুলুন।
- নিম্নলিখিত লাইনটি যোগ করুন:
```
secrets.properties
```
প্রজেক্ট-স্তরের 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
}
```
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 = "0.2.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" }
```

মডিউল-স্তরের 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 ব্লকে SDK-টি যোগ করুন:

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

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

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

একটি secrets.properties ফাইল তৈরি করুন:
- অ্যাপ মডিউলের রুট ডিরেক্টরিতে (সাধারণত app ডিরেক্টরিতে), secrets.properties নামে একটি নতুন ফাইল তৈরি করুন।
- ফাইলে আপনার API কী যোগ করুন:
```
MAPS3D_API_KEY=YOUR_API_KEY_HERE
```
দ্রষ্টব্য: নিশ্চিত করুন যে আপনি YOUR_API_KEY_HERE জায়গায় সেই API কী-টি বসিয়েছেন যা আপনি Maps 3D SDK for Android-এর সাথে ব্যবহারের জন্য কনফিগার করেছেন।
একটি local.defaults.properties ফাইল তৈরি করুন: - অ্যাপ মডিউলের রুট ডিরেক্টরিতে, secrets.properties নামে একটি নতুন ফাইল তৈরি করুন। - ফাইলটিতে একটি ডিফল্ট বা প্লেসহোল্ডার API কী যোগ করুন। এই ফাইলটি ভার্সন কন্ট্রোলে চেক ইন করা যেতে পারে:
```
MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER
```

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

app/src/main/AndroidManifest.xml ফাইলটি খুলুন।
<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 ফাইল থেকে পাওয়া কী (key) দিয়ে ${MAPS3D_API_KEY} প্লেসহোল্ডারটি প্রতিস্থাপন করবে।

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

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

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

ধাপ ১

কনসোল

ক্লাউড এসডিকে

ধাপ ২

কনসোল

ক্লাউড এসডিকে

ধাপ ৩

কনসোল

ক্লাউড এসডিকে

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

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

পর্ব ২: আপনার প্রজেক্টে আপনার এপিআই কী (API key) যোগ করুন

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

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

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