ক্লায়েন্ট আইডি মাইগ্রেশন গাইড

এক নজরে

গুরুত্বপূর্ণ: যাচাইকরণ সংক্রান্ত নিরাপত্তা ও নির্ভরযোগ্যতা বাড়াতে, ২৬ মে, ২০২৫ থেকে Maps Platform ক্লায়েন্ট আইডি বন্ধ করে দেওয়া হয়েছে এবং ৩১ মে, ২০২৬-এর পরে আর ব্যবহার করা যাবে না।
ক্লায়েন্ট আইডি ব্যবহার করার পরিবর্তে, আপনার Google Maps API পরিষেবা ট্রাফিক যাচাই করতে আপনাকে অবশ্যই API Key ক্রেডেনশিয়াল ব্যবহার করতে হবে। এই নির্দেশিকা আপনাকে দেখায় যে কীভাবে ক্লায়েন্ট আইডি ব্যবহার করা থেকে API কী ব্যবহার করার জন্য মাইগ্রেট করতে হয়।

শুরু করতে এই ধাপগুলি অনুসরণ করুন:

1. বর্তমান ক্লায়েন্ট আইডির ব্যবহার চেক করা
2. API কী প্রস্তুত করুন
3. কোটা সেটিংস পর্যালোচনা করুন
4. আপনার কোড আপডেট করুন
5. আপনার ক্লায়েন্ট আইডি ট্রাফিক মনিটর করা
6. আপনার ক্লায়েন্ট আইডি পজ করুন
7. ক্লায়েন্ট আইডি সেল্ফ-সার্ভিস সাময়িক রিঅ্যাক্টিভেশন

বর্তমান ক্লায়েন্ট আইডির ব্যবহার চেক করুন

মাইগ্রেশন প্রসেস শুরু করার আগে, নিম্নলিখিত বিষয়গুলি তালিকাভুক্ত করুন:

• Maps Platform পরিষেবা যার সাথে আপনি নিজের ক্লায়েন্ট আইডি ব্যবহার করছেন।
• আপনি যে অ্যাপ্লিকেশন, সাইট বা সিস্টেমের সাথে আপনার ক্লায়েন্ট আইডি ব্যবহার করছেন।

Google, ২০২৫ সালের মে মাসে ক্লায়েন্ট আইডি বন্ধ হয়ে যাওয়া সম্পর্কে প্রভাবিত গ্রাহকদের বিজ্ঞপ্তি সংক্রান্ত ইমেল পাঠিয়েছে। আপনি বিজ্ঞপ্তি সংক্রান্ত ইমেলেও এই তথ্য দেখতে পাবেন।

Cloud Console-এ, আপনি Google Maps মেট্রিক্স পৃষ্ঠা-তে আপনার ক্লায়েন্ট আইডি ব্যবহারের লেটেস্ট স্ট্যাটাস চেক করতে পারবেন

Maps Platform পরিষেবার তালিকা দেখতে:

1. Cloud Console-এ মেট্রিক পৃষ্ঠা খুলুন।
2. নিম্নলিখিত সেটিংসের মাধ্যমে আপনার ব্যবহার ফিল্টার করুন:
   • ক্রেডেনশিয়াল: শুধুমাত্র "project_number:<numerical identifier>" বেছে নিন।
3. নিম্নলিখিত ফিল্টার সেট করুন।
   • এইভাবে গ্রুপ করা হয়েছে: API

অ্যাপ্লিকেশন, সাইট বা সিস্টেমের হিন্টের জন্য:

Cloud Console আপনার অ্যাপ্লিকেশন, সাইট বা সিস্টেমের বিবরণ দেখায় না। তবে, আপনার ক্লায়েন্ট আইডি ট্রাফিকের সোর্স সম্পর্কে কিছু ইঙ্গিত পেতে পারেন। এইসব ধাপ অনুসরণ করুন:

1. Cloud Console-এ মেট্রিক পৃষ্ঠা খুলুন।
2. ড্রপ-ডাউন থেকে Maps Platform পরিষেবা বেছে নিন।
3. নিম্নলিখিত সেটিংসের মাধ্যমে আপনার ব্যবহার ফিল্টার করুন:
   • ক্রেডেনশিয়াল: শুধুমাত্র "project_number:<numerical identifier>" বেছে নিন।
4. নিম্নলিখিত ফিল্টার সেট করুন।
   • এইভাবে গ্রুপ করুন: প্ল্যাটফর্ম বা ডোমেন
5. প্রতিটি Maps Platform পরিষেবার জন্য ধাপ ২ থেকে রিপিট করুন, যার জন্য আপনাকে ট্রাফিক চেক করতে হবে।

API কী প্রস্তুত করুন

সব ক্লায়েন্ট আইডি Google Cloud প্রোজেক্টের সাথে যুক্ত এবং সেই প্রোজেক্ট থেকে API কী ব্যবহার করলে আপনি সেই একই ফিচার অ্যাক্সেস করতে পারবেন যা আগে ক্লায়েন্ট আইডি দিয়ে অ্যাক্সেস করেছিলেন। কোটা বা ফিচার মিস হয়ে যাওয়া সংক্রান্ত সমস্যা এড়াতে, আমরা আপনাকে সংশ্লিষ্ট প্রোজেক্টে মাইগ্রেট করার সাজেশন দিই।

1. আপনার ক্লায়েন্ট আইডি যে ক্লাউড প্রোজেক্টের সাথে লিঙ্ক করা আছে সেটি খুঁজুন:
   • পোর্টাল মাইগ্রেশন সংক্রান্ত প্রায়শই জিজ্ঞাসিত প্রশ্ন
2. আপনার ক্লাউড প্রোজেক্ট কোনও খোলা বিলিং অ্যাকাউন্টের সাথে লিঙ্ক করা আছে কিনা তা ভাল করে দেখে নিন।
3. ক্লায়েন্ট আইডি মাইগ্রেশনের জন্য নতুন API key তৈরি করুন।
   • আপনি ক্লাউড প্রোজেক্টে আগে থেকে থাকা যেকোনও API কী আবার ব্যবহার করতে পারবেন।
   • আপনি একই ক্লাউড প্রোজেক্ট থেকে একাধিক API কী ব্যবহার করতে পারেন, যেমন, প্রতিটি Maps Platform পরিষেবার জন্য ট্রাফিক আলাদা করতে বা বিভিন্ন প্ল্যাটফর্ম (ব্রাউজার, মোবাইল অ্যাপ ইত্যাদি) থেকে ট্রাফিক আলাদা করতে। API key ম্যানেজ করার পেশাদার পদ্ধতি সম্পর্কে জানতে নিরাপত্তা নির্দেশিকা দেখুন।

আপনার API key সুরক্ষিত রাখুন

অননুমোদিত অ্যাক্সেস থেকে আপনার API key সুরক্ষিত রাখতে ভুলবেন না।

• আপনার API কী-এর জন্য অ্যাপ্লিকেশন সংক্রান্ত বিধিনিষেধ সেট করুন (যেমন, ওয়েবসাইট, IP অ্যাড্রেস, Android অ্যাপ বা iOS অ্যাপ)।
• আপনার API key-এর জন্য API সংক্রান্ত বিধিনিষেধ সেট করুন।

আরও তথ্যের জন্য Google Maps Platform-এর নিরাপত্তা সংক্রান্ত নির্দেশিকা দেখুন।

Maps JavaScript API, Maps Static API এবং Street View Static API-এর জন্য, আপনি ক্লায়েন্ট আইডিতে বিশ্বস্ত রেফারারকে API কী সংক্রান্ত বিধিনিষেধে মাইগ্রেট করতে পারবেন। আপনি Cloud Console-এ বিশ্বস্ত রেফারারের তালিকা দেখতে পাবেন।

কোটা সেটিংস পর্যালোচনা করুন

আপনার ক্লাউড প্রোজেক্টে প্রত্যাশিত কোটা সেটিংস আছে কিনা তা নিশ্চিত করুন। আপনি যদি ক্লায়েন্ট আইডি থেকে Maps JavaScript API ক্লায়েন্ট-সাইড পরিষেবা কল করেন, তাহলে আপনাকে শুধু এটি করতে হবে। আপনি Google Maps কোটা পৃষ্ঠা থেকে কোটা সেটিংস চেক ও অ্যাডজাস্ট করতে পারবেন।

কোটা রিপোর্ট সম্পর্কে আরও জানুন

Maps JavaScript API ক্লায়েন্ট-সাইড পরিষেবার জন্য কোটা বৃদ্ধি

সতর্কতা: Maps JavaScript API ক্লায়েন্ট-সাইড পরিষেবায় ক্লায়েন্ট আইডি ব্যবহার করলে প্রোজেক্ট কোটা খরচ হয় না। আপনি API key-তে মাইগ্রেট করলে, আপনার ব্যবহার প্রোজেক্ট কোটা ব্যবহার করবে। মাইগ্রেট করার আগে আপনার কাছে পর্যাপ্ত কোটা হেডরুম আছে কিনা তা নিশ্চিত করতে হবে।

আপনি Maps JavaScript API-তে নিম্নলিখিত পরিষেবা ব্যবহার করলে, API কী মাইগ্রেশনের পরে কোটার ব্যবহার বৃদ্ধি দেখতে পাবেন।

আপনার বর্তমান কোটা কনফিগারেশন, বর্তমান ব্যবহার পর্যালোচনা করুন এবং সেই অনুযায়ী আপনার কোটা সীমা অ্যাডজাস্ট করুন।

1. আপনি ক্লায়েন্ট আইডি সহ Maps JavaScript API ক্লায়েন্ট-সাইড পরিষেবা ব্যবহার করছেন কিনা তা চেক করুন।
   • Cloud Console-এ মেট্রিক পৃষ্ঠা খুলুন।
   • নিম্নলিখিত সেটিংসের মাধ্যমে আপনার ব্যবহার ফিল্টার করুন:
     • এইভাবে গ্রুপ করা হয়েছে: API পদ্ধতি
     • ক্রেডেনশিয়াল: শুধুমাত্র "project_number:<numerical identifier>" বেছে নিন।
   • তারপর, আপনি "API পদ্ধতি অনুযায়ী ট্রাফিক" চার্টে ট্রাফিক সহ পদ্ধতির নামের একটি তালিকা দেখতে পাবেন।

API পদ্ধতি	ক্লায়েন্ট-সাইড পরিষেবা	কোটা অ্যাডজাস্ট করার পরিষেবা
google.routes.Directions.Javascript	দিকনির্দেশ পরিষেবা	Directions API
google.routes.DistanceMatrix.Javascript	Distance Matrix Service	Distance Matrix API
google.maps.Elevation.Javascript	উচ্চতা সংক্রান্ত পরিষেবা	Elevation API
google.places.Geocoding.Javascript	জিওকোডিং পরিষেবা	Geocoding API
google.places.Geocoding.Javascript ছাড়া google.places.*.Javascript	জায়গার লাইব্রেরি	Places API

• আপনি যদি সেইসব API পদ্ধতি ব্যবহার না করেন, তাহলে কোটা সেটিংস নিয়ে আপনাকে চিন্তা করতে হবে না, কারণ আপনার ক্লায়েন্ট আইডি ট্রাফিক ইতিমধ্যেই আপনার প্রোজেক্ট কোটা ব্যবহার করে।
• আপনার ক্লায়েন্ট আইডি কোটার ব্যবহার অনুমান করুন
  • প্রতিটি পরিষেবার জন্য, প্রতি সেকেন্ড এবং প্রতি দিন গ্র্যানুলারিটি চেক করুন।
  • প্রতি সেকেন্ডের গ্রাফ: অতিরিক্ত কোটা প্রতি মিনিটের প্রয়োজনের জন্য পিক ট্রাফিককে ৬০ দিয়ে গুণ করুন।
  • প্রতিদিনের গ্রাফ: ট্রাফিক পিক হলে প্রতিদিনের অতিরিক্ত কোটা প্রয়োজন।
• সংশ্লিষ্ট Maps Platform পরিষেবায় আপনার কোটা অ্যাডজাস্ট করুন
  • ধাপ ১-এ আপনি যে পদ্ধতির নাম খুঁজে পেয়েছেন, তার ভিত্তিতে সংশ্লিষ্ট পরিষেবার কোটা অ্যাডজাস্ট করুন।

আপনার কোড আপডেট করুন

ক্লায়েন্ট প্যারামিটারকে মূল প্যারামিটার দিয়ে প্রতিস্থাপন করুন

আপনার আউটগোয়িং GMP API কলে যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল URL&client={value} থেকে URL&key={value}-এ আপডেট করুন। আপনার অ্যাপ GMP পরিষেবা অ্যাক্সেস করতে HTTP ব্যবহার করলে, HTTPS ব্যবহার করার জন্য সেগুলি আপডেট করুন।

রিপোর্টিংয়ের জন্য চ্যানেল প্যারামিটার আপডেট করা

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

আরও তথ্যের জন্য Google Maps Platform রিপোর্টিং দেখুন।

ওয়েব পরিষেবার জন্য সিগনেচার প্যারামিটার সরিয়ে দিন

নিম্নলিখিত ওয়েব সার্ভিস API-এর জন্য, আপনি API কী দিয়ে সেগুলি অ্যাক্সেস করলে সিগনেচার প্যারামিটার প্রয়োজন হয় না। আপনার API অনুরোধ থেকে শুধু সিগনেচার প্যারামিটার সরিয়ে দিন।

• Directions API (পুরনো ভার্সন)
• Distance Matrix API (পুরনো ভার্সন)
• Geocoding API
• Elevation API
• Time Zone API

আরও তথ্যের জন্য Premium প্ল্যানের ওভারভিউ দেখুন।

ইমেজেরি API-এর জন্য সাইনিং সিক্রেট

Maps Static API এবং Street View Static API-এর জন্য এখনও সিগনেচার প্যারামিটার প্রয়োজন। তারা পরীক্ষার উদ্দেশ্যে স্বাক্ষর ছাড়াই অল্প সংখ্যক অনুরোধ গ্রহণ করে, কিন্তু আপনার প্রোডাকশনে থ্রেশহোল্ডে পৌঁছে গেলে এটি ব্যর্থ হতে শুরু করে। আপনার সাইনিং সিক্রেট ক্লায়েন্ট আইডির পরিবর্তে API কী-এর জন্য ব্যবহার করুন। আপনি একই সাইনিং অ্যালগরিদম ব্যবহার করতে পারেন, তবে আপনাকে অন্য একটি সাইনিং সিক্রেট ব্যবহার করতে হবে। আরও জানতে, ডিজিটাল স্বাক্ষর ব্যবহার করুন দেখুন।

সতর্কতা: প্রোডাকশনে কোড পরিবর্তন ডিপ্লয় করার আগে যাচাই করুন যে এন্ড-টু-এন্ড ফাংশনালিটি প্রভাবিত হয়নি।

আপনার ক্লায়েন্ট আইডি ট্রাফিক মনিটর করা

ডেপ্লয়মেন্টের পরে, Cloud Console ড্যাশবোর্ড ব্যবহার করে আপনার ট্রাফিক সফলভাবে মাইগ্রেট করা হয়েছে কিনা তা কনফার্ম করুন। আপনি নিজের ক্লায়েন্ট আইডি ট্রাফিকে হ্রাস দেখতে শুরু করবেন, যা ক্রেডেনশিয়াল অনুযায়ী গ্রুপ করার সময় ড্যাশবোর্ডে "project_number:123456" ফর্ম্যাটে দেখানো হয়।

আপনার ক্লায়েন্ট আইডি পজ করা

আমরা ডেভেলপারদের মাইগ্রেশনের পরে ক্লায়েন্ট আইডি পজ করার জন্য বিশেষভাবে সাজেস্ট করি। এটি আপনার ক্রেডেনশিয়ালকে যেকোনও অনাকাঙ্ক্ষিত ট্রাফিক থেকে সুরক্ষিত রাখতে এবং আপনার ক্লায়েন্ট আইডিতে বাকি থাকা ব্যবহার যে গুরুত্বপূর্ণ নয় (যেমন, টেস্টিং, ক্যাশে, বট, …) এবং ব্যবসার উপর প্রভাব না ফেলে ত্রুটি দেখাতে পারে তা কনফার্ম করার জন্য করা হয়। আপনি Cloud Console-এ আপনার ক্লায়েন্ট আইডি পজ করতে পারবেন। আরও জানতে Premium প্ল্যান যাচাইকরণ সংক্রান্ত ওভারভিউ দেখুন।

ক্লায়েন্ট আইডি সেল্ফ-সার্ভিস সাময়িক রিঅ্যাক্টিভেশন

মে ২০২৬ থেকে Google Maps Platform ক্লায়েন্ট আইডি পর্যায়ক্রমে বন্ধ করার প্রক্রিয়া শুরু হওয়ার কারণে, পরিষেবা উপলভ্য থাকার ব্যাপারে আর কোনও নিশ্চয়তা দেওয়া হচ্ছে না। শিডিউল করা পরিষেবা বন্ধ করার প্রসেসের অংশ হিসেবে, অ্যাক্সেস পর্যায়ক্রমে সীমাবদ্ধ করা হবে। সাধারণত কয়েক ঘণ্টার মধ্যে পরিষেবা অটোমেটিক রিস্টোর হয়ে যায়, তবে অবিলম্বে রিস্টোর করতে চাইলে, আপনি ম্যানুয়ালি অ্যাক্সেস আবার অ্যাক্টিভেট করার বিকল্প বেছে নিতে পারেন।

অ্যাক্সেস জরুরি ভিত্তিতে ফিরিয়ে আনতে, আপনি Google Cloud Console-এর মাধ্যমে সেল্ফ-সার্ভিস রিঅ্যাক্টিভেশন করতে পারেন:

• Google Maps Platform-এর ক্রেডেনশিয়াল পৃষ্ঠায় নেভিগেট করুন।
• আপনার ক্লায়েন্ট আইডির সাথে লিঙ্ক করা নির্দিষ্ট ক্লাউড প্রোজেক্টটি খুঁজে নিন।
• পরিষেবা ফিরিয়ে আনতে এন্ট্রির একদম ডানদিকে থাকা আনপজ আইকনে ক্লিক করুন।

মনে রাখবেন: চূড়ান্ত বন্ধের তারিখ যত এগিয়ে আসবে, পরিষেবা বিঘ্নিত হওয়ার ঘটনা ও সময়কাল তত বৃদ্ধি পাবে। পরিষেবা যাতে নিরবচ্ছিন্নভাবে চলতে থাকে তা নিশ্চিত করতে, আমরা যত তাড়াতাড়ি সম্ভব API কী যাচাইকরণে মাইগ্রেট করার জন্য সুপারিশ করছি।

আপনি যদি API কী-তে দ্রুত মাইগ্রেট করতে না পারেন এবং সাময়িকভাবে আরও বাধা থেকে অব্যাহতি পেতে চান, তাহলে নিম্নলিখিত বিবরণ সহ Google Maps Platform সহায়তা টিমের সাথে যোগাযোগ করুন:

• ক্লায়েন্ট ID
• নির্দিষ্ট ব্যবহারের উদাহরণ
• মাইগ্রেশনের টার্গেট তারিখ
• ব্যবসার উপর প্রভাবের মূল্যায়ন

ক্লায়েন্ট আইডি ব্যবহার সংক্রান্ত রিপোর্ট - বিলিং রিপোর্ট থেকে

প্রোজেক্ট মেট্রিক্সের পরিবর্তে বিলিং রিপোর্ট চেক করা সেইসব ব্যবহারকারীর জন্য উপযোগী হতে পারে যাদের প্রোজেক্ট মেট্রিক্সে অ্যাক্সেস নেই—যেমন, বিলিং অ্যাডমিনিস্ট্রেটর (বিশেষ করে Maps Platform পার্টনার)। বিলিং রিপোর্টে ১-২ দিনের লেটেন্সি থাকলেও, এতে ৩০ দিনের বেশি সময়ের ব্যবহার ও খরচ সংক্রান্ত ইনসাইট দেখানো হয়।

আপনি Google Cloud Console-এর মাধ্যমে ক্লায়েন্ট আইডির ব্যবহার মনিটর করতে পারবেন। এর জন্য এইসব ধাপ অনুসরণ করুন:

1. Google Cloud Console-এর বিলিং > রিপোর্ট পৃষ্ঠায় যান।
2. (ঐচ্ছিক, শুধুমাত্র পার্টনারদের জন্য প্রাসঙ্গিক) পছন্দসই সাব-বিলিং অ্যাকাউন্ট বেছে নিতে ফিল্টার প্রয়োগ করুন।
3. লেবেল কী goog-maps-api-key-suffix অনুযায়ী রিপোর্টের ডেটা গ্রুপ করুন। এই লেবেলটি API key-এর শেষ অক্ষরগুলি দেখায়।
4. যেসব এন্ট্রিতে goog-maps-api-key-suffix লেবেল নেই বা খালি আছে সেগুলি খুঁজে ক্লায়েন্ট আইডি ট্রাফিক শনাক্ত করুন, কারণ ক্লায়েন্ট আইডি অনুরোধের জন্য এই লেবেল পূরণ করা হয় না।
5. API অনুরোধের সাথে যুক্ত করার জন্য নয় এমন SKU উপেক্ষা করুন—যেমন, সাবস্ক্রিপশন SKU।

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

আমাদের অনুরোধ ব্যর্থ হচ্ছে কিনা তা আমরা কীভাবে দেখতে পারি?

আপনি রেসপন্স কোড গ্রাফ থেকে আপনার সমস্যার পরিসংখ্যান চেক করতে পারবেন

ApiNotActivatedMapError বা REQUEST_DENIED-এর এরর

আপনি যদি নিজের ক্লাউড প্রোজেক্টে পরিষেবা চালু না করেন, তাহলে ApiNotActivatedMapError বা REQUEST_DENIED সমস্যা দেখতে পাবেন। পরিষেবা চালু করতে নির্দেশাবলী অনুসরণ করুন।

RefererNotAllowedMapErrorটি সমস্যা

আপনার সোর্স ডোমেন API কী-তে যোগ করা না থাকলে, আপনি RefererNotAllowedMapError সমস্যা দেখতে পাবেন। "আপনার API key সুরক্ষিত করুন" বিভাগটি চেক করুন এবং API key-তে আপনার ডোমেন যোগ করুন।

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"
}