অ্যান্ড্রয়েডের জন্য কনজিউমার এসডিকে ব্যবহার করতে একটি গুগল ক্লাউড কনসোল সেট আপ ও কনফিগার করার জন্য, এই ধাপগুলো অনুসরণ করুন।
- আপনার উন্নয়ন প্রকল্পটি স্থাপন করুন ।
- আপনার অ্যাপে কনজিউমার এসডিকে যোগ করুন ।
- আপনার অ্যাপে এপিআই কী (API key) যোগ করুন ।
- আপনার অ্যাপে প্রয়োজনীয় অ্যাট্রিবিউশনগুলো অন্তর্ভুক্ত করুন ।
প্রতিটি ধাপ সম্পর্কে আরও বিস্তারিত জানতে নিম্নলিখিত বিভাগগুলি দেখুন।
আপনার উন্নয়ন প্রকল্প সেট আপ করুন
আপনার যদি কোনো গুগল ক্লাউড কনসোল ডেভেলপমেন্ট প্রজেক্ট এবং আপনার মোবিলিটি প্রজেক্টের জন্য একটি এপিআই কী না থাকে, তাহলে আপনাকে একটি তৈরি করে নিতে হবে। বিস্তারিত জানতে, ফ্লিট ইঞ্জিন গাইডের ‘আপনার প্রজেক্ট তৈরি করুন’ অংশটি দেখুন।
কনজিউমার এসডিকে-এর জন্য আপনার ডেভেলপমেন্ট প্রজেক্ট নির্বাচন করার সময়, সেই একই গুগল ক্লাউড কনসোল প্রজেক্ট এবং এপিআই কী নির্বাচন করুন যা আপনি ফ্লিট ইঞ্জিনের জন্য ব্যবহার করছেন।
আপনার অ্যাপে কনজিউমার এসডিকে যোগ করুন
কনজিউমার এসডিকে গুগল মেভেন রিপোজিটরি থেকে পাওয়া যায়। এই রিপোজিটরিতে এসডিকে-এর প্রজেক্ট অবজেক্ট মডেল (.pom) ফাইল এবং জাভাডকস অন্তর্ভুক্ত রয়েছে। আপনার অ্যাপে কনজিউমার এসডিকে যোগ করতে, আপনার গ্রেডল বা মেভেন কনফিগারেশনে কনজিউমার এসডিকে এবং ম্যাপস এসডিকে ডিপেন্ডেন্সিগুলো যুক্ত করুন।
নিম্নলিখিত উদাহরণগুলিতে, VERSION_NUMBER পরিবর্তে কনজিউমার SDK-এর প্রয়োজনীয় সংস্করণটি বসান:
গ্রেডল
আপনার build.gradle ফাইলে নিম্নলিখিতটি যোগ করুন:
dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER'
implementation "com.google.android.gms:play-services-maps:18.1.0"
}
ম্যাভেন
আপনার pom.xml এ নিম্নলিখিতটি যোগ করুন:
<dependencies>
...
<dependency>
<groupId>com.google.android.libraries.mapsplatform.transportation</groupId>
<artifactId>transportation-consumer</artifactId>
<version>VERSION_NUMBER</version>
</dependency>
<dependency>
<groupId>com.google.android.gms</groupId>
<artifactId>play-services-maps</artifactId>
<version>18.1.0</version>
</dependency>
</dependencies>
আপনার অ্যাপে এপিআই কী যোগ করুন
আপনার অ্যাপে কনজিউমার এসডিকে (Consumer SDK) যোগ করার পর, এপিআই কী (API key) যোগ করুন। আপনাকে অবশ্যই সেই প্রজেক্ট এপিআই কী ব্যবহার করতে হবে যা আপনি আপনার ডেভেলপমেন্ট প্রজেক্ট সেট আপ করার সময় পেয়েছিলেন। আরও বিস্তারিত জানতে, এই গাইডের ধাপ ৩-এ ‘আপনার ডেভেলপমেন্ট প্রজেক্ট সেট আপ করুন’ দেখুন।
এই বিভাগে বর্ণনা করা হয়েছে কীভাবে আপনার এপিআই কী সংরক্ষণ করবেন, যাতে আপনার অ্যাপ এটিকে আরও নিরাপদে ব্যবহার করতে পারে। এপিআই কী সুরক্ষার সর্বোত্তম অনুশীলন সম্পর্কে আরও তথ্যের জন্য, গুগল ম্যাপস প্ল্যাটফর্মের এপিআই সুরক্ষা সর্বোত্তম অনুশীলন বিষয়ক নিবন্ধটি দেখুন।
এই কাজটি সহজ করার জন্য, আপনি অ্যান্ড্রয়েডের জন্য গিটহাব ডকুমেন্টেশনে থাকা Secrets Gradle Plugin ব্যবহার করতে পারেন।
প্লাগইনটি ইনস্টল করতে এবং আপনার এপিআই কী সংরক্ষণ করতে:
আপনার রুট-লেভেলের
build.gradleফাইলটি খুলুন এবংbuildscriptঅধীনেdependenciesএলিমেন্টে নিম্নলিখিত কোডটি যোগ করুন।গ্রুভি
buildscript { dependencies { // ... classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0" } }কোটলিন
buildscript { dependencies { // ... classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0") } }আপনার অ্যাপ-লেভেলের
build.gradleফাইলটি খুলুন এবংpluginsএলিমেন্টে নিম্নলিখিত কোডটি যোগ করুন।গ্রুভি
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'কোটলিন
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")আপনি যদি অ্যান্ড্রয়েড স্টুডিও ব্যবহার করেন, তাহলে আপনার প্রজেক্টটি গ্রেডলের সাথে সিঙ্ক করুন। বিস্তারিত জানতে, অ্যান্ড্রয়েড ডকুমেন্টেশনে ‘Sync your project with Gradle’ অংশটি দেখুন।
আপনার প্রজেক্ট লেভেল ডিরেক্টরিতে থাকা
local.propertiesফাইলটি খুলুন এবং নিচের কোডটি যোগ করুন।YOUR_API_KEYএর জায়গায় আপনার API কী বসান।MAPS_API_KEY= YOUR_API_KEY
আপনার
AndroidManifest.xmlফাইলে,com.google.android.geo.API_KEYতে যান এবংandroid:valueঅ্যাট্রিবিউটটি নিম্নরূপভাবে আপডেট করুন:
<meta-data
android:name="com.google.android.geo.API_KEY"
android:value="${MAPS_API_KEY}" />
নিম্নলিখিত উদাহরণটি একটি নমুনা অ্যাপের সম্পূর্ণ ম্যানিফেস্ট দেখাচ্ছে:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.consumerapidemo">
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/_AppTheme">
<meta-data
android:name="com.google.android.geo.API_KEY"
android:value="${MAPS_API_KEY}" />
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
আপনার অ্যাপে প্রয়োজনীয় অ্যাট্রিবিউশন অন্তর্ভুক্ত করুন।
আপনি যদি আপনার অ্যাপে কনজিউমার এসডিকে (Consumer SDK) ব্যবহার করেন, তাহলে আপনাকে অবশ্যই আপনার অ্যাপের লিগ্যাল নোটিসেস (legal notices) বিভাগের অংশ হিসেবে অ্যাট্রিবিউশন টেক্সট (attribution text) এবং ওপেন সোর্স লাইসেন্স (open source licenses) অন্তর্ভুক্ত করতে হবে। অ্যাট্রিবিউশনগুলোকে একটি স্বতন্ত্র মেনু আইটেম হিসেবে অথবা অ্যাবাউট (About) মেনু আইটেমের অংশ হিসেবে অন্তর্ভুক্ত করাই সর্বোত্তম।
আপনি আনআর্কাইভ করা AAR ফাইলের মধ্যে থাকা 'third_party_licenses.txt' ফাইলে লাইসেন্সের তথ্য খুঁজে পাবেন।
ওপেন সোর্স নোটিশ কীভাবে অন্তর্ভুক্ত করতে হয়, তা জানতে https://developers.google.com/android/guides/opensource দেখুন।