Directions API (Legacy)-এর সাথে API key ব্যবহার করা

এই প্রোডাক্টটি লেগেসি স্ট্যাটাসে আছে। অক্টোবর ২০২৬ থেকে, নতুন Google Cloud প্রোজেক্টের জন্য Directions API (Legacy) আর চালু করা যাবে না। আগে থেকে থাকা প্রোজেক্টে সম্পূর্ণ সহায়তা প্রদান করা হবে। নতুন ফিচার ও উন্নত পারফর্ম্যান্সের জন্য, Routes API-তে মাইগ্রেট করুন।

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

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

শুরু করার আগে

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

API key তৈরি করুন

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

কনসোল

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

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

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

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

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

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

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

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

   এখানে API বেছে নিলে তা চালু হয় না। Directions 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=directions-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=directions-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 কী-তে বিধিনিষেধ আরোপ করা

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

'কী'-এর অ্যাপ্লিকেশন সংক্রান্ত বিধিনিষেধ এবং API সংক্রান্ত বিধিনিষেধ দুটিই প্রযোজ্য। অনুরোধটি অবশ্যই অনুমোদিত ওয়েবসাইট, IP অ্যাড্রেস বা অ্যাপ থেকে আসতে হবে এবং এটি অবশ্যই অনুমোদিত API কল করবে। প্রতিটি অ্যাপের জন্য এবং সেই অ্যাপটি উপলভ্য প্রতিটি প্ল্যাটফর্মের জন্য আলাদা API key তৈরি করে পেশাদার পদ্ধতি অনুসরণ করুন।

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 সংক্রান্ত বিধিনিষেধ বেছে নিন বিকল্পে, Directions API বেছে নেওয়া হয়েছে কিনা তা ভাল করে দেখে নিন। এটি তালিকাভুক্ত না থাকলে, আপনাকে এটি চালু করতে হবে।
4. আপনার করা পরিবর্তন চূড়ান্ত করতে, সেভ করুন বিকল্পে ক্লিক করুন।
   

gcloud

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

সতর্কতা: gcloud services api-keys update কমান্ড, 'কী'-এর API সংক্রান্ত বিধিনিষেধ এবং আপনার পাস করা অ্যাপ্লিকেশন সংক্রান্ত বিধিনিষেধের ধরন পরিবর্তন করে। নিম্নলিখিত কমান্ড --append ফ্ল্যাগ ব্যবহার করে, যা পরিবর্তে 'কী'-এর আগে থেকে থাকা বিধিনিষেধের সাথে যোগ করে। কীতে আগে থেকেই অন্য ধরনের অ্যাপ্লিকেশন সংক্রান্ত বিধিনিষেধ থাকলে, কমান্ড কাজ করে না।

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

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

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

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

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

https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY

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

মনে রাখবেন: আপনি ওয়েব পরিষেবা ব্যবহার করলে, আপনাকে অবশ্যই প্যারামিটারে সব বিশেষ অক্ষর এনকোড করতে হবে। URL সঠিক হতে হলে, সেটিকে যথাযথভাবে এনকোড করতে হবে এবং সব ওয়েব পরিষেবার জন্য সেটি ২০৪৮ অক্ষরের মধ্যে সীমিত হতে হবে। আপনার URL তৈরি করার সময় এই সীমার কথা মাথায় রাখবেন। বিভিন্ন ব্রাউজার, প্রক্সি ও সার্ভারের ক্ষেত্রেও URL-এর অক্ষর সীমার পার্থক্য থাকতে পারে।