সংক্ষিপ্ত বিবরণ
প্রমাণীকরণের নিরাপত্তা এবং নির্ভরযোগ্যতা বৃদ্ধির জন্য, Maps Platform ক্লায়েন্ট আইডিগুলি ২৬ মে, ২০২৫ থেকে বন্ধ করে দেওয়া হয়েছে এবং ৩১ মে, ২০২৬ এর পরে আর ব্যবহার করা যাবে না।
ক্লায়েন্ট আইডি ব্যবহার করার পরিবর্তে, আপনার গুগল ম্যাপস এপিআই পরিষেবা ট্র্যাফিক প্রমাণীকরণের জন্য আপনাকে অবশ্যই এপিআই কী শংসাপত্র ব্যবহার করতে হবে। এই নির্দেশিকাটি আপনাকে দেখায় যে কীভাবে ক্লায়েন্ট আইডি ব্যবহার থেকে এপিআই কী ব্যবহারে স্থানান্তরিত করবেন।
শুরু করতে এই পদক্ষেপগুলি অনুসরণ করুন:
- বর্তমান ক্লায়েন্ট আইডি ব্যবহার পরীক্ষা করুন
- API কী প্রস্তুত করুন
- কোটা সেটিংস পর্যালোচনা করুন
- আপনার কোড আপডেট করুন
- আপনার ক্লায়েন্ট আইডি ট্র্যাফিক নিরীক্ষণ করুন
- আপনার ক্লায়েন্ট আইডি পজ করুন
বর্তমান ক্লায়েন্ট আইডি ব্যবহার পরীক্ষা করুন
মাইগ্রেশন প্রক্রিয়া শুরু করার আগে, নিম্নলিখিতগুলি তালিকাভুক্ত করুন:
- আপনার ক্লায়েন্ট আইডি ব্যবহার করে আপনি যে ম্যাপস প্ল্যাটফর্ম পরিষেবাগুলি ব্যবহার করছেন।
- যেসব অ্যাপ্লিকেশন, সাইট, অথবা সিস্টেমের মাধ্যমে আপনি আপনার ক্লায়েন্ট আইডি ব্যবহার করছেন।
২০২৫ সালের মে মাসে ক্লায়েন্ট আইডি বন্ধ হওয়ার বিষয়ে ক্ষতিগ্রস্ত গ্রাহকদের কাছে গুগল একটি বিজ্ঞপ্তি ইমেল পাঠিয়েছিল। আপনি বিজ্ঞপ্তি ইমেলেও এই তথ্যটি পেতে পারেন।
ক্লাউড কনসোলে, আপনি গুগল ম্যাপস মেট্রিক্স পৃষ্ঠায় আপনার ক্লায়েন্ট আইডি ব্যবহারের সর্বশেষ অবস্থা পরীক্ষা করতে পারেন।
মানচিত্র প্ল্যাটফর্ম পরিষেবার তালিকার জন্য :
- ক্লাউড কনসোলে মেট্রিক্স পৃষ্ঠাটি খুলুন।
- নিম্নলিখিত সেটিংস ব্যবহার করে আপনার ব্যবহার ফিল্টার করুন:
- শংসাপত্র: শুধুমাত্র "project_number:<numerical identifier>" নির্বাচন করুন।
- নিম্নলিখিত ফিল্টারটি সেট করুন।
- গ্রুপকৃত: API
অ্যাপ্লিকেশন, সাইট বা সিস্টেমের ইঙ্গিতের জন্য :
ক্লাউড কনসোল আপনার অ্যাপ্লিকেশন, সাইট বা সিস্টেমের বিশদ বিবরণ দেখায় না। তবে আপনি আপনার ক্লায়েন্ট আইডি ট্র্যাফিকের উৎসের কিছু ইঙ্গিত পেতে পারেন। এই পদক্ষেপগুলি অনুসরণ করুন:
- ক্লাউড কনসোলে মেট্রিক্স পৃষ্ঠাটি খুলুন।
- ড্রপ-ডাউন থেকে একটি মানচিত্র প্ল্যাটফর্ম পরিষেবা নির্বাচন করুন।
- নিম্নলিখিত সেটিংস ব্যবহার করে আপনার ব্যবহার ফিল্টার করুন:
- শংসাপত্র: শুধুমাত্র "project_number:<numerical identifier>" নির্বাচন করুন।
- নিম্নলিখিত ফিল্টারটি সেট করুন।
- গ্রুপ করুন: প্ল্যাটফর্ম, অথবা ডোমেন
- প্রতিটি ম্যাপস প্ল্যাটফর্ম পরিষেবার জন্য ধাপ ২ থেকে পুনরাবৃত্তি করুন যার জন্য আপনাকে ট্র্যাফিক পরীক্ষা করতে হবে।
API কী প্রস্তুত করুন
সমস্ত ক্লায়েন্ট আইডি একটি Google ক্লাউড প্রোজেক্টের সাথে যুক্ত থাকে এবং সেই প্রোজেক্ট থেকে একটি API কী ব্যবহার করলে আপনি আপনার ক্লায়েন্ট আইডি দিয়ে পূর্বে যে বৈশিষ্ট্যগুলি অ্যাক্সেস করেছিলেন সেগুলিতে অ্যাক্সেস পাবেন। কোটা বা অনুপস্থিত বৈশিষ্ট্যগুলির সমস্যা এড়াতে আমরা সংশ্লিষ্ট প্রোজেক্টে মাইগ্রেট করার পরামর্শ দিচ্ছি।
- আপনার ক্লায়েন্ট আইডি যে ক্লাউড প্রজেক্টের সাথে লিঙ্ক করা আছে তা খুঁজুন:
- নিশ্চিত করুন যে আপনার ক্লাউড প্রজেক্টটি একটি খোলা বিলিং অ্যাকাউন্টের সাথে লিঙ্ক করা আছে।
- ক্লায়েন্ট আইডি মাইগ্রেশনের জন্য একটি নতুন API কী তৈরি করুন ।
- আপনি ক্লাউড প্রজেক্টে বিদ্যমান যেকোনো API কী পুনরায় ব্যবহার করতে পারেন।
- আপনি একই ক্লাউড প্রজেক্ট থেকে একাধিক API কী ব্যবহার করতে পারেন, উদাহরণস্বরূপ, প্রতিটি Maps Platform পরিষেবার জন্য ট্র্যাফিক আলাদা করার জন্য, অথবা বিভিন্ন প্ল্যাটফর্ম (ব্রাউজার, মোবাইল অ্যাপ, ইত্যাদি) থেকে ট্র্যাফিক আলাদা করার জন্য। API কী পরিচালনার সেরা অনুশীলনের জন্য নিরাপত্তা নির্দেশিকাটি পড়ুন।
আপনার API কী সুরক্ষিত করুন
আপনার কীটিকে অননুমোদিত অ্যাক্সেস থেকে রক্ষা করতে আপনার API কীটি সুরক্ষিত করতে ভুলবেন না।
- আপনার API কী (যেমন ওয়েবসাইট, আইপি ঠিকানা, অ্যান্ড্রয়েড অ্যাপ, অথবা iOS অ্যাপ) এর জন্য একটি অ্যাপ্লিকেশন সীমাবদ্ধতা সেট করুন।
- আপনার API কী-এর জন্য API সীমাবদ্ধতা সেট করুন।
আরও বিস্তারিত জানার জন্য Google Maps প্ল্যাটফর্মের নিরাপত্তা নির্দেশিকা দেখুন।
Maps JavaScript API, Maps Static API এবং Street View Static API-এর জন্য, আপনি আপনার ক্লায়েন্ট আইডিতে থাকা বিশ্বস্ত রেফারারগুলিকে API কী সীমাবদ্ধতায় স্থানান্তর করতে পারেন। আপনি Cloud Console-এ বিশ্বস্ত রেফারারদের তালিকা খুঁজে পেতে পারেন।
কোটা সেটিংস পর্যালোচনা করুন
আপনার ক্লাউড প্রজেক্টে প্রত্যাশিত কোটা সেটিংস আছে কিনা তা নিশ্চিত করুন। আপনি যদি ক্লায়েন্ট আইডি থেকে ম্যাপস জাভাস্ক্রিপ্ট এপিআই ক্লায়েন্ট-সাইড পরিষেবাগুলিতে কল করেন তবেই আপনাকে এটি করতে হবে। আপনি গুগল ম্যাপস কোটা পৃষ্ঠায় আপনার কোটা সেটিংস পরীক্ষা করে সামঞ্জস্য করতে পারেন।
কোটা রিপোর্ট সম্পর্কে আরও জানুন
Maps JavaScript API ক্লায়েন্ট-সাইড পরিষেবার জন্য কোটা বৃদ্ধি
আপনি যদি Maps JavaScript API-তে নিম্নলিখিত পরিষেবাগুলি ব্যবহার করেন, তাহলে API কী মাইগ্রেশনের পরে কোটা ব্যবহারের বৃদ্ধি দেখতে পাবেন।
আপনার বর্তমান কোটা কনফিগারেশন, বর্তমান ব্যবহার পর্যালোচনা করুন এবং সেই অনুযায়ী আপনার কোটার সীমা সামঞ্জস্য করুন ।
- আপনি ক্লায়েন্ট আইডি সহ Maps JavaScript API ক্লায়েন্ট-সাইড পরিষেবা ব্যবহার করছেন কিনা তা পরীক্ষা করুন।
- ক্লাউড কনসোলে মেট্রিক্স পৃষ্ঠাটি খুলুন।
- নিম্নলিখিত সেটিংস ব্যবহার করে আপনার ব্যবহার ফিল্টার করুন:
- গ্রুপকৃত: API পদ্ধতি
- শংসাপত্র: শুধুমাত্র "project_number:<numerical identifier>" নির্বাচন করুন।
- তারপর, আপনি "API পদ্ধতি অনুসারে ট্র্যাফিক" চার্টে পদ্ধতির নামের একটি তালিকা দেখতে পাবেন যার ট্র্যাফিক রয়েছে।
API পদ্ধতি | ক্লায়েন্ট-সাইড পরিষেবা | কোটা সমন্বয় করার জন্য পরিষেবা |
গুগল.রুটস.ডাইরেকশনস.জাভাস্ক্রিপ্ট | দিকনির্দেশনা পরিষেবা | দিকনির্দেশ API |
গুগল.রুটস.ডিস্টেন্সম্যাট্রিক্স.জাভাস্ক্রিপ্ট | দূরত্ব ম্যাট্রিক্স পরিষেবা | দূরত্ব ম্যাট্রিক্স API |
গুগল.ম্যাপ.এলিভেশন.জাভাস্ক্রিপ্ট | উচ্চতা পরিষেবা | উচ্চতা API |
গুগল.প্লেস.জিওকোডিং.জাভাস্ক্রিপ্ট | জিওকোডিং পরিষেবা | জিওকোডিং এপিআই |
google.places.*.Javascript, google.places.Geocoding.Javascript ব্যতীত | স্থান গ্রন্থাগার | স্থান API |
- যদি আপনি ঐ API পদ্ধতিগুলি ব্যবহার না করেন, তাহলে আপনার কোটা সেটিংস নিয়ে চিন্তা করার দরকার নেই, কারণ আপনার ক্লায়েন্ট আইডি ট্র্যাফিক ইতিমধ্যেই আপনার প্রকল্পের কোটা গ্রাস করে নিচ্ছে।
- আপনার ক্লায়েন্ট আইডি কোটা ব্যবহারের অনুমান করুন
- প্রতিটি পরিষেবার জন্য, প্রতি সেকেন্ড এবং প্রতি দিন উভয়ের গ্র্যানুলারিটি পরীক্ষা করুন।
- প্রতি সেকেন্ড গ্রাফ: অতিরিক্ত কোটা প্রতি মিনিটের চাহিদার জন্য সর্বোচ্চ ট্র্যাফিককে 60 দিয়ে গুণ করুন।
- প্রতিদিনের গ্রাফ: সর্বোচ্চ ট্র্যাফিক প্রতিদিনের অতিরিক্ত কোটার চাহিদার উপর নির্ভর করে হওয়া উচিত।
- সংশ্লিষ্ট মানচিত্র প্ল্যাটফর্ম পরিষেবাগুলিতে আপনার কোটা সামঞ্জস্য করুন
- ধাপ ১-এ আপনি যে পদ্ধতির নামটি পাবেন তার উপর ভিত্তি করে, সংশ্লিষ্ট পরিষেবাগুলির কোটা সামঞ্জস্য করুন।
আপনার কোড আপডেট করুন
ক্লায়েন্ট প্যারামিটারকে কী প্যারামিটার দিয়ে প্রতিস্থাপন করুন
আপনার বহির্গামী GMP API কলগুলিতে URL&client={value} থেকে URL&key={value} এ প্রমাণীকরণ শংসাপত্রগুলি আপডেট করুন। যদি আপনার অ্যাপগুলি GMP পরিষেবা অ্যাক্সেস করার জন্য HTTP ব্যবহার করে, তাহলে HTTPS ব্যবহার করার জন্য সেগুলি আপডেট করুন।
রিপোর্ট করার জন্য চ্যানেল প্যারামিটার আপডেট করুন
আপনার API অনুরোধগুলিতে চ্যানেল প্যারামিটার নির্দিষ্ট করে আপনি প্রতি চ্যানেলের ব্যবহার ট্র্যাক করতে পারেন। API কীগুলি কেবল চ্যানেল প্যারামিটারের জন্য সংখ্যাসূচক মান সমর্থন করে। যদি আপনি চ্যানেল প্যারামিটারের জন্য কোনও অ-সংখ্যাসূচক মান সহ আপনার ক্লায়েন্ট আইডি ব্যবহার করেন, তাহলে এটিকে একটি সংখ্যাসূচক মান সমর্থিত মানগুলিতে আপডেট করুন।
আরও তথ্যের জন্য গুগল ম্যাপস প্ল্যাটফর্ম রিপোর্টিং দেখুন।
ওয়েব পরিষেবার জন্য স্বাক্ষর প্যারামিটার সরান
নিম্নলিখিত ওয়েব সার্ভিস API গুলির জন্য, API কী দিয়ে অ্যাক্সেস করার সময় স্বাক্ষর প্যারামিটারের প্রয়োজন হয় না। আপনার API অনুরোধগুলি থেকে শুধুমাত্র স্বাক্ষর প্যারামিটারটি সরিয়ে ফেলুন।
- দিকনির্দেশ API (লিগ্যাসি)
- দূরত্ব ম্যাট্রিক্স API (লিগ্যাসি)
- জিওকোডিং এপিআই
- উচ্চতা API
- টাইম জোন এপিআই
আরও তথ্যের জন্য প্রিমিয়াম প্ল্যানের ওভারভিউ দেখুন।
ইমেজারি API-এর জন্য সাইনিং সিক্রেট
Maps Static API, এবং Street View Static API-এর জন্য এখনও স্বাক্ষর প্যারামিটার প্রয়োজন। পরীক্ষার উদ্দেশ্যে স্বাক্ষর ছাড়াই তারা অল্প সংখ্যক অনুরোধ গ্রহণ করে, কিন্তু আপনার প্রোডাকশনে এটি থ্রেশহোল্ডে পৌঁছানোর সাথে সাথে এগুলি ব্যর্থ হতে শুরু করে। ক্লায়েন্ট আইডির জন্য আপনার স্বাক্ষর গোপনীয়তাটি API কী-এর জন্য প্রতিস্থাপন করুন। আপনি একই স্বাক্ষর অ্যালগরিদম ব্যবহার করতে পারেন, তবে আপনাকে অন্য একটি স্বাক্ষর গোপনীয়তা ব্যবহার করতে হবে। আরও জানতে, একটি ডিজিটাল স্বাক্ষর ব্যবহার করুন দেখুন।
আপনার ক্লায়েন্ট আইডি ট্র্যাফিক নিরীক্ষণ করুন
স্থাপনার পরে, ক্লাউড কনসোল ড্যাশবোর্ড ব্যবহার করে নিশ্চিত করুন যে আপনার ট্র্যাফিক সফলভাবে স্থানান্তরিত হয়েছে। আপনি আপনার ক্লায়েন্ট আইডি ট্র্যাফিকের হ্রাস দেখতে শুরু করবেন, যা শংসাপত্র অনুসারে গ্রুপ করার সময় ড্যাশবোর্ডে "project_number:123456" ফর্ম্যাটে দেখানো হয়।
আপনার ক্লায়েন্ট আইডি পজ করুন
আমরা দৃঢ়ভাবে সুপারিশ করছি যে ডেভেলপাররা মাইগ্রেশনের পরে ক্লায়েন্ট আইডিগুলিকে পজ করুন। এটি আপনার শংসাপত্রগুলিকে যেকোনো অনিচ্ছাকৃত ট্র্যাফিক থেকে রক্ষা করার জন্য এবং নিশ্চিত করার জন্য যে আপনার ক্লায়েন্ট আইডিতে অবশিষ্ট কোনও ব্যবহার গুরুত্বপূর্ণ নয় (যেমন পরীক্ষা, ক্যাশে, বট, …) এবং ব্যবসায়িক প্রভাব না ফেলে ত্রুটিগুলি ফিরিয়ে আনতে পারে। আপনি ক্লাউড কনসোলে আপনার ক্লায়েন্ট আইডি পজ করতে পারেন। আরও বিস্তারিত জানার জন্য প্রিমিয়াম প্ল্যান প্রমাণীকরণ ওভারভিউ দেখুন।
সমস্যা সমাধান
আমাদের অনুরোধ ব্যর্থ হচ্ছে কি না, তা আমরা কীভাবে দেখতে পারি?
আপনি রেসপন্স কোড গ্রাফগুলিতে আপনার ত্রুটির পরিসংখ্যান পরীক্ষা করতে পারেন।
ApiNotActivatedMapError , অথবা REQUEST_DENIED ত্রুটি
আপনার ক্লাউড প্রজেক্টে পরিষেবাটি সক্ষম না করলে, আপনি ApiNotActivatedMapError অথবা REQUEST_DENIED ত্রুটি দেখতে পাবেন। পরিষেবাটি সক্ষম করতে নির্দেশাবলী অনুসরণ করুন।
RefererNotAllowedMapError ত্রুটি
যদি আপনার সোর্স ডোমেইনটি আপনার API কী-তে যোগ না করা হয়, তাহলে আপনি RefererNotAllowedMapError ত্রুটি দেখতে পাবেন। "আপনার API কী সুরক্ষিত করুন" বিভাগটি পরীক্ষা করুন এবং আপনার ডোমেইনটি API কী-তে যোগ করুন।
OverQuotaMapError , অথবা OVER_QUERY_LIMIT ত্রুটি
যদি আপনার কনফিগার করা কোটা আপনার ট্র্যাফিকের জন্য যথেষ্ট না হয়, তাহলে আপনি OverQuotaMapError অথবা OVER_QUERY_LIMIT দেখতে পাবেন। "কোটা সেটিংস পর্যালোচনা করুন" বিভাগটি পরীক্ষা করুন এবং সেই অনুযায়ী আপনার কোটা সামঞ্জস্য করুন।
"এই API-এর অনুরোধগুলি অবশ্যই SSL-এর বেশি হতে হবে" ত্রুটি
যদি আপনি নিম্নলিখিত ত্রুটির বার্তা পান, তাহলে আপনার API অনুরোধগুলি "http://" থেকে "https://" এ আপডেট করুন।
{
"error_message" : "Requests to this API must be over SSL. Load the API with
\"https://\" instead of \"http://\".",
"results" : [],
"status" : "REQUEST_DENIED"
}