দূরত্ব ম্যাট্রিক্স API সহ API কী ব্যবহার করুন

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

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

শুরু করার আগে

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

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

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

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

কনসোল

  1. গুগল ম্যাপস প্ল্যাটফর্ম > শংসাপত্র পৃষ্ঠায় যান।

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

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

ক্লাউড এসডিকে 

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

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

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

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

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

কনসোল

  1. গুগল ম্যাপস প্ল্যাটফর্ম > শংসাপত্র পৃষ্ঠায় যান।

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

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

ক্লাউড এসডিকে

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

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

বিদ্যমান কী-এর উপর বিদ্যমান সীমাবদ্ধতাগুলি সাফ করুন।

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

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

gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=distance-matrix-backend.googleapis.com
    --allowed-ips="IP_ADDRESS"

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

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

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

https://maps.googleapis.com/maps/api/distancematrix/json?origins=Seattle&destinations=San+Francisco&key= YOUR_API_KEY

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