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

প্ল্যাটফর্ম নির্বাচন করুন: Android iOS জাভাস্ক্রিপ্ট ওয়েব পরিষেবা

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

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

আপনি শুরু করার আগে

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

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

দ্রষ্টব্য: আপনি যদি বিদ্যমান Places API এবং Places API (নতুন) উভয়ই ব্যবহার করেন, তাহলে আমরা সুপারিশ করি যে আপনি প্রতিটি API সংস্করণের জন্য একটি পৃথক API কী তৈরি করুন৷ দুর্ঘটনাজনিত চার্জ প্রতিরোধ করার জন্য, অন্যান্য সমস্ত API কীগুলি পরীক্ষা করে নিশ্চিত করুন যে আপনি যেখানে প্রয়োজন সেই কীগুলিতে শুধুমাত্র Places API বা Places 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 ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলি সম্পর্কে আরও পড়ুন:

• gcloud alpha services api-keys create

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

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

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

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

কনসোল

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

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

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

ক্লাউড SDK

স্থান API (নতুন)

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

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/locations/global/keys/KEY_ID \
    --api-target=service=places.googleapis.com
    --allowed-ips="IP_ADDRESS"

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

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

স্থান API

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

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/locations/global/keys/KEY_ID \
    --api-target=service=places-backend.googleapis.com
    --allowed-ips="IP_ADDRESS"

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

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

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

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

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key= YOUR_API_KEY

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

দ্রষ্টব্য: ওয়েব পরিষেবাগুলি ব্যবহার করার সময়, প্যারামিটারের ভিতরে সমস্ত বিশেষ অক্ষর অবশ্যই URL এনকোড করা উচিত। ইউআরএলগুলিকে বৈধ হওয়ার জন্য সঠিকভাবে এনকোড করা আবশ্যক এবং সমস্ত ওয়েব পরিষেবার জন্য 2048 অক্ষরের মধ্যে সীমাবদ্ধ। আপনার URL গুলি তৈরি করার সময় এই সীমা সম্পর্কে সচেতন থাকুন৷ বিভিন্ন ব্রাউজার, প্রক্সি এবং সার্ভারের আলাদা আলাদা ইউআরএল অক্ষর সীমাও থাকতে পারে।