স্থান API ব্যবহার এবং বিলিং

ফিল্ড মাস্ক সম্পর্কে

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

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

অটোকমপ্লিট (নতুন) সেশন সম্পর্কে

একটি অটোকমপ্লিট (নতুন) সেশনে এক বা একাধিক অটোকমপ্লিট (নতুন) অনুরোধ এবং একটি প্লেস ডিটেইলস (নতুন) অনুরোধ বা অ্যাড্রেস ভ্যালিডেশন অনুরোধ অন্তর্ভুক্ত থাকে। একই সেশন টোকেন অটোকমপ্লিট (নতুন) অনুরোধ এবং পরবর্তী প্লেস ডিটেইলস (নতুন) অনুরোধ বা অ্যাড্রেস ভ্যালিডেশন অনুরোধে পাঠানো হয়।

প্রথম অটোকমপ্লিট (নতুন) অনুরোধের মাধ্যমে একটি সেশন শুরু হয়। ব্যবহারকারী যখন অটোকমপ্লিট (নতুন) সাজেশনগুলোর মধ্যে একটি নির্বাচন করেন, তখন একটি স্থানের বিবরণ (নতুন) অনুরোধ অথবা ঠিকানা যাচাইকরণ অনুরোধ করা হয়। যদি কোনো সেশন পরিত্যক্ত হয়, অর্থাৎ কোনো স্থানের বিবরণ (নতুন) অনুরোধ অথবা ঠিকানা যাচাইকরণ অনুরোধ করা না হয়, তাহলে অটোকমপ্লিট (নতুন) অনুরোধগুলোর জন্য এমনভাবে চার্জ করা হয় যেন কোনো সেশন টোকেন প্রদান করা হয়নি।

ব্যবহারকারী কোনো স্থান নির্বাচন করার পর (অর্থাৎ, স্থানের বিবরণ (নতুন) অনুরোধ বা ঠিকানা যাচাইকরণ অনুরোধ করা হলে), আপনাকে অবশ্যই একটি নতুন সেশন টোকেন ব্যবহার করে একটি নতুন সেশন শুরু করতে হবে।

একটি সেশন টোকেন একটি সেশনের জন্য বৈধ এবং এটি একাধিক সেশনের জন্য ব্যবহার করা যায় না। যদি আপনি একটি সেশন টোকেন পুনরায় ব্যবহার করেন, তাহলে সেশনটি অবৈধ বলে গণ্য হবে এবং অনুরোধগুলোর জন্য এমনভাবে চার্জ করা হবে যেন কোনো সেশন টোকেন প্রদান করা হয়নি।

Places API-এর জন্য SKU বিবরণ এবং মূল্য

নিম্নলিখিত সারণিতে প্লেসেস এপিআই-এর এসকেইউ বিবরণ এবং মূল্য দেখানো হয়েছে।

বিভাগ স্থান এপিআই (নতুন) এসকেইউ বিবরণ SKU মূল্য নির্ধারণ
প্রয়োজনীয় জিনিসপত্র SKU: স্বয়ংক্রিয় পূরণের অনুরোধ প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রয়োজনীয় জিনিসপত্র SKU: স্বয়ংক্রিয় সম্পূর্ণকরণ সেশন ব্যবহার প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রয়োজনীয় জিনিসপত্র SKU: স্থানের বিবরণের জন্য প্রয়োজনীয় সামগ্রী (শুধুমাত্র পরিচয়পত্র) প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রয়োজনীয় জিনিসপত্র SKU: স্থানের বিবরণ প্রয়োজনীয় প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রয়োজনীয় জিনিসপত্র SKU: টেক্সট সার্চ এসেনশিয়ালস (শুধুমাত্র আইডি) প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রো SKU: Nearby Search Pro প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রো SKU: প্লেস ডিটেইলস প্রো প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রো SKU: টেক্সট সার্চ প্রো প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
উদ্যোগ SKU: Nearby Search Enterprise প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
উদ্যোগ SKU: Nearby Search Enterprise + Atmosphere প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
উদ্যোগ SKU: প্লেস ডিটেইলস এন্টারপ্রাইজ প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
উদ্যোগ SKU: স্থানের বিবরণ এন্টারপ্রাইজ + অ্যাটমোস্ফিয়ার প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
উদ্যোগ SKU: টেক্সট সার্চ এন্টারপ্রাইজ প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
উদ্যোগ SKU: টেক্সট সার্চ এন্টারপ্রাইজ + অ্যাটমোস্ফিয়ার প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
উদ্যোগ SKU: স্থানের বিবরণ ছবি প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
বিভাগ প্লেসেস এপিআই (লেগ্যাসি) এসকেইউ বিবরণ SKU মূল্য নির্ধারণ
প্রয়োজনীয় জিনিসপত্র SKU: স্বয়ংক্রিয় পূরণ - অনুরোধ অনুযায়ী প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রয়োজনীয় জিনিসপত্র SKU: স্বয়ংক্রিয় পূরণ (স্থানের বিবরণের সাথে অন্তর্ভুক্ত) - প্রতি সেশন প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রয়োজনীয় জিনিসপত্র

SKU: বেসিক ডেটা

অতিরিক্ত চার্জ:

প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রয়োজনীয় জিনিসপত্র SKU: স্থান খুঁজুন - শুধুমাত্র আইডি প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রয়োজনীয় জিনিসপত্র SKU: স্থানের বিবরণের প্রয়োজনীয় তথ্য - আইডি রিফ্রেশ প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রয়োজনীয় জিনিসপত্র SKU: কোয়েরি অটোকমপ্লিট - প্রতি অনুরোধ প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রো SKU: স্থানের বিবরণ ছাড়া স্বয়ংক্রিয় পূরণ - প্রতি সেশন প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রো

SKU: স্থান খুঁজুন

অতিরিক্ত চার্জ:

প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রো

SKU: স্থান - কাছাকাছি অনুসন্ধান

অতিরিক্ত চার্জ:

প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রো

SKU: স্থানসমূহ - পাঠ্য অনুসন্ধান

অতিরিক্ত চার্জ:

প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
প্রো

SKU: স্থান বিবরণ

অতিরিক্ত চার্জ:

প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
উদ্যোগ

SKU: বায়ুমণ্ডল ডেটা

অতিরিক্ত চার্জ:

প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
উদ্যোগ

SKU: যোগাযোগের তথ্য

অতিরিক্ত চার্জ:

প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা
উদ্যোগ SKU: স্থান ছবি প্রধান মূল্য তালিকা
ভারতের মূল্য তালিকা

ব্যবহারের সীমা

আপনার কোটা এবং ব্যবহারের সীমা পর্যালোচনা ও পরিচালনা করতে, ‘কোটা এবং কোটা সতর্কতা’ দেখুন।

  • প্লেসেস এপিআই (নতুন) : প্রতি মিনিটের রেট লিমিট প্রতিটি প্রজেক্টের জন্য প্রতিটি এপিআই মেথডের উপর নির্ভরশীল। অন্য কথায়, প্রতিটি এপিআই মেথডের একটি আলাদা কোটা রয়েছে।

  • প্লেসেস এপিআই (লেগ্যাসি) : একই প্রজেক্টের ক্রেডেনশিয়াল ব্যবহারকারী সমস্ত অ্যাপ্লিকেশনের ক্লায়েন্ট-সাইড এবং সার্ভার-সাইড অনুরোধের সমষ্টি হিসাবে প্রতি মিনিটের রেট লিমিট গণনা করা হয়।

Places API-এর জন্য সাশ্রয়ী কৌশল

এই বিভাগে প্লেসেস এপিআই (Places API)-এর ব্যবহার অপ্টিমাইজ করার এবং এর সাথে সম্পর্কিত খরচ কমানোর উপায় দেওয়া হয়েছে।

ফিল্ড মাস্ক ব্যবহার করুন

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

স্থানের বিবরণ (নতুন), নিকটবর্তী অনুসন্ধান (নতুন), এবং টেক্সট অনুসন্ধান (নতুন) অনুরোধগুলির জন্য, প্রতিক্রিয়ায় ফেরত দেওয়া ফিল্ডগুলির তালিকা নির্দিষ্ট করতে একটি ফিল্ড মাস্ক ব্যবহার করুন।

এরপর আপনার অনুরোধের জন্য প্রযোজ্য সর্বোচ্চ SKU অনুযায়ী আপনাকে বিল করা হবে। উদাহরণস্বরূপ, আপনি যদি Essentials এবং Pro উভয় SKU থেকেই ফিল্ড নির্বাচন করেন, তাহলে আপনাকে Pro SKU-এর ভিত্তিতে বিল করা হবে।

স্থানের বিবরণের সাথে সেশন মূল্য ব্যবহার করুন (নতুন)

যদি আপনার অ্যাপ্লিকেশনগুলির মাসিক কল ভলিউম ১০০,০০১–৫০০,০০০ বা তার বেশি হয়, অথবা যদি ব্যবহারকারীরা প্রতি সেশনে ১২টির বেশি অটোকমপ্লিট অনুরোধ করেন, তাহলে গুগল অটোকমপ্লিট (নিউ)-এর সাথে সেশন ব্যবহার করার পরামর্শ দেয়। সেশন মূল্য নির্ধারণকে সহজ করতে এবং অটোকমপ্লিট (নিউ)-এর ব্যবহারের জন্য একটি সামঞ্জস্যপূর্ণ মূল্য নির্ধারণ মডেল প্রদান করতে সাহায্য করে।

আরও তথ্যের জন্য, অটোকমপ্লিট (নতুন) এবং সেশন মূল্য নির্ধারণ দেখুন।

কোটা সমন্বয় করুন

কোটা সীমা একটি নির্দিষ্ট সময়সীমার মধ্যে কোনো নির্দিষ্ট এপিআই বা পরিষেবার জন্য অনুমোদিত অনুরোধের সর্বোচ্চ সংখ্যা নির্ধারণ করে। যখন আপনার প্রোজেক্টে অনুরোধের সংখ্যা কোটা সীমায় পৌঁছে যায়, তখন আপনার পরিষেবা অনুরোধের উত্তর দেওয়া বন্ধ করে দেয়।

আপনার এপিআই-এর জন্য কোটার মান পরিবর্তন করতে, এই ধাপগুলো অনুসরণ করুন:

  1. ক্লাউড কনসোলে, Google Maps Platform > Quotas- এ যান।
  2. যে API-টির জন্য আপনি কোটা পরিবর্তন করতে চান, সেটি নির্বাচন করুন।
  3. যে কোটার মানটি আপনি পরিবর্তন করতে চান, সেটি চিহ্নিত করুন এবং চেকবক্স ব্যবহার করে নির্বাচন করুন।
  4. এডিট-এ ক্লিক করুন, একটি নতুন কোটার মান লিখুন এবং সাবমিট রিকোয়েস্ট-এ ক্লিক করুন।

কোটা বৃদ্ধির অনুরোধগুলি দেখুন

অতীতের এবং বিচারাধীন অনুরোধ সহ কোটা বৃদ্ধির সমস্ত অনুরোধ দেখতে:

  1. ক্লাউড কনসোলে, Google Maps Platform > Quotas- এ যান।
  2. যে API-টির কোটা বৃদ্ধির অনুরোধ দেখতে চান, সেটি নির্বাচন করুন।
  3. অনুরোধ বৃদ্ধি করতে ক্লিক করুন।

ব্যবহারের শর্তাবলী সীমাবদ্ধতা

ব্যবহারের শর্তাবলী সম্পর্কে তথ্যের জন্য, প্লেসেস এপিআই (Places API)-এর নীতিমালা এবং গুগল ম্যাপস প্ল্যাটফর্ম পরিষেবার শর্তাবলীর লাইসেন্স সীমাবদ্ধতা বিভাগটি দেখুন।