Roads API সেট-আপ করা

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA)-এর ডেভেলপার

আপনার বিলিং ঠিকানা ইউরোপীয় অর্থনৈতিক অঞ্চলে হলে, ৮ জুলাই ২০২৫ থেকে কার্যকর, Google Maps Platform EEA পরিষেবার শর্তাবলী আপনার পরিষেবা ব্যবহারের ক্ষেত্রে প্রযোজ্য হবে। অঞ্চল অনুযায়ী কার্যকারিতা আলাদা হয়। আরও জানুন।

Roads API ব্যবহার শুরু করার জন্য আপনাকে যেসব ধাপ অনুসরণ করতে হবে তা এই ডকুমেন্টে বর্ণনা করা হয়েছে।

পূর্বশর্ত

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

1. Roads API ব্যবহার ও বিলিং-এ গিয়ে ব্যবহারের জন্য বিলিং ও খরচ পর্যালোচনা করুন।

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

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

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

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

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

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

API চালু করুন

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

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

API চালু করতে:

কনসোল

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

   Roads API চালু করুন

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

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

gcloud

gcloud services enable \
    --project "PROJECT" \
    "roads.googleapis.com"

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

• gcloud services enable
• gcloud services disable

Roads API-এর সাথে ব্যবহার করার জন্য API key পান

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

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

কনসোল

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

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

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

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

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

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

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

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

   এখানে API বেছে নিলে তা চালু হয় না। Roads API-এর 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=roads.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=roads.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 সংক্রান্ত অনুরোধ করা

রাস্তার জ্যামিতিতে নির্দিষ্ট পয়েন্ট স্ন্যাপ করে এমন JSON রেসপন্স ফেরত পেতে Roads API অনুরোধ করুন। প্রতিটি অনুরোধের সাথে আপনার API key-এর আলফানিউমেরিক স্ট্রিং অন্তর্ভুক্ত করতে হবে এবং API key অন্তর্ভুক্ত আছে এমন অনুরোধের জন্য HTTPS ব্যবহার করতে হবে।

1. কী-এর বর্ণসাংখ্যিক স্ট্রিং যোগ করতে নিচের কোডে API_KEY-এ ক্লিক করুন:

   curl -L -X GET 'https://roads.googleapis.com/v1/snapToRoads?path=-35.27801%2C149.12958%7C-35.28032%2C149.12907%7C-35.28099%2C149.12929%7C-35.28144%2C149.12984%7C-35.28194%2C149.13003%7C-35.28282%2C149.12956%7C-35.28302%2C149.12881%7C-35.28473%2C149.12836&interpolate=true&key=YOUR_API_KEY'
   

2. curl কমান্ড কপি করতে, , কোড স্যাম্পেলে কপি আইকনে ক্লিক করুন।
3. টার্মিনাল উইন্ডোতে কমান্ড পেস্ট করে রান করুন।

রেসপন্স হল এই ফর্মের একটি JSON অবজেক্ট:

{
  "snappedPoints": [
    {
      "location": {
        "latitude": -35.278004899930188,
        "longitude": 149.129531998742
      },
      "originalIndex": 0,
      "placeId": "ChIJr_xl0GdNFmsRsUtUbW7qABM"
    },
    {
      "location": {
        "latitude": -35.2784195,
        "longitude": 149.12946589999999
      },
      "placeId": "ChIJr_xl0GdNFmsRsUtUbW7qABM"
    },
    ...
    {
      "location": {
        "latitude": -35.284727644851415,
        "longitude": 149.12833853807396
      },
      "originalIndex": 7,
      "placeId": "ChIJtWxAZmpNFmsRlbUCkc6VtnA"
    }
  ]
}

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

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

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

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

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

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

আপনি এখন Roads API চালু করেছেন এবং সফলভাবে অনুরোধ করেছেন, API ব্যবহার করার ব্যাপারে আরও জানতে স্ন্যাপ টু রোড দেখুন।