ওভারভিউ
প্রমাণীকরণের নিরাপত্তা এবং নির্ভরযোগ্যতা বাড়ানোর জন্য, Maps প্ল্যাটফর্ম ক্লায়েন্ট আইডিগুলি 26 মে, 2025 থেকে বাতিল করা হয়েছে এবং 31 মে, 2026 এর পরে আর ব্যবহার করা যাবে না৷
একটি ক্লায়েন্ট আইডি ব্যবহার করার পরিবর্তে, আপনার Google মানচিত্র API পরিষেবা ট্র্যাফিককে প্রমাণীকরণ করতে আপনাকে অবশ্যই API কী শংসাপত্রগুলি ব্যবহার করতে হবে৷ এই নির্দেশিকা আপনাকে দেখায় কিভাবে ক্লায়েন্ট আইডি ব্যবহার করে এপিআই কী ব্যবহার করে স্থানান্তর করতে হয়।
শুরু করতে এই পদক্ষেপগুলি অনুসরণ করুন:
- বর্তমান ক্লায়েন্ট আইডি ব্যবহার পরীক্ষা করুন
- API কী প্রস্তুত করুন
- কোটা সেটিংস পর্যালোচনা করুন
- আপনার কোড আপডেট করুন
- আপনার ক্লায়েন্ট আইডি ট্রাফিক নিরীক্ষণ
- আপনার ক্লায়েন্ট আইডি পজ করুন
বর্তমান ক্লায়েন্ট আইডি ব্যবহার পরীক্ষা করুন
মাইগ্রেশন প্রক্রিয়া শুরু করার আগে, নিম্নলিখিতগুলি তালিকাভুক্ত করুন:
- ম্যাপ প্ল্যাটফর্ম পরিষেবা যা আপনি আপনার ক্লায়েন্ট আইডি দিয়ে ব্যবহার করছেন।
- অ্যাপ্লিকেশন, সাইট বা সিস্টেম যেগুলির সাথে আপনি আপনার ক্লায়েন্ট আইডি ব্যবহার করছেন৷
Google 2025 সালের মে মাসে ক্লায়েন্ট আইডি অবমূল্যায়ন সম্পর্কে প্রভাবিত গ্রাহকদের একটি বিজ্ঞপ্তি ইমেল পাঠিয়েছে। আপনি বিজ্ঞপ্তি ইমেলেও এই তথ্য পেতে পারেন।
ক্লাউড কনসোলে, আপনি Google মানচিত্র মেট্রিক্স পৃষ্ঠায় আপনার ক্লায়েন্ট আইডি ব্যবহারের সর্বশেষ স্থিতি পরীক্ষা করতে পারেন
মানচিত্র প্ল্যাটফর্ম পরিষেবাগুলির একটি তালিকার জন্য :
- ক্লাউড কনসোলে মেট্রিক্স পৃষ্ঠা খুলুন।
- নিম্নলিখিত সেটিংস দিয়ে আপনার ব্যবহার ফিল্টার করুন:
- শংসাপত্র: শুধুমাত্র "project_number:<numerical identifier>" নির্বাচন করুন।
- নিম্নলিখিত ফিল্টার সেট করুন।
- দ্বারা গোষ্ঠীবদ্ধ: API
অ্যাপ্লিকেশন, সাইট বা সিস্টেমের ইঙ্গিতের জন্য :
ক্লাউড কনসোল আপনার অ্যাপ্লিকেশন, সাইট বা সিস্টেমের বিশদ বিবরণ দেখায় না। কিন্তু আপনি আপনার ক্লায়েন্ট আইডি ট্র্যাফিকের উত্সগুলির কিছু ইঙ্গিত খুঁজে পেতে পারেন৷ এই পদক্ষেপগুলি অনুসরণ করুন:
- ক্লাউড কনসোলে মেট্রিক্স পৃষ্ঠা খুলুন।
- ড্রপ-ডাউন থেকে একটি মানচিত্র প্ল্যাটফর্ম পরিষেবা নির্বাচন করুন৷
- নিম্নলিখিত সেটিংস দিয়ে আপনার ব্যবহার ফিল্টার করুন:
- শংসাপত্র: শুধুমাত্র "project_number:<numerical identifier>" নির্বাচন করুন।
- নিম্নলিখিত ফিল্টার সেট করুন।
- গোষ্ঠী অনুসারে: প্ল্যাটফর্ম বা ডোমেন
- প্রতিটি মানচিত্র প্ল্যাটফর্ম পরিষেবার জন্য ধাপ 2 থেকে পুনরাবৃত্তি করুন যার জন্য আপনাকে ট্র্যাফিক পরীক্ষা করতে হবে।
API কী প্রস্তুত করুন
সমস্ত ক্লায়েন্ট আইডি একটি Google ক্লাউড প্রকল্পের সাথে যুক্ত, এবং সেই প্রকল্পের একটি API কী ব্যবহার করা আপনাকে একই বৈশিষ্ট্যগুলিতে অ্যাক্সেস দেবে যা আপনি আগে আপনার ক্লায়েন্ট আইডি দিয়ে অ্যাক্সেস করেছিলেন৷ কোটা বা অনুপস্থিত বৈশিষ্ট্যগুলির সমস্যা এড়াতে আমরা সংশ্লিষ্ট প্রকল্পে স্থানান্তরিত করার পরামর্শ দিই।
- ক্লাউড প্রজেক্টটি খুঁজুন যার সাথে আপনার ক্লায়েন্ট আইডি লিঙ্ক করা হয়েছে:
- নিশ্চিত করুন যে আপনার ক্লাউড প্রজেক্ট একটি খোলা বিলিং অ্যাকাউন্টের সাথে লিঙ্ক করা আছে।
- ক্লায়েন্ট আইডি মাইগ্রেশনের জন্য একটি নতুন API কী তৈরি করুন ।
- আপনি ক্লাউড প্রজেক্টে বিদ্যমান যেকোনো API কী পুনরায় ব্যবহার করতে পারেন।
- আপনি একই ক্লাউড প্রজেক্ট থেকে একাধিক API কী ব্যবহার করতে পারেন, উদাহরণস্বরূপ, প্রতিটি মানচিত্র প্ল্যাটফর্ম পরিষেবার জন্য আলাদা ট্রাফিকের জন্য, বা বিভিন্ন প্ল্যাটফর্ম (ব্রাউজার, মোবাইল অ্যাপ এবং আরও অনেক কিছু) থেকে ট্র্যাফিক আলাদা করতে। API কী ব্যবস্থাপনার সর্বোত্তম অনুশীলনের জন্য নিরাপত্তা নির্দেশিকা পড়ুন।
আপনার API কী সুরক্ষিত করুন
অননুমোদিত অ্যাক্সেস থেকে আপনার কী রক্ষা করতে আপনার API কী সুরক্ষিত করতে ভুলবেন না।
- আপনার API কী (যেমন ওয়েবসাইট, আইপি ঠিকানা, অ্যান্ড্রয়েড অ্যাপস, বা iOS অ্যাপস) জন্য একটি অ্যাপ্লিকেশন সীমাবদ্ধতা সেট করুন।
- আপনার API কী এর জন্য API সীমাবদ্ধতা সেট করুন।
আরও বিশদ বিবরণের জন্য Google মানচিত্র প্ল্যাটফর্ম নিরাপত্তা নির্দেশিকা দেখুন।
Maps JavaScript API, Maps Static API, এবং Street View Static API-এর জন্য, আপনি আপনার ক্লায়েন্ট আইডিতে বিশ্বস্ত রেফারারদের API কী সীমাবদ্ধতায় স্থানান্তর করতে পারেন। আপনি ক্লাউড কনসোলে বিশ্বস্ত রেফারারের তালিকা খুঁজে পেতে পারেন।
কোটা সেটিংস পর্যালোচনা করুন
নিশ্চিত করুন যে আপনি আপনার ক্লাউড প্রকল্পে প্রত্যাশিত কোটা সেটিংস করেছেন৷ যদি আপনি একটি ক্লায়েন্ট আইডি থেকে Maps JavaScript API ক্লায়েন্ট-সাইড পরিষেবাগুলিতে কল করেন তবেই আপনাকে এটি করতে হবে৷ আপনি Google মানচিত্র কোটা পৃষ্ঠায় আপনার কোটা সেটিংস চেক এবং সামঞ্জস্য করতে পারেন।
কোটা রিপোর্ট সম্পর্কে আরও জানুন
Maps JavaScript API ক্লায়েন্ট-সাইড পরিষেবাগুলির জন্য কোটা বৃদ্ধি৷
আপনি যদি মানচিত্র জাভাস্ক্রিপ্ট API-এ নিম্নলিখিত পরিষেবাগুলি ব্যবহার করেন, তাহলে API কী মাইগ্রেশনের পরে আপনি কোটা ব্যবহার বৃদ্ধি দেখতে পাবেন।
আপনার বর্তমান কোটা কনফিগারেশন, বর্তমান ব্যবহার পর্যালোচনা করুন এবং সেই অনুযায়ী আপনার কোটা সীমা সামঞ্জস্য করুন ।
- আপনি একটি ক্লায়েন্ট আইডি সহ Maps JavaScript API ক্লায়েন্ট-সাইড পরিষেবাগুলি ব্যবহার করছেন কিনা তা পরীক্ষা করুন৷
- ক্লাউড কনসোলে মেট্রিক্স পৃষ্ঠা খুলুন।
- নিম্নলিখিত সেটিংস দিয়ে আপনার ব্যবহার ফিল্টার করুন:
- দ্বারা গোষ্ঠীবদ্ধ: API পদ্ধতি
- শংসাপত্র: শুধুমাত্র "project_number:<numerical identifier>" নির্বাচন করুন।
- তারপর, আপনি "এপিআই পদ্ধতি দ্বারা ট্রাফিক" চার্টে এর ট্র্যাফিক সহ পদ্ধতির নামের একটি তালিকা দেখতে পাবেন।
API পদ্ধতি | ক্লায়েন্ট-সাইড পরিষেবা | সেবা কোটা সমন্বয় |
google.routes.Directions.Javascript | দিকনির্দেশ পরিষেবা | দিকনির্দেশ API |
google.routes.DistanceMatrix.Javascript | দূরত্ব ম্যাট্রিক্স পরিষেবা | দূরত্ব ম্যাট্রিক্স API |
google.maps.Elevation.Javascript | এলিভেশন সার্ভিস | এলিভেশন API |
google.places.Geocoding.Javascript | জিওকোডিং পরিষেবা | জিওকোডিং API |
google.places.*.Javascript, google.places.Geocoding.Javascript ছাড়া অন্য | স্থান লাইব্রেরি | স্থান API |
- আপনি যদি সেই API পদ্ধতিগুলি ব্যবহার না করেন, তাহলে আপনাকে কোটা সেটিংস নিয়ে চিন্তা করার দরকার নেই, কারণ আপনার ক্লায়েন্ট আইডি ট্র্যাফিক ইতিমধ্যেই আপনার প্রকল্পের কোটা ব্যবহার করে।
- আপনার ক্লায়েন্ট আইডি কোটা ব্যবহার অনুমান
- প্রতিটি পরিষেবার জন্য, প্রতি সেকেন্ড এবং প্রতি দিন গ্রানুলারিটি উভয়ই পরীক্ষা করুন৷
- প্রতি সেকেন্ড গ্রাফ: অতিরিক্ত কোটা প্রতি মিনিটের প্রয়োজনের জন্য সর্বোচ্চ ট্রাফিককে 60 দ্বারা গুণ করুন।
- প্রতি দিনের গ্রাফ: সর্বোচ্চ ট্রাফিক প্রতিদিনের প্রয়োজনের অতিরিক্ত কোটা হওয়া উচিত।
- সংশ্লিষ্ট মানচিত্র প্ল্যাটফর্ম পরিষেবাগুলিতে আপনার কোটা সামঞ্জস্য করুন
- পদ্ধতির নামের উপর ভিত্তি করে যা আপনি ধাপ 1-এ খুঁজে পেয়েছেন, সংশ্লিষ্ট পরিষেবাগুলিতে কোটা সামঞ্জস্য করুন।
আপনার কোড আপডেট করুন
কী প্যারামিটার দিয়ে ক্লায়েন্ট প্যারামিটার প্রতিস্থাপন করুন
আপনার বহির্গামী GMP API কলগুলিতে URL&client={value} থেকে URL&key={value} এ প্রমাণীকরণ শংসাপত্রগুলি আপডেট করুন৷ যদি আপনার অ্যাপগুলি GMP পরিষেবাগুলি অ্যাক্সেস করতে HTTP ব্যবহার করে, তাহলে HTTPS ব্যবহার করতে সেগুলি আপডেট করুন।
রিপোর্ট করার জন্য চ্যানেল প্যারামিটার আপডেট করুন
আপনি আপনার API অনুরোধে চ্যানেল প্যারামিটার নির্দিষ্ট করে চ্যানেল প্রতি আপনার ব্যবহার ট্র্যাক করতে পারেন। API কী শুধুমাত্র চ্যানেল প্যারামিটারের জন্য সংখ্যাসূচক মান সমর্থন করে। আপনি যদি চ্যানেল প্যারামিটারের জন্য কোনো অ-সংখ্যাসূচক মান সহ আপনার ক্লায়েন্ট আইডি ব্যবহার করেন তবে এটিকে একটি সংখ্যাসূচক মান সমর্থিত মানগুলিতে আপডেট করুন।
আরও তথ্যের জন্য Google মানচিত্র প্ল্যাটফর্ম রিপোর্টিং দেখুন।
ওয়েব পরিষেবার জন্য স্বাক্ষর প্যারামিটার সরান
নিম্নলিখিত ওয়েব পরিষেবা APIগুলির জন্য, যখন আপনি একটি API কী দিয়ে সেগুলি অ্যাক্সেস করেন তখন স্বাক্ষর প্যারামিটারের প্রয়োজন হয় না৷ শুধুমাত্র আপনার API অনুরোধ থেকে স্বাক্ষর প্যারামিটার সরান.
- দিকনির্দেশ API (উত্তরাধিকার)
- দূরত্ব ম্যাট্রিক্স API (উত্তরাধিকার)
- জিওকোডিং API
- এলিভেশন API
- টাইম জোন এপিআই
আরও তথ্যের জন্য প্রিমিয়াম প্ল্যান ওভারভিউ দেখুন।
চিত্রকল্প API-এর জন্য সাইনিং সিক্রেট
মানচিত্র স্ট্যাটিক API, এবং রাস্তার দৃশ্য স্ট্যাটিক API-এর এখনও স্বাক্ষর পরামিতি প্রয়োজন। তারা পরীক্ষার উদ্দেশ্যে স্বাক্ষর ছাড়াই অল্প সংখ্যক অনুরোধ গ্রহণ করে, কিন্তু এটি আপনার উত্পাদনের থ্রেশহোল্ডে পৌঁছালে তারা ব্যর্থ হতে শুরু করে। আপনার সাইনিং সিক্রেট ক্লায়েন্ট আইডি থেকে এপিআই কী-এর জন্য একটিতে প্রতিস্থাপন করুন। আপনি একই সাইনিং অ্যালগরিদম ব্যবহার করতে পারেন, কিন্তু আপনাকে অন্য সাইনিং সিক্রেট ব্যবহার করতে হবে। আরও জানতে, একটি ডিজিটাল স্বাক্ষর ব্যবহার করুন দেখুন।
আপনার ক্লায়েন্ট আইডি ট্রাফিক নিরীক্ষণ
স্থাপনের পরে, নিশ্চিত করুন যে ক্লাউড কনসোল ড্যাশবোর্ডগুলি ব্যবহার করে আপনার ট্র্যাফিক সফলভাবে স্থানান্তরিত হয়েছে৷ আপনি আপনার ক্লায়েন্ট আইডি ট্র্যাফিকের হ্রাস দেখতে শুরু করবেন, যা শংসাপত্র অনুসারে গ্রুপ করার সময় ড্যাশবোর্ডে "project_number:123456" ফর্ম্যাটে দেখানো হয়।
আপনার ক্লায়েন্ট আইডি পজ করুন
আমরা দৃঢ়ভাবে সুপারিশ করি যে ডেভেলপাররা মাইগ্রেশনের পরে ক্লায়েন্ট আইডিগুলিকে বিরতি দিন৷ এটি আপনার শংসাপত্রগুলিকে কোনও অনিচ্ছাকৃত ট্র্যাফিক থেকে রক্ষা করার জন্য, এবং আপনার ক্লায়েন্ট আইডিতে যে কোনও অবশিষ্ট ব্যবহার গুরুত্বপূর্ণ নয় তা নিশ্চিত করার জন্য (যেমন পরীক্ষা, ক্যাশে, বট, …) এবং ব্যবসায়িক প্রভাব না ঘটিয়ে ত্রুটিগুলি ফিরিয়ে দিতে পারে৷ আপনি ক্লাউড কনসোলে আপনার ক্লায়েন্ট আইডি পজ করতে পারেন। আরও বিস্তারিত জানার জন্য প্রিমিয়াম প্ল্যান প্রমাণীকরণ ওভারভিউ দেখুন।
সমস্যা সমাধান
আমাদের অনুরোধ ব্যর্থ হচ্ছে কি না তা আমরা কীভাবে দেখতে পারি?
আপনি প্রতিক্রিয়া কোড গ্রাফে আপনার ত্রুটির পরিসংখ্যান পরীক্ষা করতে পারেন
ApiNotActivatedMapError , বা REQUEST_DENIED ত্রুটি৷
আপনি ApiNotActivatedMapError , বা REQUEST_DENIED ত্রুটি দেখতে পাবেন, যদি আপনি আপনার ক্লাউড প্রকল্পে পরিষেবাটি সক্ষম না করেন৷ পরিষেবাটি সক্ষম করতে নির্দেশাবলী অনুসরণ করুন।
RefererNotAllowedMapError ত্রুটি৷
আপনি RefererNotAllowedMapError ত্রুটি দেখতে পাবেন, যদি আপনার সোর্স ডোমেন আপনার API কীতে যোগ না করা হয়। "আপনার 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"
}