একটি Google ক্লাউড কনসোল প্রকল্প কনফিগার করুন

অ্যান্ড্রয়েডের জন্য ড্রাইভার এসডিকে ব্যবহার করতে একটি গুগল ক্লাউড কনসোল প্রজেক্ট সেট আপ ও কনফিগার করার জন্য, এই ধাপগুলো অনুসরণ করুন।

  1. আপনার মোবাইল অ্যাপ প্রজেক্টটি সেট আপ করুন
  2. আপনার অ্যাপে ড্রাইভার এসডিকে যোগ করুন
  3. আপনার অ্যাপে এপিআই কী (API key) যোগ করুন
  4. আপনার অ্যাপে প্রয়োজনীয় অ্যাট্রিবিউশনগুলো অন্তর্ভুক্ত করুন

প্রতিটি ধাপ সম্পর্কে আরও বিস্তারিত জানতে নিম্নলিখিত বিভাগগুলি দেখুন।

আপনার মোবাইল অ্যাপ প্রজেক্ট সেট আপ করুন

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

আপনার মোবাইল অ্যাপ প্রজেক্টটি কনফিগার করতে, এই ধাপগুলো অনুসরণ করুন:

  1. আপনার যদি কোনো গুগল ক্লাউড কনসোল ডেভেলপমেন্ট প্রজেক্ট এবং আপনার মোবিলিটি প্রজেক্টের জন্য একটি এপিআই কী না থাকে, তাহলে আপনাকে একটি তৈরি করে নিতে হবে। আরও তথ্যের জন্য, আপনার ফ্লিট ইঞ্জিন প্রজেক্ট তৈরি করুন দেখুন।
  2. গুগল ক্লাউড কনসোলে, সেই একই গুগল ক্লাউড কনসোল প্রজেক্ট এবং এপিআই কী নির্বাচন করুন যা আপনি ফ্লিট ইঞ্জিনের জন্য ব্যবহার করছেন।
  3. API ও পরিষেবা নির্বাচন করুন এবং Android-এর জন্য Maps SDK অনুসন্ধান করে সক্রিয় করুন।

আপনার অ্যাপে ড্রাইভার SDK যোগ করুন

ড্রাইভার এসডিকে-টি গুগল ম্যাভেন রিপোজিটরি থেকে পাওয়া যায়। এই রিপোজিটরিতে এসডিকে-র প্রজেক্ট অবজেক্ট মডেল (.pom) ফাইল এবং জাভাডকস অন্তর্ভুক্ত রয়েছে।

আপনার অ্যাপে ড্রাইভার SDK যোগ করতে, আপনার Gradle বা Maven কনফিগারেশনে ড্রাইভার SDK এবং নেভিগেশন SDK ডিপেন্ডেন্সিগুলো যুক্ত করুন।

নিচের উদাহরণে, VERSION_NUMBER জায়গায় ড্রাইভার SDK-এর নির্বাচিত সংস্করণটি বসান।

গ্রেডল

আপনার build.gradle ফাইলে নিম্নলিখিতটি যোগ করুন:

dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-driver:VERSION_NUMBER'
implementation 'com.google.android.libraries.navigation:navigation:5.0.0'
}

ম্যাভেন

আপনার pom.xml এ নিম্নলিখিতটি যোগ করুন:

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation.driver</groupId>
    <artifactId>transportation-driver</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.libraries.navigation</groupId>
    <artifactId>navigation</artifactId>
    <version>5.0.0</version>
  </dependency>
</dependencies>

আপনার অ্যাপে এপিআই কী যোগ করুন

আপনার অ্যাপে ড্রাইভার এসডিকে যোগ করার পর, এপিআই কী যোগ করুন। আপনার ডেভেলপমেন্ট প্রজেক্ট সেট আপ করার সময় প্রাপ্ত প্রজেক্ট এপিআই কী-টিই আপনাকে অবশ্যই ব্যবহার করতে হবে। আরও বিস্তারিত জানতে, আপনার মোবাইল অ্যাপ প্রজেক্ট সেট আপ করুন দেখুন।

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

এই কাজটি সহজ করার জন্য, আপনি অ্যান্ড্রয়েডের জন্য গিটহাব ডকুমেন্টেশনে থাকা Secrets Gradle Plugin ব্যবহার করতে পারেন।

প্লাগইনটি ইনস্টল করতে এবং আপনার এপিআই কী সংরক্ষণ করতে, এই ধাপগুলো অনুসরণ করুন:

  1. আপনার রুট-লেভেলের 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")
        }
    }
    
  2. আপনার অ্যাপ-লেভেলের build.gradle ফাইলটি খুলুন এবং plugins এলিমেন্টে নিম্নলিখিত কোডটি যোগ করুন।

    গ্রুভি

    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
    

    কোটলিন

    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
    
  3. আপনি যদি অ্যান্ড্রয়েড স্টুডিও ব্যবহার করেন, তাহলে আপনার প্রজেক্টটি গ্রেডলের সাথে সিঙ্ক করুন। বিস্তারিত জানতে, ‘আপনার প্রজেক্ট গ্রেডলের সাথে সিঙ্ক করুন’ দেখুন।

  4. আপনার প্রজেক্ট লেভেল ডিরেক্টরিতে থাকা local.properties ফাইলটি খুলুন এবং নিচের কোডটি যোগ করুন। YOUR_API_KEY এর জায়গায় আপনার API কী বসান।

    MAPS_API_KEY= YOUR_API_KEY

  5. আপনার 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.driverapidemo" >
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <uses-permission android:name="android.permission.ACCESS_COARSE_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>

আপনার অ্যাপে প্রয়োজনীয় অ্যাট্রিবিউশন অন্তর্ভুক্ত করুন।

আপনি যদি আপনার অ্যাপে ড্রাইভার এসডিকে (Driver SDK) ব্যবহার করেন, তাহলে আপনাকে অবশ্যই আপনার অ্যাপের আইনি বিজ্ঞপ্তি (legal notices) অংশের অংশ হিসেবে অ্যাট্রিবিউশন টেক্সট (attribution text) এবং ওপেন সোর্স লাইসেন্স (open source licenses) অন্তর্ভুক্ত করতে হবে। অ্যাট্রিবিউশনগুলোকে একটি স্বতন্ত্র মেনু আইটেম হিসেবে অথবা ' অ্যাবাউট' (About) মেনু আইটেমের অংশ হিসেবে অন্তর্ভুক্ত করাই সর্বোত্তম।

আপনি আনআর্কাইভ করা AAR ফাইলের মধ্যে থাকা 'third_party_licenses.txt' ফাইলে লাইসেন্সের তথ্য খুঁজে পাবেন।

কীভাবে ওপেন সোর্স নোটিশ অন্তর্ভুক্ত করতে হয়, তা জানতে "ওপেন সোর্স নোটিশ অন্তর্ভুক্ত করুন" অংশটি দেখুন।

এরপর কী?

নির্ভরতা ঘোষণা করুন