জিওকোডিং এপিআই সেট আপ করুন

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ডেভেলপাররা

যদি আপনার বিলিং ঠিকানা ইউরোপীয় অর্থনৈতিক অঞ্চলে থাকে, যা ৮ জুলাই ২০২৫ থেকে কার্যকর হয়, তাহলে Google Maps প্ল্যাটফর্ম EEA পরিষেবার শর্তাবলী আপনার পরিষেবা ব্যবহারের ক্ষেত্রে প্রযোজ্য হবে। কার্যকারিতা অঞ্চলভেদে পরিবর্তিত হয়। আরও জানুন ।

এই ডকুমেন্টটি জিওকোডিং API ব্যবহার শুরু করার জন্য প্রয়োজনীয় পদক্ষেপগুলি বর্ণনা করে।

১. অ্যাকাউন্ট এবং বিলিং নিশ্চিত করুন যে আপনি পূর্বশর্তগুলি পূরণ করছেন।

2. API সক্রিয় করুন আপনার Google Cloud প্রোজেক্টে API সক্রিয় করুন।

৩. আপনার প্রথম অনুরোধ করুন একটি প্রমাণীকৃত API অনুরোধ করতে একটি API কী বা OAuth কনফিগার করুন।

মূল বিষয়: এই সেটআপ গাইডে একটি API কী কনফিগার করা এবং একটি OAuth টোকেন তৈরি করার পদ্ধতি অন্তর্ভুক্ত রয়েছে। আপনার স্থাপনার পরিবেশের জন্য প্রযোজ্য পদ্ধতিটি বেছে নিন।

গুগল ম্যাপস প্ল্যাটফর্ম পণ্যগুলিকে অননুমোদিত ব্যবহার থেকে সুরক্ষিত করা হয়, কারণ এপিআই কলগুলিতে একটি এপিআই কী অথবা ওঅথ টোকেন অন্তর্ভুক্ত করার প্রয়োজন হয়।

API কী OAuth টোকেন

একটি OAuth টোকেন তৈরি করুন

জিওকোডিং API প্রমাণীকরণের জন্য OAuth 2.0 ব্যবহার সমর্থন করে। গুগল সাধারণ OAuth 2.0 পরিস্থিতি যেমন ওয়েব সার্ভারের ক্ষেত্রে সমর্থন করে।

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

বিঃদ্রঃ:

যদিও আপনি সার্ভারে API অনুরোধ করে সরাসরি Google Maps API ব্যবহার করতে পারেন, ক্লায়েন্ট লাইব্রেরিগুলি সরলীকরণ প্রদান করে যা আপনার লেখার জন্য প্রয়োজনীয় কোডের পরিমাণ উল্লেখযোগ্যভাবে হ্রাস করে। Google Maps Go, Java, Node.js এবং Python সহ অনেক প্রোগ্রামিং ভাষার জন্য ক্লায়েন্ট লাইব্রেরি প্রদান করে।

ডকুমেন্টেশন এবং উদাহরণের জন্য জিওকোডিং এপিআই ক্লায়েন্ট লাইব্রেরি দেখুন।

OAuth সম্পর্কে

আপনার স্থাপনার পরিবেশের উপর ভিত্তি করে OAuth ব্যবহার করে অ্যাক্সেস টোকেন তৈরি এবং পরিচালনা করার অনেক উপায় রয়েছে।

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

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

OAuth স্কোপ সম্পর্কে

জিওকোডিং API-এর সাথে OAuth ব্যবহার করার জন্য, OAuth টোকেনটিকে সঠিক স্কোপ বরাদ্দ করতে হবে। জিওকোডিং API নিম্নলিখিত স্কোপগুলিকে সমর্থন করে:

• https://www.googleapis.com/auth/maps-platform.geocode — সকল জিওকোডিং API এন্ডপয়েন্টের সাথে ব্যবহার করুন।
• https://www.googleapis.com/auth/maps-platform.geocode.address — ফরোয়ার্ড জিওকোডিংয়ের জন্য শুধুমাত্র GeocodeAddress সাথে ব্যবহার করুন।
• https://www.googleapis.com/auth/maps-platform.geocode.location — বিপরীত জিওকোডিংয়ের জন্য শুধুমাত্র GeocodeLocation সাথে ব্যবহার করুন।
• https://www.googleapis.com/auth/maps-platform.geocode.place — স্থানের জিওকোডিংয়ের জন্য শুধুমাত্র GeocodePlace এর সাথে ব্যবহার করুন।

এছাড়াও, আপনি সমস্ত জিওকোডিং এপিআই এন্ডপয়েন্টের জন্য সাধারণ https://www.googleapis.com/auth/cloud-platform স্কোপ ব্যবহার করতে পারেন। এই স্কোপটি ডেভেলপমেন্টের সময় কার্যকর কারণ এটি gcloud ব্যবহার করে টোকেন তৈরি করার সময় ব্যবহৃত ডিফল্ট স্কোপ।

উদাহরণ: আপনার স্থানীয় ডেভেলপমেন্ট পরিবেশে REST API কল চেষ্টা করুন

যদি আপনি OAuth টোকেন ব্যবহার করে জিওকোডিং API ব্যবহার করে দেখতে চান, কিন্তু টোকেন তৈরি করার জন্য কোনও পরিবেশ সেটআপ না থাকে, তাহলে আপনি কল করার জন্য এই বিভাগের পদ্ধতিটি ব্যবহার করতে পারেন।

এই উদাহরণে অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়ালস (ADC) দ্বারা প্রদত্ত OAuth টোকেনটি কীভাবে কল করতে হয় তা বর্ণনা করা হয়েছে। ক্লায়েন্ট লাইব্রেরি ব্যবহার করে Google API গুলিতে কল করার জন্য ADC ব্যবহার সম্পর্কে তথ্যের জন্য, ক্লায়েন্ট লাইব্রেরি ব্যবহার করে প্রমাণীকরণ দেখুন।

দ্রষ্টব্য : REST কল করার জন্য নীচের পদ্ধতিটি কোনও উৎপাদন পরিবেশে ব্যবহারের উদ্দেশ্যে নয়। শুধুমাত্র একটি উন্নয়ন বা পরীক্ষার পরিবেশের জন্য এই পদ্ধতিটি ব্যবহার করুন।

পূর্বশর্ত

ADC ব্যবহার করে REST অনুরোধ করার আগে, ADC-কে শংসাপত্র প্রদান করতে Google Cloud CLI ব্যবহার করুন:

1. gcloud CLI ইনস্টল এবং আরম্ভ করুন ।

2. আপনার ক্রেডেনশিয়াল ফাইল তৈরি করতে আপনার স্থানীয় মেশিনে নিম্নলিখিত gcloud কমান্ডটি চালান:

   gcloud auth application-default login

3. একটি লগইন স্ক্রিন প্রদর্শিত হবে। লগ ইন করার পরে, আপনার শংসাপত্রগুলি ADC দ্বারা ব্যবহৃত স্থানীয় শংসাপত্র ফাইলে সংরক্ষণ করা হবে।

আরও তথ্যের জন্য, স্থানীয় উন্নয়ন পরিবেশের জন্য ADC সেট আপ দেখুন।

একটি REST অনুরোধ করুন

এই উদাহরণে, আপনি দুটি অনুরোধ শিরোনাম পাস করেছেন:

• টোকেন তৈরি করতে নিম্নলিখিত কমান্ড ব্যবহার করে Authorization হেডারে OAuth টোকেনটি পাস করুন:

  gcloud auth application-default print-access-token

  ফেরত দেওয়া টোকেনের একটি সুযোগ রয়েছে https://www.googleapis.com/auth/cloud-platform.

• X-Goog-User-Project হেডারে আপনার Google Cloud প্রোজেক্টের আইডি বা নাম লিখুন যেখানে বিলিং সক্ষম করা আছে।

নিম্নলিখিত উদাহরণটি OAuth টোকেন ব্যবহার করে জিওকোডিং API-তে কল করে।

1. আপনার Google ক্লাউড প্রোজেক্টের আইডি পাস করতে PROJECT_ID ফিল্ডটি সম্পাদনা করুন।

   curl -X GET -H 'Content-Type: application/json' \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://geocode.googleapis.com/v4beta/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
   

2. কোড নমুনার কপি আইকনে ক্লিক করুন, , curl কমান্ড কপি করতে।
3. কমান্ডটি টার্মিনাল উইন্ডোতে পেস্ট করুন এবং কমান্ডটি চালান।

প্রতিক্রিয়াটি একটি JSON অবজেক্ট:

সমস্যা সমাধান

যদি আপনার অনুরোধে এই API দ্বারা সমর্থিত শেষ-ব্যবহারকারী শংসাপত্রগুলি সম্পর্কে একটি ত্রুটি বার্তা আসে, তাহলে আপনার ADC সেটআপের সমস্যা সমাধান দেখুন।