Android-এর জন্য Maps SDK সেট-আপ করা

Android-এর জন্য Maps SDK ব্যবহার শুরু করার জন্য প্রয়োজনীয় ধাপগুলি এই ডকুমেন্টে বর্ণনা করা হয়েছে।

পূর্বশর্ত

এই পদ্ধতিতে, Google Cloud অ্যাকাউন্ট এবং বিলিং চালু করা আছে এমন Google Cloud প্রোজেক্ট সেট-আপ করার ব্যাপারে আপনাকে গাইড করা হয়েছে। এছাড়াও, Maps SDK for Android ব্যবহার করার জন্য আপনাকে কীভাবে চার্জ করা হয় সেই সম্পর্কেও আপনার জানা উচিত।

1. Android-এর জন্য Maps SDK ব্যবহার ও বিলিং-এ ব্যবহারের জন্য বিলিং ও খরচ পর্যালোচনা করুন।

2. আপনার কাছে একটি Google Cloud অ্যাকাউন্ট আছে কিনা তা যাচাই করুন।

   Google Cloud কনসোলে সাইন-ইন করুন
   মনে রাখবেন: আপনি নতুন ব্যবহারকারী হলে এবং আপনার Google Cloud অ্যাকাউন্ট না থাকলে, অর্থাৎ আপনি কনসোলে সাইন-ইন করতে না পারলে, Google Maps Platform ব্যবহার শুরু করা দেখুন।

3. বিলিং চালু করা আছে এমন একটি Google Cloud প্রোজেক্ট আপনার আছে কিনা তা যাচাই করুন।

   বিলিং পৃষ্ঠায় যান
   মনে রাখবেন: আপনি নতুন ব্যবহারকারী হলে এবং আপনার কোনও Google Cloud প্রোজেক্ট না থাকলে, Google Maps Platform ব্যবহার শুরু করা দেখুন।
1. বিলিং পৃষ্ঠা খুলতে আপনার প্রোজেক্ট বেছে নিন।

2. বিলিং পৃষ্ঠায়:

   • বেছে নেওয়া প্রোজেক্টের জন্য বিলিং আগে থেকেই চালু করা থাকলে এবং আপনার কাছে শুধুমাত্র একটি বিলিং অ্যাকাউন্ট থাকলে, বিলিং পৃষ্ঠা খুলে যাবে।
   • আপনার একাধিক বিলিং অ্যাকাউন্ট থাকলে, প্রোজেক্টের সাথে যুক্ত বিলিং অ্যাকাউন্ট সম্পর্কে বিবরণ দেখতে লিঙ্ক করা বিলিং অ্যাকাউন্টে যান বিকল্প বেছে নিন।
   • বিলিং অ্যাকাউন্ট থাকলে কিন্তু প্রোজেক্টের সাথে যুক্ত না থাকলে, আপনাকে প্রোজেক্টের সাথে বিলিং অ্যাকাউন্ট লিঙ্ক করতে বলা হবে।
   • কোনও বিলিং অ্যাকাউন্ট না থাকলে অথবা আপনি নতুন বিলিং অ্যাকাউন্ট তৈরি করতে চাইলে, নতুন বিলিং অ্যাকাউন্ট তৈরি করতে বিলিং অ্যাকাউন্ট ম্যানেজ করুন বিকল্প বেছে নিন। আরও তথ্যের জন্য, নতুন সেল্ফ-সার্ভ ক্লাউড বিলিং অ্যাকাউন্ট তৈরি করুন দেখুন।

SDK চালু করুন

Maps SDK for Android ব্যবহার করার আগে, আপনার Google Cloud প্রোজেক্টে এটি চালু করতে, আপনাকে অবশ্যই Google Cloud কনসোল বা gcloud কমান্ড ব্যবহার করতে হবে।

মনে রাখবেন: আপনি কোনও SDK চালু করার পরে, সেটিতে অনুরোধ করার আগে আপনাকে কয়েক মিনিট অপেক্ষা করতে হতে পারে।

SDK চালু করতে:

কনসোল

1. Google Cloud কনসোলে প্রোডাক্ট পৃষ্ঠা খুলুন:

   Android-এর জন্য Maps SDK চালু করুন

2. চালু করুন বোতামে ক্লিক করুন।

   মনে রাখবেন: Android-এর জন্য Maps SDK আগে থেকেই চালু করা থাকলে, আপনি চালু করুন বোতামের পরিবর্তে ম্যানেজ করুন বোতাম দেখতে পাবেন।

gcloud

gcloud services enable \
    --project "PROJECT" \
    "maps-android-backend.googleapis.com"

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

• gcloud services enable
• gcloud services disable

API key কনফিগার করুন

Google Maps Platform প্রোডাক্টগুলি অননুমোদিত ব্যবহার থেকে সুরক্ষিত থাকে কারণ API কলে একটি API কী অন্তর্ভুক্ত করতে হয়।

Android-এর জন্য Maps SDK-এর সাথে ব্যবহার করার জন্য API কী পান

API কী হল একটি অনন্য আলফানিউমেরিক স্ট্রিং যা আপনার ক্লাউড বিলিং অ্যাকাউন্ট এবং Google Cloud প্রোজেক্টকে আপনার অ্যাপ্লিকেশন Google Maps Platform API বা SDK-তে যে অনুরোধ করে তার সাথে যুক্ত করে। নতুন কী তৈরি করতে বা আগে থেকে আছে এমন কী-তে API বা SDK যোগ করতে, এইসব নির্দেশাবলী অনুসরণ করুন।

কনসোল

1. Google Maps Platform > কী ও ক্রেডেনশিয়াল পৃষ্ঠায় যান।

   'কী' ও ক্রেডেনশিয়াল পৃষ্ঠায় যান

2. প্রম্পট করা হলে, আপনার প্রোজেক্ট বেছে নিন।

3. নিম্নলিখিতগুলির মধ্যে থেকে যেকোনও একটি করুন:

   • নতুন 'কী' তৈরি করুন:

     1. ক্রেডেনশিয়াল তৈরি করুন > API key বিকল্পে ক্লিক করুন।
     2. API key তৈরি করুন প্যানেলে, API সংক্রান্ত বিধিনিষেধ বেছে নিন তালিকা খুলুন।
     3. এই 'কী'-এর প্রয়োজন নেই এমন যেকোনও API মুছে দিন এবং নিশ্চিত করুন যে Android-এর জন্য Maps SDK বেছে নেওয়া আছে।
     4. তৈরি করুন বিকল্পে ক্লিক করুন। প্যানেলে আপনার নতুন API কী দেখা যাবে।

   • আগে থেকে থাকা 'কী' ব্যবহার করুন:

     1. 'কী'-এর নামে ক্লিক করুন।
     2. API সংক্রান্ত বিধিনিষেধ বেছে নিন তালিকা থেকে, Maps SDK for Android বেছে নিন।
     3. সেভ করুন বিকল্পে ক্লিক করুন।

   এখানে কোনও API বেছে নিলে তা চালু হয় না। Android-এর জন্য Maps SDK API লাইব্রেরি পৃষ্ঠায় চালু করা আছে কিনা তা ভাল করে দেখে নিন।

4. পরে কী স্ট্রিং দেখতে, কী ও ক্রেডেনশিয়াল পৃষ্ঠায় যান এবং কী-এর জন্য কী দেখুন বিকল্পে ক্লিক করুন।

কনসোলটি যদি এইসব ধাপের থেকে আলাদা দেখায়, তাহলে Google Cloud ডকুমেন্টেশনে API কী তৈরি করুন এবং API সংক্রান্ত বিধিনিষেধ যোগ করুন বিকল্প দেখুন।

gcloud

নিচের কমান্ডে PROJECT_ID-এর জায়গায় আপনার প্রোজেক্ট আইডি লিখুন।

• নতুন 'কী' তৈরি করুন: নিম্নলিখিত কমান্ড রান করুন এবং DISPLAY_NAME-এর জায়গায় 'কী'-এর নাম লিখুন।

  gcloud services api-keys create \
      --project="PROJECT_ID" \
      --display-name="DISPLAY_NAME" \
      --api-target=service=maps-android-backend.googleapis.com

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

  • gcloud services api-keys create

• আগে থেকে থাকা 'কী' ব্যবহার করুন: নিম্নলিখিত কমান্ড রান করুন এবং KEY_ID-এর জায়গায় 'কী'-এর আইডি লিখুন। --append ফ্ল্যাগ সেইসব API রাখে যেগুলি 'কী' আগে থেকেই অনুমোদন করে। এটি না থাকলে, কমান্ডটি সেগুলি পরিবর্তন করে।

  gcloud services api-keys update KEY_ID \
      --project="PROJECT_ID" \
      --append \
      --api-target=service=maps-android-backend.googleapis.com

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

  • gcloud services api-keys update
  • gcloud services api-keys list

  'কী' আইডি হল 'কী' স্ট্রিং বা ডিসপ্লে নাম নয়। এটি খুঁজতে, gcloud services api-keys list --project="PROJECT_ID" রান করুন। আইডি হল name ফিল্ডের শেষ অংশ: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID।

কী স্ট্রিং দেখতে, gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID" রান করুন।

API key সংক্রান্ত বিধিনিষেধ প্রয়োগ করুন

সতর্কতা: Maps SDK for Android সহ যেকোনও Google Maps Platform পরিষেবার জন্য অনুরোধ করতে সীমাবদ্ধতাহীন API কী ব্যবহার করা যেতে পারে। সীমাবদ্ধতাহীন API কী-এর অপব্যবহারের কারণে হওয়া চার্জের জন্য আপনি আর্থিকভাবে দায়ী থাকবেন।

Google আপনাকে API কী-এর ব্যবহার শুধুমাত্র সেইসব API এবং অ্যাপে সীমাবদ্ধ করার জন্য সুপারিশ করে যেগুলির জন্য সেগুলি প্রয়োজন। API কী সীমাবদ্ধ করলে, আপনার অ্যাপ্লিকেশনকে অযাচিত অনুরোধ থেকে রক্ষা করে সুরক্ষা প্রদান করে। API কী দুই ধরনের বিধিনিষেধ সমর্থন করে:

• API সংক্রান্ত বিধিনিষেধ API কী ব্যবহার করে কোন SDK এবং API কল করা যাবে তা নির্দিষ্ট করুন। আপনি কোনও 'কী' তৈরি করলে, কনসোল এবং gcloud CLI-এর জন্য অন্তত একটি API সংক্রান্ত বিধিনিষেধ প্রয়োজন।
• অ্যাপ্লিকেশন সংক্রান্ত বিধিনিষেধ কোন কোন ওয়েবসাইট, IP অ্যাড্রেস বা অ্যাপ API key ব্যবহার করতে পারবে তা নির্দিষ্ট করে।

বিধিনিষেধ প্রয়োগ করার ব্যাপারে আরও তথ্য পেতে, আপনার API কী সীমিত করুন দেখুন।

এর পরে কী করতে হবে

এখন আপনি Android-এর জন্য Maps SDK চালু করেছেন এবং API কী কনফিগার করেছেন, Android Studio প্রোজেক্ট সেট-আপ করুন দেখুন, কীভাবে Android Studio কনফিগার করতে হয় এবং কীভাবে আপনার অ্যাপে API কী পাস করতে হয় তা আরও জানতে।