Roads API এর সাথে API কী ব্যবহার করুন

Google মানচিত্র প্ল্যাটফর্ম পণ্যগুলি যথাযথ প্রমাণীকরণ শংসাপত্র প্রদান করে এমন API কলগুলিকে সীমাবদ্ধ করে অননুমোদিত ব্যবহার থেকে সুরক্ষিত। এই শংসাপত্রগুলি একটি API কী আকারে রয়েছে - একটি অনন্য আলফানিউমেরিক স্ট্রিং যা আপনার প্রকল্পের সাথে এবং নির্দিষ্ট API বা SDK এর সাথে আপনার Google বিলিং অ্যাকাউন্টকে সংযুক্ত করে৷

এই গাইডটি দেখায় কিভাবে Google Maps প্ল্যাটফর্মের জন্য আপনার API কী তৈরি, সীমাবদ্ধ এবং ব্যবহার করতে হয়।

তুমি শুরু করার আগে

আপনি Roads API ব্যবহার শুরু করার আগে, আপনার একটি বিলিং অ্যাকাউন্ট এবং Roads API সক্ষম সহ একটি প্রকল্প প্রয়োজন৷ আরও জানতে, ক্লাউড কনসোলে সেট আপ দেখুন।

API কী তৈরি করা হচ্ছে

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

একটি API কী তৈরি করতে:

কনসোল

  1. Google মানচিত্র প্ল্যাটফর্ম > শংসাপত্র পৃষ্ঠাতে যান।

    শংসাপত্র পৃষ্ঠায় যান

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

ক্লাউড SDK

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

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

API কী সীমাবদ্ধ করা হচ্ছে

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

একটি API কী সীমাবদ্ধ করতে:

কনসোল

  1. Google মানচিত্র প্ল্যাটফর্ম > শংসাপত্র পৃষ্ঠাতে যান।

    শংসাপত্র পৃষ্ঠায় যান

  2. আপনি একটি সীমাবদ্ধতা সেট করতে চান এমন API কী নির্বাচন করুন। API কী প্রপার্টি পৃষ্ঠাটি প্রদর্শিত হবে।
  3. কী সীমাবদ্ধতার অধীনে, নিম্নলিখিত সীমাবদ্ধতাগুলি সেট করুন:
    • আবেদন বিধিনিষেধ:
      1. আপনার সরবরাহ করা ওয়েব সার্ভারের আইপি ঠিকানাগুলির তালিকা থেকে অনুরোধগুলি গ্রহণ করতে, অ্যাপ্লিকেশন বিধিনিষেধের তালিকা থেকে আইপি ঠিকানাগুলি (ওয়েব সার্ভার, ক্রোন কাজ, ইত্যাদি) নির্বাচন করুন। CIDR স্বরলিপি ব্যবহার করে এক বা একাধিক IPv4 বা IPv6 ঠিকানা, বা সাবনেট নির্দিষ্ট করুন৷ আইপি ঠিকানাগুলি অবশ্যই Google মানচিত্র প্ল্যাটফর্ম সার্ভারগুলি পর্যবেক্ষণ করে উৎস ঠিকানার সাথে মেলে। আপনি নেটওয়ার্ক ঠিকানা অনুবাদ (NAT) ব্যবহার করলে, এটি সাধারণত আপনার মেশিনের সর্বজনীন IP ঠিকানার সাথে মিলিত হবে।
    • API সীমাবদ্ধতা:
      1. সীমাবদ্ধ কী ক্লিক করুন।
      2. Select APIs ড্রপডাউন থেকে Roads API নির্বাচন করুন। যদি Roads API তালিকাভুক্ত না থাকে, তাহলে আপনাকে এটি সক্ষম করতে হবে।
  4. আপনার পরিবর্তনগুলি চূড়ান্ত করতে, সংরক্ষণ করুন ক্লিক করুন।

ক্লাউড SDK

বিদ্যমান কী তালিকাভুক্ত করুন।

gcloud services api-keys list --project="PROJECT"

বিদ্যমান কী-তে বিদ্যমান বিধিনিষেধ সাফ করুন।

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

বিদ্যমান কীতে নতুন সীমাবদ্ধতা সেট করুন।

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="roads.googleapis.com"
    --allowed-ips="IP_ADDRESS"

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

আপনার অনুরোধে API কী যোগ করা হচ্ছে

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

https://roads.googleapis.com/v1/snapToRoads?path=-35.27801,149.12958|-35.28032,149.12907|-35.28099,149.12929|-35.28144,149.12984|-35.28194,149.13003|-35.28282,149.12956|-35.28302,149.12881|-35.28473,149.12836 &interpolate=true &key= YOUR_API_KEY

একটি API কী ব্যবহার করে এমন অনুরোধের জন্য HTTPS প্রয়োজন।