Google Maps Platform রিপোর্টিং

Google Maps Platform-এ রিপোর্টিং, Google Cloud কনসোলে প্রাথমিক API ব্যবহার, কোটা এবং বিলিং তথ্যের পূর্বনির্ধারিত ভিজ্যুয়াল রিপোর্টের একটি সেট প্রদান করে। আপনার করা API কলের সংখ্যা, API ব্যবহারের কোটা পূরণ করার কত কাছাকাছি আপনি পৌঁছেছেন এবং সময়ের সাথে সাথে আপনার বিলিং ব্যবহারের উপর নজর রাখতে এইসব রিপোর্ট ব্যবহার করুন।

রিপোর্টের ধরনগুলির মধ্যে এগুলি অন্তর্ভুক্ত:

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

কোনও অনুরোধ ব্যবহার, কোটা ও বিলিং রিপোর্টে দেখা যাবে কিনা তা নির্ধারণকারী উত্তর স্ট্যাটাস ও উত্তর কোডের সম্পূর্ণ তালিকা পেতে, উত্তর স্ট্যাটাস ও রিপোর্ট দেখুন।

Google Maps Platform ব্যবহার, কোটা ও বিলিংয়ের রিপোর্ট Cloud Console ব্যবহার করে দেখুন।

ব্যবহার সংক্রান্ত রিপোর্ট

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

ব্যবহার সংক্রান্ত মেট্রিক টেবিল (অনুরোধ, সমস্যা ও লেটেন্সি) ও গ্রাফে (ট্রাফিক, সমস্যা ও লেটেন্সি) দেখানো হয়। ট্র্যাকিংয়ের উদ্দেশ্যে:

  • সব API: আপনি এইসব উপায়ে সব API-এর জন্য ব্যবহারের মেট্রিক ফিল্টার ও গ্রুপ করতে পারবেন:

    • সময়সীমা ও API অনুযায়ী ফিল্টার করুন।
    • প্রতিক্রিয়া কোড, API ও ক্রেডেনশিয়াল অনুযায়ী গ্রুপ করা ট্রাফিক, সমস্যা ও লেটেন্সি দেখুন।

  • নির্দিষ্ট API: আপনি এইসব উপায়ে কোনও নির্দিষ্ট API-এর জন্য ব্যবহারের মেট্রিক ফিল্টার ও গ্রুপ করতে পারবেন:

    • সময়সীমা, API ভার্সন, ক্রেডেনশিয়াল ও পদ্ধতি অনুযায়ী ফিল্টার করুন।
    • উত্তর কোড, API পদ্ধতি এবং ভার্সন ও ক্রেডেনশিয়াল অনুযায়ী গ্রুপ করা ট্রাফিক, সমস্যা ও লেটেন্সি দেখুন।

API ও পরিষেবা ড্যাশবোর্ড পৃষ্ঠা

API ও পরিষেবা ড্যাশবোর্ড আপনার প্রোজেক্টের জন্য চালু করা সব API-এর ব্যবহার সংক্রান্ত মেট্রিকের ওভারভিউ প্রদান করে: Google Maps Platform API-এর পাশাপাশি অন্যান্য API ও পরিষেবা।

  • ড্যাশবোর্ড পৃষ্ঠায় তিনটি গ্রাফ ও একটি টেবিল থাকে। আপনি ১ ঘণ্টা থেকে শুরু করে গত ৩০ দিন পর্যন্ত সময়সীমা বেছে নিয়ে গ্রাফ ও টেবিলে দেখানো ব্যবহার ফিল্টার করতে পারবেন।

  • ট্রাফিক গ্রাফে প্রতি API-তে প্রতি মিনিটে কোয়েরি (QPM) হিসেবে ব্যবহার দেখানো হয়।

  • সমস্যা গ্রাফে API পিছু সমস্যার কারণে অনুরোধের শতাংশ দেখানো হয়।

  • লেটেন্সি গ্রাফ, API পিছু অনুরোধের মিডিয়ান লেটেন্সি দেখায়।

গ্রাফের নিচে, একটি সারণীতে চালু করা API এবং পরিষেবাগুলির তালিকা দেওয়া আছে। অনুরোধের সংখ্যা হল অনুরোধের সংখ্যা (বেছে নেওয়া সময়সীমার জন্য)। সমস্যার সংখ্যা হল এইসব অনুরোধের সংখ্যা যার ফলে সমস্যা হয়েছে। লেটেন্সি (মাঝারি লেটেন্সি ও পার্সেন্টাইল) হল এইসব অনুরোধের লেটেন্সি।

API মনিটর করার উদাহরণ

API ও পরিষেবা ড্যাশবোর্ড পৃষ্ঠা অ্যাক্সেস করতে:

  1. Cloud Console-এ প্রোজেক্ট বাছাইকারী পৃষ্ঠা খুলুন:

    প্রোজেক্ট সিলেক্টর পৃষ্ঠা

  2. আপনার প্রোজেক্ট বেছে নিন। API ও পরিষেবা ড্যাশবোর্ড পৃষ্ঠা দেখতে পাবেন।

    পৃষ্ঠাটি দেখতে না পেলে, মেনু বোতাম মেনু বেছে নিন এবং তারপর API ও পরিষেবা বিকল্প বেছে নিন।

আরও তথ্যের জন্য, আপনার API ব্যবহার মনিটর করা দেখুন।

Google Maps-এর ওভারভিউ পৃষ্ঠা

Google Maps-এর এক নজরে পৃষ্ঠায় একটি টেবিল আছে যেখানে চালু থাকা API এবং গত ৩০ দিনের ব্যবহারের অনুরোধের তালিকা দেওয়া আছে। API-এর মাধ্যমে করা অনুরোধও গ্রাফের আকারে দেখানো হয়। বিলিং গ্রাফে আপনার বর্তমান বিল ও গত ৩ মাসের মোট ব্যবহার দেখানো হয়।

গত ৩০ দিনের জন্য চালু করা API এবং API অনুরোধের তালিকা সহ একটি ওভারভিউ চার্ট।

Google Maps Platform-এর ওভারভিউ পৃষ্ঠা অ্যাক্সেস করতে:

  1. Cloud কনসোলে Google Maps Platform পৃষ্ঠা খুলুন:

    Google Maps Platform পৃষ্ঠায় যান

  2. বাঁদিকের মেনু থেকে, এক নজরে বিকল্প বেছে নিন।

Google Maps Platform API ও পরিষেবা পৃষ্ঠা

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

apis

Google Maps Platform API ও পরিষেবা পৃষ্ঠা অ্যাক্সেস করতে:

  1. Cloud কনসোলে Google Maps Platform পৃষ্ঠা খুলুন:

    Google Maps Platform পৃষ্ঠায় যান

  2. বাঁদিকের মেনু থেকে, API ও পরিষেবা বিকল্প বেছে নিন।

Google Maps-এর মেট্রিক্স পৃষ্ঠা

Google Maps-এর মেট্রিক্স পৃষ্ঠায় তিনটি গ্রাফ দেখানো হয়: ট্রাফিক, সমস্যা ও মিডিয়ান লেটেন্সি। গ্রাফে দেখানো ব্যবহারের ডেটা রেসপন্স কোড ক্লাস, API, API পদ্ধতি, ক্রেডেনশিয়াল, প্ল্যাটফর্ম ও ডোমেন অনুযায়ী গ্রুপ করা যেতে পারে।

গ্রাফের নিচে, মেট্রিক্স পৃষ্ঠায় একটি API টেবিল থাকে যা আপনার বেছে নেওয়া API-এর অনুরোধ, সমস্যা ও লেটেন্সি দেখায়।

উপরে API ড্রপ-ডাউন এবং ডানদিকের প্যানেলে গ্রুপ করা ও ফিল্টার করার বিকল্প ব্যবহার করে, নির্দিষ্ট বা একাধিক API, ক্রেডেনশিয়াল, রেসপন্স কোড ক্লাস, প্ল্যাটফর্মের ধরন ও ডোমেন বেছে নিয়ে, আপনি দেখানো ব্যবহারের মেট্রিক গ্রুপ ও ফিল্টার করতে পারবেন। এছাড়াও, আপনি দেখানো ব্যবহারের মেট্রিকের জন্য একটি সময়সীমা (এক ঘণ্টা থেকে শেষ ৩০ দিন পর্যন্ত) এবং গ্র্যানুলারিটি (প্রতি সেকেন্ড বা দিন) বেছে নিতে পারবেন।

মেট্রিক্স পৃষ্ঠায় তিনটি গ্রাফ দেখানো হয়েছে: ট্রাফিক, সমস্যা ও মিডিয়ান লেটেন্সি।

এইভাবে গ্রুপ করা হয়েছে ড্রপ-ডাউন তালিকা থেকে প্ল্যাটফর্ম এবং ডোমেন বেছে নিলে, নির্দিষ্ট API-এর জন্য প্ল্যাটফর্ম এবং ডোমেন ফিল্টার নিম্নলিখিত ছবিতে দেখানো হয়েছে:

একটি API বেছে নেওয়া হলেই শুধুমাত্র প্ল্যাটফর্ম ফিল্টার দেখা যায়। একটি API বেছে নেওয়া হলেই শুধুমাত্র প্ল্যাটফর্ম ফিল্টার দেখা যায়।

Google Maps Platform API মেট্রিক পৃষ্ঠা অ্যাক্সেস করতে:

  1. Cloud Console-এ Google Maps Platform পৃষ্ঠা খুলুন:

    Google Maps Platform পৃষ্ঠায় যান

  2. বাঁদিকের মেনু থেকে, মেট্রিক বিকল্প বেছে নিন।

ক্রেডেনশিয়াল সংক্রান্ত অভিযোগ

API লোড করার জন্য ব্যবহৃত ক্রেডেনশিয়াল অনুযায়ী আপনি মেট্রিক ফিল্টার ও গ্রুপ করতে পারবেন।

ক্রেডেনশিয়ালের ফর্ম্যাট অর্থ
কীয়ের নাম
যেমন, "মোবাইল অ্যাপ কী"		 API লোড করার জন্য API key ব্যবহার করা হয়েছে, ?key=... ব্যবহার করে: আপনি Maps Platform Console-এর কী ও ক্রেডেনশিয়াল বিকল্পে কী-এর নাম দেখতে পাবেন।
প্রোজেক্ট নম্বর
যেমন, "project_number:123456", যেখানে ১২৩৪৫৬ হল আপনার প্রোজেক্ট নম্বর।		 আপনি এই ক্রেডেনশিয়াল দেখলে, দুটি সম্ভাবনা আছে:
  1. Maps Platform ক্লায়েন্ট আইডি গ্রহণ করে এমন API-এর জন্য: ক API লোড করার জন্য Maps Platform ক্লায়েন্ট আইডি ব্যবহার করা হয়েছে। যেমন, &client=gme-_mycompany_ ব্যবহার করে।

    এইসব API ক্লায়েন্ট আইডি গ্রহণ করে: Maps JavaScript API, Maps Static API, Street View Static API, Elevation API, Directions API (Legacy), Distance Matrix API (Legacy), Geocoding API, Time Zone API. আরও তথ্যের জন্য, প্রিমিয়াম প্ল্যান ক্লায়েন্ট আইডি ম্যানেজমেন্ট দেখুন।

  2. OAuth গ্রহণ করে এমন API-এর জন্য: API কী ছাড়াই OAuth ব্যবহার করে API লোড করা হয়েছে।

প্রতিক্রিয়া কোডের গ্রাফ

রেসপন্স কোড অনুযায়ী ট্রাফিক এবং রেসপন্স কোড অনুযায়ী সমস্যা গ্রাফ HTTP রেসপন্স কোড ক্লাস অনুযায়ী ব্যবহারকে ভাগ করে। এই সারণী Google Maps Platform API রেসপন্স স্ট্যাটাস এবং HTTP রেসপন্স কোড ক্লাসের মধ্যে ম্যাপিং দেখায়:

Maps API স্ট্যাটাস HTTP রেসপন্স কোড ক্লাস - ব্যবহারের রিপোর্ট
(2xx, 3xx, 4xx, 5xx)		 নোট
ঠিক আছে 2xx সফল উত্তর।

এটি একটি বিলযোগ্য অনুরোধ এবং কোটা ব্যবহার করবে।
ঠিক আছে ৩xx সফল উত্তর।

এটি একটি বিলযোগ্য অনুরোধ এবং কোটা ব্যবহার করবে।

যেমন, ছবি যোগ করুন সফল অনুরোধের ক্ষেত্রে রেফারেন্স করা ছবিতে ৩০২ রিডাইরেক্ট করা হয়।
DATA_NOT_AVAILABLE 4xx(১) সফল উত্তর যা থেকে বোঝা যায় যে ইনপুট লোকেশনের জন্য কোনও উপলভ্য ডেটা নেই।

এটি একটি বিলযোগ্য অনুরোধ এবং কোটা ব্যবহার করবে।
ZERO_RESULTS 4xx(1) সফল উত্তর কোনও ফলাফল দেখায়নি।

এটি একটি বিলযোগ্য অনুরোধ এবং কোটা ব্যবহার করবে।
NOT_FOUND 4xx(1)

Directions API (Legacy)-এর ক্ষেত্রে, এই মেসেজ থেকে বোঝা যায় যে অনুরোধের শুরু, গন্তব্য বা ওয়েপয়েন্টে উল্লেখ করা লোকেশনের মধ্যে অন্তত একটিকে জিওকোড করা যায়নি।

Places API-এর ক্ষেত্রে এই মেসেজ থেকে বোঝা যায় যে রেফারেন্স করা লোকেশন (place_id) Places ডেটাবেসে পাওয়া যায়নি।

এটি একটি বিলযোগ্য অনুরোধ এবং কোটা ব্যবহার করবে।
INVALID_REQUEST (ভুল প্যারামিটার ভ্যালু),
MAX_WAYPOINTS_EXCEEDED,
MAX_ROUTE_LENGTH_EXCEEDED এবং অন্যান্য। 		4xx প্যারামিটারের ভুল মানের কারণে সমস্যা হয়েছে। আরও বিবরণের জন্য API উত্তর চেক করুন।

এটি একটি বিলযোগ্য অনুরোধ এবং কোটা ব্যবহার করবে।
REQUEST_DENIED 4xx যাচাইকরণ সংক্রান্ত সমস্যা, অ্যাক্সেস সংক্রান্ত সমস্যা এবং অন্যান্য কারণে ক্লায়েন্ট সংক্রান্ত সমস্যা। আরও বিবরণের জন্য API রেসপন্স চেক করুন।
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
rateLimitExceeded,
dailyLimitExceeded,
userRateLimitExceeded		 4xx অনুমোদিত সময়সীমার মধ্যে অনেক বেশি অনুরোধ করার কারণে ক্লায়েন্ট সংক্রান্ত সমস্যা হয়েছে। পরে আবার অনুরোধ করার চেষ্টা করুন। আরও বিবরণের জন্য API রেসপন্স চেক করুন।
INVALID_REQUEST (ভুল বা অনুপস্থিত প্যারামিটার, অনুরোধ পার্সিং বা যাচাইকরণ সংক্রান্ত সমস্যা) 4xx ভুল অনুরোধের কারণে ক্লায়েন্ট সংক্রান্ত সমস্যা হয়েছে। আরও বিবরণের জন্য API উত্তর চেক করুন।
NOT_FOUND (404) 4xx এর জন্য

Directions API (Legacy), এই মেসেজ থেকে বোঝা যায় যে অনুরোধের মধ্যে উল্লেখ করা অন্তত একটি লোকেশনের অরিজিন, ডেস্টিনেশন বা ওয়েপয়েন্ট জিওকোড করা যায়নি।

জিওলোকেশন API-এর জন্য, এই মেসেজ থেকে বোঝা যায় যে লোকেশন সম্পর্কে আনুমানিক তথ্য পাওয়ার জন্য ইনপুট যথেষ্ট ছিল না।

Roads API-এর ক্ষেত্রে, এই মেসেজ থেকে বোঝা যায় যে ইনপুটকে যুক্তিসঙ্গতভাবে রাস্তার সাথে স্ন্যাপ করা যায়নি।

এটি একটি বিলযোগ্য অনুরোধ এবং কোটা ব্যবহার করবে।
UNKNOWN_ERROR 5xx সার্ভার সংক্রান্ত সমস্যা যা ইঙ্গিত করে যে অনুরোধ প্রসেস করা যাবে না: ইন্টার্নাল সমস্যা, পরিষেবা ওভারলোড, উপলভ্য নেই, টাইম আউট এবং অন্যান্য।

১ ত্রুটি কোড রিপোর্টিংয়ের ধারাবাহিকতা উন্নত করতে, Google Maps Platform API মাইগ্রেট করছে: ১) Maps API স্ট্যাটাসের জন্য HTTP রেসপন্স কোড ক্লাস 2xx থেকে 4xx-এ: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - স্ট্যাটাস, ২) Maps API স্ট্যাটাসের জন্য HTTP রেসপন্স কোড ক্লাস 2xx থেকে 4xx-এ: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, ৩) Maps API স্ট্যাটাসের জন্য HTTP রেসপন্স কোড ক্লাস 2xx থেকে 5xx-এ: UNKNOWN_ERROR. ট্রানজিশন পিরিয়ড চলাকালীন আপনি দুটি রেসপন্স কোডই দেখতে পাবেন। Maps API-এর উত্তরে ফিরে আসা রেসপন্স কোড পরিবর্তিত হচ্ছে না। Google Maps Platform মেট্রিক্সে 4xx এবং/অথবা 5xx বৃদ্ধি এই মাইগ্রেশনের সাথে সম্পর্কিত কিনা তা নিশ্চিত করুন। এর জন্য, মেট্রিক্স এক্সপ্লোরার-এ কোন সঠিক রেসপন্স কোড বৃদ্ধি পেয়েছে তা চেক করুন (Google Maps Platform-এর জন্য Google Cloud Monitoring ব্যবহার করা সম্পর্কে আরও জানুন)।

স্ট্যাটাস কোড ও সমস্যার মেসেজ সম্পর্কে আরও জানতে, আপনার আগ্রহের API-এর জন্য উত্তর সংক্রান্ত ডকুমেন্টেশন দেখুন (যেমন, জিওকোডিং উত্তর বা দিকনির্দেশ সংক্রান্ত উত্তর)।

Google Maps Platform ব্যবহারের অ্যাট্রিবিউশন প্যারামিটার

Google Maps Platform আপনাকে দ্রুত কাজ শুরু করতে সাহায্য করার জন্য অনেক ধরনের নমুনা কোড প্রদান করে। যেমন, আপনি Cloud Console-এ দ্রুত বিল্ডার ব্যবহার করতে, ইন্ডাস্ট্রি সলিউশন ইমপ্লিমেন্টেশন গাইড অনুসরণ করতে এবং কোডল্যাব থেকে শিখতে পারেন।

আমাদের সমাধান কীভাবে ব্যবহার করা হয় এবং কীভাবে তা উন্নত করা যায় তা বুঝতে, Google API কলে internal_usage_attribution_ids প্যারামিটার যোগ করে। এর ফলে, স্যাম্পেল কোড ব্যবহার সম্পর্কিত তথ্য সংগ্রহ করা যায়:

  • সমাধানের স্যাম্পেল কোডে ডিফল্ট হিসেবে internal_usage_attribution_ids প্যারামিটার অন্তর্ভুক্ত থাকতে পারে।
  • ভবিষ্যতে সমাধানের কোয়ালিটি উন্নত করতে এই প্যারামিটার Google-কে সমাধান গ্রহণ করা সংক্রান্ত অ্যানালিটিক্স প্রদান করে।
  • আপনি স্যাম্পেল কোড থেকে internal_usage_attribution_ids প্যারামিটার ও তার ভ্যালু মুছে দিয়ে অপ্ট-আউট করতে পারবেন।
  • প্যারামিটার রাখার কোনও প্রয়োজন নেই। প্যারামিটার সরিয়ে দিলে পারফর্ম্যান্সের উপর কোনও প্রভাব পড়ে না।
  • এই প্যারামিটারটি শুধুমাত্র স্যাম্পেল কোড ব্যবহারের রিপোর্টিংয়ের জন্য ব্যবহার করা হয়।
  • প্যারামিটারটি যেকোনও API-নির্দিষ্ট অ্যানালিটিক্স এবং রিপোর্টিং থেকে আলাদা। অর্থাৎ, সলিউশন স্যাম্পেল কোড থেকে প্যারামিটার সরিয়ে দিলেও ইন্টার্নাল Maps JavaScript API রিপোর্টিং বন্ধ হয়ে যায় না।

কোটা রিপোর্ট

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

Cloud কনসোলের কোটা পৃষ্ঠায় গ্রাফে কোটা ব্যবহার দেখানো হয় এবং প্রতি মিনিটের অনুরোধের ভিত্তিতে গ্রুপ করা যায়। বেছে নেওয়া API-এর বর্তমান কোটা সীমা কোটা ব্যবহারের গ্রাফের নিচে টেবিলে দেখানো হয়।

যেকোনও GMP API প্রোডাক্টের জন্য আপনার প্রতি মিনিটের কোটার ভ্যালু পেতে, এই ক্যালকুলেটর ব্যবহার করুন।

Google Maps কোটা পৃষ্ঠা

Google Maps-এর কোটা পৃষ্ঠায় আপনার বেছে নেওয়া নির্দিষ্ট API-এর জন্য কোটার সীমা ও কোটা ব্যবহার দেখানো হয়।

Google Cloud কনসোলে কোটা ব্যবহারের চার্ট আপনার API কী এবং ক্লায়েন্ট আইডির জন্য মোট ট্রাফিক দেখায়। ক্লায়েন্ট আইডি ট্রাফিক Cloud Console-এর মেট্রিক চার্টেও উপলভ্য।

এই পৃষ্ঠায় শুধু সেইসব অনুরোধ দেখানো হয় যেগুলি কোটা ব্যবহার করে: সফল অনুরোধ (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) এবং যেসব অনুরোধের কারণে সার্ভার সংক্রান্ত সমস্যা হয় (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (ভুল প্যারামিটার ভ্যালু) এবং UNKNOWN_ERROR)।

ক্লায়েন্ট সংক্রান্ত সমস্যার কারণে হওয়া অনুরোধ — যাচাইকরণ, অনুমোদন এবং ভুল আর্গুমেন্ট সংক্রান্ত সমস্যা (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST (ভুল প্যারামিটার, অনুরোধ পার্সিং সংক্রান্ত সমস্যা)) — কোটা ব্যবহার করে না এবং দেখানো হয় না।

বেশিরভাগ Google Maps Platform API-এর ( Maps Static API, Street View Static API, Geocoding API, Directions API (Legacy), Places API, Time Zone API, Geolocation API, এবং Elevation API) জন্য কোটা ইউনিট হল অনুরোধ, তবে কিছু ব্যতিক্রম আছে:

  • Distance Matrix API (Legacy)-এর জন্য কোটা ইউনিট হল একটি এলিমেন্ট যা একটি উৎস-গন্তব্য পেয়ার।
  • Maps JavaScript API-এর জন্য কোটা ইউনিট হল ম্যাপ লোড।
  • Android-এর জন্য Maps SDK এবং iOS-এর জন্য Maps SDK-এর ক্ষেত্রে, কোটা ইউনিট হল Street View সংক্রান্ত অনুরোধ বা প্যানোরামা লোড। ম্যাপ লোড করার সুবিধা বিনামূল্যে উপলভ্য এবং এটি কোটা ব্যবহার করে না।

Google Cloud Console-এ Maps-এর কোটা পৃষ্ঠায়, কোনও সিলেক্টর ব্যবহার করে API অনুযায়ী কোটা দেখানো হয়, তারপর প্রশ্ন করা API-এর জন্য সেট করা কোটার তুলনায় ম্যাপ লোড দেখানো হয়।

Google Maps Platform কোটা পৃষ্ঠা অ্যাক্সেস করতে:

  1. Cloud Console-এ Google Maps Platform পৃষ্ঠা খুলুন:

    Google Maps Platform পৃষ্ঠায় যান

  2. বাঁদিকের মেনু থেকে, কোটা বিকল্প বেছে নিন।
  3. API ড্রপ-ডাউন তালিকা থেকে একটি API বেছে নিন।

বরাদ্দ ইউনিট

এই সারণী Google Maps Platform API-এর কোটা ইউনিট দেখায়।

Google Maps Platform API কোটা ইউনিট
Maps
Android-এর জন্য Maps SDK ১টি প্যানোরামা
iOS-এর জন্য Maps SDK ১টি প্যানোরামা
Map Tiles API ১টি অনুরোধ
Maps Aerial View API ১টি অনুরোধ
Maps Static API ১টি অনুরোধ
Maps JavaScript API ১টি ম্যাপ লোড
Street View Static API ১টি অনুরোধ
Maps Embed API ১টি ম্যাপ লোড
রুট
Routes API (Compute Routes) ১টি অনুরোধ
Routes API (কম্পিউট রুট ম্যাট্রিক্স) ১টি এলিমেন্ট (সোর্স-ডেস্টিনেশন পেয়ার)
Directions API (Legacy) ১টি অনুরোধ
Distance Matrix API (Legacy) ১টি এলিমেন্ট (সোর্স-ডেস্টিনেশন পেয়ার)
Roads API ১টি অনুরোধ
Route Optimization API ১টি অনুরোধ
Android-এর জন্য নেভিগেশন SDK ১টি গন্তব্য
iOS-এর জন্য নেভিগেশন SDK ১টি গন্তব্য
জায়গা
Places API ১টি অনুরোধ
Places Aggregate API ১টি অনুরোধ
ঠিকানা যাচাইকরণ API ১টি অনুরোধ
Geocoding API ১টি অনুরোধ
Geolocation API ১টি অনুরোধ
Time Zone API ১টি অনুরোধ
Maps Grounding Lite ১টি অনুরোধ
পরিবেশ
Air Quality API (CurrentConditions এবং HeatmapTile) ১টি অনুরোধ
Air Quality API (ইতিহাস) ১টি পৃষ্ঠা
Pollen API ১টি অনুরোধ
Solar API ১টি অনুরোধ
Weather API ১টি অনুরোধ

বিলিং রিপোর্ট

আপনার বিলিং রিপোর্ট দেখা

Google Maps Platform প্রোডাক্ট ব্যবহারের জন্য বিলিং রিপোর্ট Google Cloud কনসোলে উপলভ্য। আরও তথ্যের জন্য, বিলিং দেখুন।

বিলিং রিপোর্ট অ্যাক্সেস করতে:

  1. Cloud Console-এ প্রোজেক্ট বাছাইকারী পৃষ্ঠা খুলুন:

    প্রোজেক্ট বেছে নেওয়ার পৃষ্ঠা

  2. প্রোজেক্ট বেছে নিন।
  3. 'মেনু' বোতাম মেনু বেছে নিন এবং তারপরে বিলিং বিকল্প বেছে নিন।
  4. আপনার একাধিক বিলিং অ্যাকাউন্ট থাকলে, লিঙ্ক করা বিলিং অ্যাকাউন্টের ওভারভিউ পৃষ্ঠা খুলতে, লিঙ্ক করা বিলিং অ্যাকাউন্টে যান বিকল্প বেছে নিন।
  5. লিঙ্ক করা বিলিং অ্যাকাউন্টের জন্য বিলিং রিপোর্ট পৃষ্ঠা খুলতে, বাঁদিকের মেনু থেকে রিপোর্ট বিকল্প বেছে নিন ।

বিলিং রিপোর্ট চার্ট কীভাবে পড়তে হয়

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

বিলিং রিপোর্টের স্ক্রিনশট, যেখানে ডিফল্ট প্রিসেট ভিউ ব্যবহার করে চার্ট ও টেবিল দেখানো হচ্ছে
ছবি ১: ডিফল্ট প্রিসেট ভিউ ব্যবহার করে চার্ট ও টেবিল দেখানো বিলিং রিপোর্ট।

পরামর্শ: SKU প্রতি ব্যবহার ও খরচ বিশ্লেষণ করুন

পে-অ্যাজ-ইউ-গো প্রাইসিং মডেলের বিবরণ এবং এটি কীভাবে আপনার প্রয়োগকে প্রভাবিত করে তা আরও সঠিকভাবে বুঝতে, SKU অনুযায়ী আপনার ব্যবহার এবং খরচ দেখুন।

SKU অনুযায়ী গ্রুপ করা বিলিং রিপোর্ট
ছবি ২: বিলিং টেবিলে SKU অনুযায়ী ব্যবহার ও খরচের লাইন আইটেম দেখানো হয়েছে।
বিলিং রিপোর্ট ফিল্টারের স্ক্রিনশট
ছবি ৩: বিলিং রিপোর্ট ফিল্টার।
SKU অনুযায়ী লাইন আইটেম দেখাতে রিপোর্টের ভিউ পরিবর্তন করতে:
  1. চার্টের ডানদিকে থাকা প্যানেলে, গ্রুপ অনুযায়ী ফিল্টার বড় করুন।
  2. SKU বেছে নিন।

অন্যান্য উপলভ্য বিলিং রিপোর্ট ফিল্টারের মধ্যে রয়েছে সময়ের ব্যাপ্তি, প্রোজেক্ট, প্রোডাক্ট, SKU এবং লোকেশন, যা আপনাকে এর মাধ্যমে ফিল্টার করতে দেয় যে কোথায় API অনুরোধ পরিবেশন করা হয়েছে।

প্রোডাক্ট ছাড়াও আপনার ব্যবহারের সোর্সকে শ্রেণীবদ্ধ করতে, তালিকাভুক্ত ভ্যালুগুলির মধ্যে একটির মাধ্যমে গ্রুপ বিলিং রিপোর্ট করুন। Google Maps Platform API-এর সাথে সম্পর্কিত তিনটি কী হল goog-maps-api-key-suffix (API কী-এর শেষ চারটি অক্ষর), goog-maps-platform-type (প্ল্যাটফর্ম: Android, iOS, JavaScript বা ওয়েব পরিষেবা) এবং goog-maps-channel (API কোয়েরি থেকে সেট করা সংখ্যাসূচক চ্যানেল ভ্যালু)। ফিল্টার ও গ্রুপ করা সংক্রান্ত আরও তথ্য।

ডানদিকের প্যানেলে খরচে ক্রেডিট অন্তর্ভুক্ত করুন চেকবক্স থেকে টিকচিহ্ন সরিয়ে দিয়ে আপনি চার্ট ভিউ পরিবর্তন করতে পারবেন যাতে ব্যবহার-নির্দিষ্ট ক্রেডিট বাদ দেওয়া যায়।

ব্যবহার মনিটর ও সীমিত করা

আপনার বাজেট প্ল্যান করতে এবং খরচ নিয়ন্ত্রণ করতে সাহায্য করার জন্য, আপনি নিম্নলিখিত কাজগুলি করতে পারেন:

  • বাজেট সেট করা

    অ্যালার্ট সেট করুন, যাতে নির্দিষ্ট পরিমাণ অর্থ খরচ করার দিকে আপনার খরচ কীভাবে বাড়ছে তা ট্র্যাক করতে পারেন। বাজেট API ব্যবহারকে সীমাবদ্ধ করে না, আপনার খরচের পরিমাণ নির্দিষ্ট পরিমাণের কাছাকাছি পৌঁছে গেলে এটি আপনাকে সতর্ক করে।

  • আপনার দৈনিক API-এর সীমা সেট করুন

    বিলযোগ্য API-এর ব্যবহার সংক্রান্ত খরচ ম্যানেজ করতে, ব্যবহার। প্রতিদিন করা অনুরোধের উপর ক্যাপ সেট করে, আপনি খরচ সীমিত করতে পারবেন। আপনি কত খরচ করতে চান তার উপর নির্ভর করে আপনার দৈনিক সীমা নির্ধারণ করতে একটি সমীকরণ ব্যবহার করুন। যেমন: (মাসিক খরচ / প্রতিটি SKU-এর দাম) / ৩০ = প্রতিদিনের সর্বাধিক অনুরোধ (একটি API-এর জন্য)।

প্রতিটি চ্যানেল পিছু ব্যবহার ট্র্যাক করা

সংখ্যাসূচক চ্যানেল ব্যবহার করে আপনার ব্যবহার ট্র্যাক করতে, আপনাকে API অনুরোধে 'channel' প্যারামিটার যোগ করতে হবে। চ্যানেলের ভ্যালু হিসেবে শুধুমাত্র ০-৯৯৯ পর্যন্ত সংখ্যা ব্যবহার করা যাবে। এখানে কিছু উদাহরণ দেওয়া হল:

  • Geocoding Web Service API 
    https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1
  • Maps JavaScript API 
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
async defer></script>

আপনার বিলিং রিপোর্টে সরাসরি চ্যানেল ব্যবহার মনিটর করুন। চ্যানেলের ব্যবহার লেবেল-এর অধীনে goog-maps-channel কী হিসেবে দেখানো হয়।

লেবেল ব্যবহার করে কীভাবে ফিল্টার করবেন
ছবি ৪: SKU ও চ্যানেল অনুযায়ী ফিল্টার করুন
SKU ও চ্যানেল অনুযায়ী আপনার বিলিং রিপোর্ট ফিল্টার করতে
  1. এইভাবে বাছাই করা গ্রুপ: SKU ফিল্টার ব্যবহার করুন।
  2. লেবেল ক্যারেট বেছে নিন।
  3. কী ড্রপ-ডাউন থেকে, goog-maps-channel বেছে নিন।
  4. ভ্যালু ড্রপ-ডাউন থেকে, আপনি যে সংখ্যাসূচক চ্যানেল ফিল্টার করতে চান সেটি বেছে নিন।

প্রতিটি চ্যানেল থেকে হওয়া খরচ দেখতে, লেবেল কী goog-maps-channel অনুযায়ী গ্রুপ করুন।

আপনার অনুরোধে চ্যানেল ব্যবহারের ডেটা প্রয়োগ করার পরে, আপনার বিলিং রিপোর্টে ডেটা দেখতে পাওয়ার আগে কিছুটা দেরি (সর্বাধিক ২৪ ঘণ্টা) হতে পারে।

BigQuery-এর মাধ্যমে আপনার বিলিং ডেটা এক্সপোর্ট করুন

এছাড়াও, আপনি BigQuery-তে আপনার বিলিং ডেটা এক্সপোর্ট করতে পারবেন।

BigQuery এক্সপোর্ট ব্যবহার করে, সারাদিন ধরে অটোমেটিক, বিস্তারিত Cloud Billing ডেটা (যেমন, ব্যবহার ও খরচের আনুমানিক ডেটা) আপনার নির্দিষ্ট করা BigQuery ডেটাসেটে এক্সপোর্ট করুন। তারপর, বিস্তারিত বিশ্লেষণের জন্য আপনি BigQuery থেকে বিলিং ডেটা অ্যাক্সেস করতে পারবেন। এর ফলে আপনার Google Maps Platform ব্যবহারের সোর্স বোঝার ক্ষেত্রে আরও একটি অতিরিক্ত স্তর যোগ হয়।

আপনি যদি BigQuery এক্সপোর্ট ও ডেটা কোয়েরি করা শুরু করতে চান, তাহলে নিচে দেওয়া নমুনা কোয়েরি ব্যবহার করে দেখতে পারেন। এই কোয়েরি চালানোর আগে, আপনাকে অবশ্যই:

  • আপনার অ্যাকাউন্টে বিলিং ও BigQuery বিলিং এক্সপোর্ট চালু করুন।
  • টেবিলের ফর্ম্যাট হল PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID যেখানে:
    • PROJECT_ID হল আপনার আসল প্রোজেক্ট আইডি (যেমন, "my-project-123456")।
    • DATASET_NAME হল আপনার তৈরি করা ডেটাসেটের নাম (যেমন, "SampleDataSet")।
    • BILLING_ACCOUNT_ID হল আপনার বিলিং অ্যাকাউন্ট আইডির রেফারেন্স, "gcp_billing_exportv1" দিয়ে শুরু হয় এবং ড্যাশ (-) বদলে আন্ডারস্কোর (_) হয়ে যায়। যেমন, বিলিং অ্যাকাউন্ট আইডি 123456-7890AB-CDEF01, gcp_billing_export_v1_123456_789AB_CDEF01 হয়ে যাবে।

  #standardSQL
  SELECT   Date(usage_start_time, "America/Los_Angeles") AS billing_day,
           invoice.month                                 AS invoice_month,
           service.description                           AS service,
           sku.description                               AS sku,
           (
                  SELECT l.value
                  FROM   Unnest(labels) AS l
                  WHERE  l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
           Round(Sum(usage.amount), 2)                 AS usage_amount,
           usage.unit                                  AS usage_unit,
           Round(Sum(cost), 2)                         AS cost,
           cost_type,
           currency
  FROM     PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
  WHERE    invoice.month = '202002' -- Change the invoice month with the same format as the example.
  GROUP BY billing_day,
           invoice_month,
           service,
           sku,
           goog_maps_channel,
           usage_unit,
           cost_type,
           currency
  ORDER BY billing_day,
           service,
           sku

Cloud Billing:

Google Maps Platform:

উত্তর সংক্রান্ত স্ট্যাটাস ও রিপোর্ট

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

Google Maps Platform মেট্রিক্সে ব্যবহারের রিপোর্ট

HTTP response code class গ্রানুলারিটি প্রদান করে। আপনার আরও বেশি লেভেলের গ্র্যানুলারিটি প্রয়োজন হলে, রেসপন্স স্ট্যাটাস কোড দেখুন

Google Maps Platform ব্যবহার মনিটর করা বিকল্পে উপলভ্য।

Maps API-এর উত্তরে উপলভ্য রেসপন্স কোড ব্যবহার সংক্রান্ত রিপোর্টে উপলভ্য এতে অভিযোগ করা হয়েছে
Maps API-এর স্ট্যাটাস HTTP রেসপন্স কোড HTTP রেসপন্স কোড ক্লাস ব্যবহার কোটা বিলিং
ঠিক আছে ২০০,
২০৪,
৩০২		 2xx,
3xx		 হ্যাঁ হ্যাঁ হ্যাঁ
DATA_NOT_AVAILABLE,
NOT_FOUND,
ZERO_RESULTS		 ২০০,
৪০৪		 4xx1 হ্যাঁ হ্যাঁ হ্যাঁ
INVALID_REQUEST (প্যারামিটারের ভুল ভ্যালু),
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED,
ইত্যাদি।		 ২০০,
৪০০		 4xx হ্যাঁ হ্যাঁ হ্যাঁ
INVALID_REQUEST (ভুল/অনুপস্থিত প্যারামিটার, অনুরোধ পার্সিং সংক্রান্ত সমস্যা) ২০০,
৪০০		 4xx হ্যাঁ না না
REQUEST_DENIED ২০০,
৪০০,
৪০৩		 4xx1 হ্যাঁ না না
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
dailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded 		২০০,
৪০৩,
৪২৯		 4xx১ হ্যাঁ না না
UNKNOWN_ERROR ২০০,
৫০০,
৫০৩		 5xx1 হ্যাঁ হ্যাঁ না
১ ত্রুটি কোড রিপোর্টিংয়ের ধারাবাহিকতা উন্নত করতে, Google Maps Platform APIs মাইগ্রেট করছে: ১) HTTP রেসপন্স কোড ক্লাস 2xx থেকে 4xx-এ Maps API স্ট্যাটাসের জন্য: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - স্ট্যাটাস, ২) HTTP রেসপন্স কোড ক্লাস 2xx থেকে 4xx-এ Maps API স্ট্যাটাসের জন্য: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, ৩) HTTP রেসপন্স কোড ক্লাস 2xx থেকে 5xx-এ Maps API স্ট্যাটাসের জন্য: UNKNOWN_ERROR। ট্রানজিশন পিরিয়ড চলাকালীন আপনি দুটি রেসপন্স কোডই দেখতে পাবেন। Maps API-এর উত্তরে ফিরে আসা রেসপন্স কোড পরিবর্তিত হচ্ছে না। 4xx এবং/অথবা 5xx-এ বৃদ্ধি Google Maps Platform মেট্রিক-এ এই মাইগ্রেশনের সাথে সম্পর্কিত কিনা তা নিশ্চিত করুন, এর জন্য মেট্রিক এক্সপ্লোরার-এ কোন সঠিক রেসপন্স কোড বৃদ্ধি পায় তা চেক করুন (Google Maps Platform-এর জন্য Google Cloud Monitoring ব্যবহার করার বিষয়ে আরও জানুন)।