সংক্ষিপ্ত বিবরণ
শুরু করার জন্য এই ধাপগুলো অনুসরণ করুন:
- বর্তমান ক্লায়েন্ট আইডি ব্যবহার পরীক্ষা করুন
- এপিআই কী প্রস্তুত করুন
- কোটা সেটিংস পর্যালোচনা করুন
- আপনার কোড আপডেট করুন
- আপনার ক্লায়েন্ট আইডি ট্র্যাফিক নিরীক্ষণ করুন
- আপনার ক্লায়েন্ট আইডি বিরতি দিন
- ক্লায়েন্ট আইডি স্ব-পরিষেবা অস্থায়ী পুনঃসক্রিয়করণ
বর্তমান ক্লায়েন্ট আইডি ব্যবহার পরীক্ষা করুন
মাইগ্রেশন প্রক্রিয়া শুরু করার আগে, নিম্নলিখিত বিষয়গুলো তালিকাভুক্ত করুন:
- ম্যাপস প্ল্যাটফর্ম পরিষেবাগুলো, যা আপনি আপনার ক্লায়েন্ট আইডি দিয়ে ব্যবহার করছেন।
- অ্যাপ্লিকেশন, সাইট বা সিস্টেম, যেগুলোতে আপনি আপনার ক্লায়েন্ট আইডি ব্যবহার করছেন।
গুগল ২০২৫ সালের মে মাসে ক্লায়েন্ট আইডি বাতিল করার বিষয়ে প্রভাবিত গ্রাহকদের একটি বিজ্ঞপ্তি ইমেল পাঠিয়েছে। আপনি এই তথ্যটি বিজ্ঞপ্তি ইমেলটিতেও খুঁজে পাবেন।
ক্লাউড কনসোলের গুগল ম্যাপস মেট্রিক্স পেজে আপনি আপনার ক্লায়েন্ট আইডি ব্যবহারের সর্বশেষ অবস্থা দেখতে পারেন।
ম্যাপস প্ল্যাটফর্ম পরিষেবাগুলির তালিকার জন্য :
- ক্লাউড কনসোলে মেট্রিক্স পৃষ্ঠাটি খুলুন।
- নিম্নলিখিত সেটিংস ব্যবহার করে আপনার ব্যবহার ফিল্টার করুন:
- প্রমাণপত্র: শুধুমাত্র 'প্রকল্প_নম্বর:<সাংখ্যিক শনাক্তকারী>' নির্বাচন করুন।
- নিম্নলিখিত ফিল্টারটি সেট করুন।
- এপিআই অনুসারে শ্রেণীবদ্ধ:
অ্যাপ্লিকেশন, সাইট বা সিস্টেমের ইঙ্গিত পেতে :
ক্লাউড কনসোল আপনার অ্যাপ্লিকেশন, সাইট বা সিস্টেমের বিস্তারিত তথ্য দেখায় না। কিন্তু আপনি আপনার ক্লায়েন্ট আইডি ট্র্যাফিকের উৎস সম্পর্কে কিছু ইঙ্গিত খুঁজে পেতে পারেন। এই ধাপগুলো অনুসরণ করুন:
- ক্লাউড কনসোলে মেট্রিক্স পৃষ্ঠাটি খুলুন।
- ড্রপ-ডাউন থেকে একটি ম্যাপস প্ল্যাটফর্ম পরিষেবা নির্বাচন করুন।
- নিম্নলিখিত সেটিংস ব্যবহার করে আপনার ব্যবহার ফিল্টার করুন:
- প্রমাণপত্র: শুধুমাত্র 'প্রকল্প_নম্বর:<সাংখ্যিক শনাক্তকারী>' নির্বাচন করুন।
- নিম্নলিখিত ফিল্টারটি সেট করুন।
- প্ল্যাটফর্ম বা ডোমেইন অনুসারে গ্রুপ করুন
- যেসব ম্যাপস প্ল্যাটফর্ম সার্ভিসের ট্র্যাফিক চেক করতে হবে, তার প্রতিটির জন্য ধাপ ২ থেকে পুনরাবৃত্তি করুন।
এপিআই কী প্রস্তুত করুন
সমস্ত ক্লায়েন্ট আইডি একটি গুগল ক্লাউড প্রজেক্টের সাথে যুক্ত থাকে, এবং সেই প্রজেক্টের একটি এপিআই কী ব্যবহার করে আপনি সেই একই ফিচারগুলো অ্যাক্সেস করতে পারবেন যা আপনি আগে আপনার ক্লায়েন্ট আইডি দিয়ে ব্যবহার করতেন। কোটা সংক্রান্ত সমস্যা বা কোনো ফিচারের অনুপস্থিতি এড়াতে, আমরা সংশ্লিষ্ট প্রজেক্টে স্থানান্তরিত হওয়ার পরামর্শ দিই।
- আপনার ক্লায়েন্ট আইডি যে ক্লাউড প্রজেক্টের সাথে লিঙ্ক করা আছে সেটি খুঁজুন:
- আপনার ক্লাউড প্রজেক্টটি একটি চালু বিলিং অ্যাকাউন্টের সাথে সংযুক্ত আছে কিনা, তা নিশ্চিত করুন।
- ক্লায়েন্ট আইডি মাইগ্রেশনের জন্য একটি নতুন এপিআই কী তৈরি করুন ।
- আপনি ক্লাউড প্রজেক্টে বিদ্যমান যেকোনো এপিআই কী পুনরায় ব্যবহার করতে পারেন।
- আপনি একই ক্লাউড প্রজেক্ট থেকে একাধিক এপিআই কী ব্যবহার করতে পারেন, উদাহরণস্বরূপ, প্রতিটি ম্যাপস প্ল্যাটফর্ম পরিষেবার জন্য ট্র্যাফিক আলাদা করতে, অথবা বিভিন্ন প্ল্যাটফর্ম (ব্রাউজার, মোবাইল অ্যাপ, ইত্যাদি) থেকে আসা ট্র্যাফিক আলাদা করতে। এপিআই কী ব্যবস্থাপনার সর্বোত্তম অনুশীলনের জন্য নিরাপত্তা নির্দেশিকা দেখুন।
আপনার এপিআই কী সুরক্ষিত করুন
অননুমোদিত অ্যাক্সেস থেকে আপনার এপিআই কী সুরক্ষিত রাখতে এটি সুরক্ষিত করুন।
- আপনার API কী-এর জন্য একটি অ্যাপ্লিকেশন সীমাবদ্ধতা সেট করুন (যেমন ওয়েবসাইট, আইপি অ্যাড্রেস, অ্যান্ড্রয়েড অ্যাপ বা আইওএস অ্যাপ)।
- আপনার এপিআই কী-এর জন্য এপিআই বিধিনিষেধ সেট করুন।
আরও বিস্তারিত জানতে গুগল ম্যাপস প্ল্যাটফর্মের নিরাপত্তা নির্দেশিকা দেখুন।
Maps JavaScript API, Maps Static API, এবং Street View Static API-এর জন্য, আপনি আপনার ক্লায়েন্ট আইডিতে থাকা বিশ্বস্ত রেফারারগুলোকে এপিআই কী বিধিনিষেধে স্থানান্তর করতে পারেন। আপনি ক্লাউড কনসোলে বিশ্বস্ত রেফারারগুলোর তালিকা খুঁজে পাবেন।
কোটা সেটিংস পর্যালোচনা করুন
আপনার ক্লাউড প্রজেক্টে প্রত্যাশিত কোটা সেটিংস আছে কিনা তা নিশ্চিত করুন। শুধুমাত্র তখনই আপনাকে এটি করতে হবে, যদি আপনি কোনো ক্লায়েন্ট আইডি থেকে ম্যাপস জাভাস্ক্রিপ্ট এপিআই-এর ক্লায়েন্ট-সাইড সার্ভিসগুলো কল করেন। আপনি গুগল ম্যাপস কোটাস পেজ- এ আপনার কোটা সেটিংস যাচাই ও সমন্বয় করতে পারেন।
কোটা প্রতিবেদন সম্পর্কে আরও জানুন
Maps JavaScript API ক্লায়েন্ট-সাইড পরিষেবাগুলির জন্য কোটা বৃদ্ধি
আপনি যদি ম্যাপস জাভাস্ক্রিপ্ট এপিআই-তে নিম্নলিখিত পরিষেবাগুলি ব্যবহার করে থাকেন, তাহলে এপিআই কী মাইগ্রেশনের পরে কোটার ব্যবহার বৃদ্ধি পেতে দেখবেন।
আপনার বর্তমান কোটা কনফিগারেশন ও ব্যবহার পর্যালোচনা করুন এবং সেই অনুযায়ী আপনার কোটার সীমা সমন্বয় করুন ।
- আপনি ক্লায়েন্ট আইডি দিয়ে ম্যাপস জাভাস্ক্রিপ্ট এপিআই ক্লায়েন্ট-সাইড পরিষেবা ব্যবহার করছেন কিনা তা যাচাই করুন।
- ক্লাউড কনসোলে মেট্রিক্স পৃষ্ঠাটি খুলুন।
- নিম্নলিখিত সেটিংস ব্যবহার করে আপনার ব্যবহার ফিল্টার করুন:
- এপিআই পদ্ধতি অনুসারে শ্রেণীবদ্ধ করা হয়েছে
- প্রমাণপত্র: শুধুমাত্র 'প্রকল্প_নম্বর:<সাংখ্যিক শনাক্তকারী>' নির্বাচন করুন।
- এরপরে, "ট্র্যাফিক বাই এপিআই মেথড" চার্টে আপনি মেথডের নাম এবং তার ট্র্যাফিকের একটি তালিকা দেখতে পাবেন।
এপিআই পদ্ধতি | ক্লায়েন্ট-সাইড পরিষেবা | কোটা সমন্বয় করার পরিষেবা |
google.routes.Directions.Javascript | দিকনির্দেশনা পরিষেবা | দিকনির্দেশনা এপিআই |
google.routes.DistanceMatrix.Javascript | দূরত্ব ম্যাট্রিক্স পরিষেবা | দূরত্ব ম্যাট্রিক্স এপিআই |
google.maps.Elevation.Javascript | উচ্চতা পরিষেবা | এলিভেশন এপিআই |
google.places.Geocoding.Javascript | জিওকোডিং পরিষেবা | জিওকোডিং এপিআই |
google.places.*.Javascript, যা google.places.Geocoding.Javascript থেকে ভিন্ন | স্থান গ্রন্থাগার | স্থান এপিআই |
- আপনি যদি ওই API মেথডগুলো ব্যবহার না করেন, তাহলে কোটা সেটিংস নিয়ে আপনাকে চিন্তা করতে হবে না, কারণ আপনার ক্লায়েন্ট আইডির ট্র্যাফিকই আপনার প্রোজেক্টের কোটা ব্যবহার করে ফেলে।
- আপনার ক্লায়েন্ট আইডি কোটার ব্যবহার অনুমান করুন
- প্রতিটি পরিষেবার জন্য, প্রতি সেকেন্ড এবং প্রতি দিন উভয় গ্র্যানুলারিটি পরীক্ষা করুন।
- প্রতি সেকেন্ডের গ্রাফ: প্রতি মিনিটে অতিরিক্ত কোটার প্রয়োজনের জন্য সর্বোচ্চ ট্র্যাফিককে ৬০ দিয়ে গুণ করুন।
- দৈনিক গ্রাফ: সর্বোচ্চ ট্র্যাফিকের সময়েই দৈনিক অতিরিক্ত কোটার প্রয়োজন হওয়া উচিত।
- সংশ্লিষ্ট ম্যাপস প্ল্যাটফর্ম পরিষেবাগুলিতে আপনার কোটা সমন্বয় করুন।
- ধাপ ১-এ প্রাপ্ত পদ্ধতির নামের উপর ভিত্তি করে সংশ্লিষ্ট পরিষেবাগুলিতে কোটা সমন্বয় করুন।
আপনার কোড আপডেট করুন
ক্লায়েন্ট প্যারামিটারকে কী প্যারামিটার দিয়ে প্রতিস্থাপন করুন
আপনার বহির্গামী GMP API কলগুলিতে প্রমাণীকরণ ক্রেডেনশিয়ালগুলি URL&client={value} থেকে URL&key={value} তে আপডেট করুন। যদি আপনার অ্যাপগুলি GMP পরিষেবাগুলি অ্যাক্সেস করার জন্য HTTP ব্যবহার করে থাকে, তবে সেগুলিকে HTTPS ব্যবহার করার জন্য আপডেট করুন।
রিপোর্টিংয়ের জন্য চ্যানেল প্যারামিটার আপডেট করুন
আপনার API অনুরোধগুলিতে চ্যানেল প্যারামিটার উল্লেখ করে আপনি প্রতিটি চ্যানেলের ব্যবহার ট্র্যাক করতে পারেন। API কী-গুলি চ্যানেল প্যারামিটারের জন্য শুধুমাত্র সাংখ্যিক মান সমর্থন করে। আপনি যদি চ্যানেল প্যারামিটারের জন্য কোনো অ-সাংখ্যিক মানের সাথে আপনার ক্লায়েন্ট আইডি ব্যবহার করেন, তবে এটিকে সমর্থিত কোনো সাংখ্যিক মানে আপডেট করুন।
আরও তথ্যের জন্য গুগল ম্যাপস প্ল্যাটফর্ম রিপোর্টিং দেখুন।
ওয়েব পরিষেবাগুলির জন্য স্বাক্ষর প্যারামিটার সরান
নিম্নলিখিত ওয়েব সার্ভিস এপিআইগুলো এপিআই কী দিয়ে অ্যাক্সেস করার ক্ষেত্রে সিগনেচার প্যারামিটারের প্রয়োজন নেই। শুধুমাত্র আপনার এপিআই অনুরোধগুলো থেকে সিগনেচার প্যারামিটারটি সরিয়ে দিন।
- দিকনির্দেশনা এপিআই (লেগ্যাসি)
- দূরত্ব ম্যাট্রিক্স এপিআই (লেগ্যাসি)
- জিওকোডিং এপিআই
- এলিভেশন এপিআই
- টাইম জোন এপিআই
আরও তথ্যের জন্য প্রিমিয়াম প্ল্যান ওভারভিউ দেখুন।
ইমেজারি এপিআই-এর জন্য স্বাক্ষর গোপনীয়তা
Maps Static API এবং Street View Static API-এর জন্য এখনও সিগনেচার প্যারামিটার প্রয়োজন। পরীক্ষার উদ্দেশ্যে এগুলি সিগনেচার ছাড়াই অল্প সংখ্যক অনুরোধ গ্রহণ করে, কিন্তু আপনার প্রোডাকশনে এটি একটি নির্দিষ্ট সীমায় পৌঁছালে ব্যর্থ হতে শুরু করে। আপনার ক্লায়েন্ট আইডির সাইনিং সিক্রেটটি পরিবর্তন করে এপিআই কী-এর জন্য ব্যবহৃত সিক্রেটটি ব্যবহার করুন। আপনি একই সাইনিং অ্যালগরিদম ব্যবহার করতে পারেন, কিন্তু আপনাকে অন্য একটি সাইনিং সিক্রেট ব্যবহার করতে হবে। আরও জানতে, "Use a Digital Signature" দেখুন।
আপনার ক্লায়েন্ট আইডি ট্র্যাফিক নিরীক্ষণ করুন
ডেপ্লয়মেন্টের পরে, ক্লাউড কনসোল ড্যাশবোর্ড ব্যবহার করে আপনার ট্র্যাফিক সফলভাবে স্থানান্তরিত হয়েছে কিনা তা নিশ্চিত করুন। আপনি আপনার ক্লায়েন্ট আইডি ট্র্যাফিকের হ্রাস দেখতে শুরু করবেন, যা ক্রেডেনশিয়াল অনুসারে গ্রুপ করার সময় ড্যাশবোর্ডে "project_number:123456" ফরম্যাটে দেখানো হয়।
আপনার ক্লায়েন্ট আইডি বিরতি দিন
আমরা ডেভেলপারদের মাইগ্রেশনের পরে ক্লায়েন্ট আইডি পজ করার জন্য দৃঢ়ভাবে সুপারিশ করছি। এর উদ্দেশ্য হলো আপনার ক্রেডেনশিয়ালকে যেকোনো অনাকাঙ্ক্ষিত ট্র্যাফিক থেকে সুরক্ষিত রাখা এবং এটি নিশ্চিত করা যে আপনার ক্লায়েন্ট আইডিতে অবশিষ্ট ব্যবহার গুরুতর নয় (যেমন টেস্টিং, ক্যাশে, বট, ইত্যাদি) এবং এটি ব্যবসায়িক প্রভাব না ফেলেই ত্রুটি দেখাতে পারে। আপনি ক্লাউড কনসোলে আপনার ক্লায়েন্ট আইডি পজ করতে পারেন। আরও বিস্তারিত জানতে প্রিমিয়াম প্ল্যান অথেন্টিকেশন ওভারভিউ দেখুন।
ক্লায়েন্ট আইডি স্ব-পরিষেবা অস্থায়ী পুনঃসক্রিয়করণ
যেহেতু মে ২০২৬-এ গুগল ম্যাপস প্ল্যাটফর্ম ক্লায়েন্ট আইডিগুলো পর্যায়ক্রমিক পরিষেবা বন্ধের পর্যায়ে প্রবেশ করেছে, তাই পরিষেবার প্রাপ্যতা আর নিশ্চিত নয়। নির্ধারিত পরিষেবা বন্ধের প্রক্রিয়ার অংশ হিসেবে পর্যায়ক্রমে অ্যাক্সেস সীমিত করা হবে। যদিও পরিষেবা সাধারণত কয়েক ঘণ্টার মধ্যে স্বয়ংক্রিয়ভাবে পুনরুদ্ধার হয়ে যায়, তবে অবিলম্বে পুনরুদ্ধারের প্রয়োজন হলে আপনি ম্যানুয়ালি অ্যাক্সেস পুনরায় সক্রিয় করতে পারেন।
জরুরি ভিত্তিতে অ্যাক্সেস পুনরুদ্ধার করতে, আপনি গুগল ক্লাউড কনসোলের মাধ্যমে সেলফ-সার্ভিস রিঅ্যাক্টিভেশন করতে পারেন:
- Google Maps Platform Credentials পৃষ্ঠায় যান।
- আপনার ক্লায়েন্ট আইডির সাথে সংযুক্ত নির্দিষ্ট ক্লাউড প্রজেক্টটি খুঁজে বের করুন।
- পরিষেবা পুনরুদ্ধার করতে এন্ট্রির একেবারে ডানদিকে অবস্থিত আনপজ আইকনটিতে ক্লিক করুন।
যদি আপনি দ্রুত এপিআই কী-তে স্থানান্তরিত হতে না পারেন এবং পরবর্তী বাধা থেকে সাময়িকভাবে অব্যাহতি পেতে চান, তাহলে অনুগ্রহ করে নিম্নলিখিত বিবরণসহ গুগল ম্যাপস প্ল্যাটফর্ম সাপোর্ট টিমের সাথে যোগাযোগ করুন:
- ক্লায়েন্ট আইডি
- নির্দিষ্ট ব্যবহারের ক্ষেত্র
- লক্ষ্য স্থানান্তর তারিখ
- ব্যবসায়িক প্রভাব মূল্যায়ন
ক্লায়েন্ট আইডি ব্যবহারের প্রতিবেদন - বিলিং রিপোর্ট থেকে
প্রজেক্ট মেট্রিক্সের অ্যাক্সেস নেই এমন ব্যবহারকারীদের জন্য—যেমন বিলিং অ্যাডমিনিস্ট্রেটর (বিশেষ করে ম্যাপস প্ল্যাটফর্ম পার্টনাররা)—প্রজেক্ট মেট্রিক্সের পরিবর্তে বিলিং রিপোর্ট দেখা উপকারী হতে পারে। যদিও বিলিং রিপোর্ট পেতে ১-২ দিন সময় লাগে, এর সুবিধা হলো এতে ৩০ দিনেরও বেশি সময়ের ব্যবহার এবং খরচের বিস্তারিত তথ্য দেখা যায়।
এই ধাপগুলো অনুসরণ করে আপনি গুগল ক্লাউড কনসোলের মাধ্যমে ক্লায়েন্ট আইডি ব্যবহার নিরীক্ষণ করতে পারেন:
- Google Cloud Console-এ Billing > Reports পৃষ্ঠায় যান।
- (ঐচ্ছিক, শুধুমাত্র পার্টনারদের জন্য প্রযোজ্য) কাঙ্ক্ষিত সাব-বিলিং অ্যাকাউন্টটি নির্বাচন করতে একটি ফিল্টার প্রয়োগ করুন।
-
goog-maps-api-key-suffixলেবেল কী দ্বারা রিপোর্টের ডেটা গ্রুপ করুন। এই লেবেলটি একটি এপিআই কী-এর শেষের অক্ষরগুলো প্রদর্শন করে। - যেসব এন্ট্রিতে
goog-maps-api-key-suffixলেবেলটি অনুপস্থিত বা খালি, সেগুলো খুঁজে ক্লায়েন্ট আইডি ট্র্যাফিক শনাক্ত করুন, কারণ ক্লায়েন্ট আইডি অনুরোধের জন্য এই লেবেলটি পূরণ করা হয় না। - যেসব SKU API অনুরোধের সাথে যুক্ত করার জন্য নয়, সেগুলোকে উপেক্ষা করুন—উদাহরণস্বরূপ, সাবস্ক্রিপশন SKU।
সমস্যা সমাধান
আমাদের অনুরোধটি ব্যর্থ হচ্ছে কি না, তা আমরা কীভাবে দেখতে পারি?
আপনি রেসপন্স কোড গ্রাফগুলিতে আপনার ত্রুটির পরিসংখ্যান দেখতে পারেন।
ApiNotActivatedMapError , অথবা REQUEST_DENIED ত্রুটি
আপনার ক্লাউড প্রজেক্টে সার্ভিসটি এনাবল না করলে আপনি ApiNotActivatedMapError বা REQUEST_DENIED এরর দেখতে পাবেন। সার্ভিসটি এনাবল করার জন্য নির্দেশাবলী অনুসরণ করুন।
RefererNotAllowedMapError ত্রুটি
আপনার সোর্স ডোমেইনটি এপিআই কী-তে যোগ করা না থাকলে আপনি RefererNotAllowedMapError ত্রুটিটি দেখতে পাবেন। "আপনার এপিআই কী সুরক্ষিত করুন" বিভাগটি দেখুন এবং আপনার ডোমেইনটি এপিআই কী-তে যোগ করুন।
OverQuotaMapError , অথবা OVER_QUERY_LIMIT ত্রুটি
আপনার কনফিগার করা কোটা আপনার ট্র্যাফিক সামাল দেওয়ার জন্য যথেষ্ট না হলে আপনি OverQuotaMapError বা OVER_QUERY_LIMIT দেখতে পাবেন। "কোটা সেটিংস পর্যালোচনা করুন" বিভাগটি দেখুন এবং সেই অনুযায়ী আপনার কোটা সামঞ্জস্য করুন।
এই এপিআই-তে করা অনুরোধ অবশ্যই 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"
}