Distance Matrix API (পুরনো)-এর সাথে API key ব্যবহার করা

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

Google Maps Platform-এর জন্য আপনার API কী কীভাবে তৈরি, সীমাবদ্ধ ও ব্যবহার করবেন তা এই নির্দেশিকা থেকে জানতে পারবেন।

শুরু করার আগে

Distance Matrix API (Legacy) ব্যবহার করা শুরু করার আগে, আপনার একটি প্রোজেক্ট প্রয়োজন যেখানে বিলিং অ্যাকাউন্ট এবং Distance Matrix API (Legacy) চালু করা আছে। আরও জানতে, Cloud কনসোলে সেট-আপ করুন দেখুন।

API key তৈরি করুন

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

কনসোল

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

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

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

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

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

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

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

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

    এখানে API বেছে নিলে তা চালু হয় না। নিশ্চিত করুন যে Distance Matrix 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=distance-matrix-backend.googleapis.com

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

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

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

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

    'কী' আইডি হল 'কী' স্ট্রিং বা ডিসপ্লে নাম নয়। এটি খুঁজতে, 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 কী-তে বিধিনিষেধ আরোপ করা

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

API key-তে বিধিনিষেধ আরোপ করতে:

কনসোল

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

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

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

gcloud

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

gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=distance-matrix-backend.googleapis.com \
    --allowed-ips="IP_ADDRESS"

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

আপনার অনুরোধে API key যোগ করুন

প্রতিটি Distance Matrix API (Legacy) অনুরোধের সাথে আপনাকে অবশ্যই একটি API key অন্তর্ভুক্ত করতে হবে। নিচের উদাহরণে, YOUR_API_KEY-এর জায়গায় আপনার API key লিখুন:

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

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