استفاده و صورتحساب Places API

درباره ماسک‌های صحرایی

برای جزئیات مکان (جدید)، جستجوی نزدیک (جدید) و جستجوی متن (جدید)، از هدر FieldMask در درخواست‌های API برای مشخص کردن لیست فیلدهایی که باید در پاسخ برگردانده شوند، استفاده کنید. سپس بالاترین SKU مربوط به درخواست شما برای شما محاسبه می‌شود. این بدان معناست که اگر فیلدهایی را در هر دو SKU ضروری و حرفه‌ای انتخاب کنید، بر اساس SKU حرفه‌ای برای شما محاسبه می‌شود.

استفاده از پوشش فیلد یک روش طراحی خوب برای اطمینان از عدم درخواست داده‌های غیرضروری است که به جلوگیری از زمان پردازش غیرضروری و هزینه‌های صورتحساب کمک می‌کند.

درباره جلسات تکمیل خودکار (جدید)

یک جلسه تکمیل خودکار (جدید) شامل یک یا چند درخواست تکمیل خودکار (جدید) و یک درخواست جزئیات مکان (جدید) یا درخواست اعتبارسنجی آدرس است. توکن جلسه یکسانی به درخواست تکمیل خودکار (جدید) و به درخواست جزئیات مکان (جدید) یا درخواست اعتبارسنجی آدرس بعدی ارسال می‌شود.

یک جلسه با اولین درخواست تکمیل خودکار (جدید) شروع می‌شود. سپس وقتی کاربر یکی از پیشنهادات تکمیل خودکار (جدید) را انتخاب کرده باشد، درخواست جزئیات مکان (جدید) یا درخواست اعتبارسنجی آدرس انجام می‌شود. اگر جلسه رها شود، به این معنی که هیچ درخواست جزئیات مکان (جدید) یا درخواست اعتبارسنجی آدرس انجام نشود، هزینه درخواست‌های تکمیل خودکار (جدید) مانند زمانی که هیچ توکن جلسه‌ای ارائه نشده است، محاسبه می‌شود.

پس از اینکه کاربر مکانی را انتخاب کرد (به این معنی که درخواست جزئیات مکان (جدید) یا درخواست اعتبارسنجی آدرس ارسال شده است)، باید یک جلسه جدید را با استفاده از یک توکن جلسه جدید شروع کنید.

یک توکن جلسه برای یک جلسه مناسب است و نمی‌توان آن را برای بیش از یک جلسه استفاده کرد. اگر از یک توکن جلسه دوباره استفاده کنید، جلسه نامعتبر تلقی می‌شود و هزینه درخواست‌ها طوری محاسبه می‌شود که انگار هیچ توکن جلسه‌ای ارائه نشده است.

جزئیات SKU و قیمت‌گذاری برای Places API

جدول زیر جزئیات SKU و قیمت‌گذاری Places API را نشان می‌دهد.

دسته بندی جزئیات SKU مربوط به Places API (جدید) قیمت‌گذاری SKU
ملزومات شناسه محصول: درخواست‌های تکمیل خودکار لیست قیمت اصلی
لیست قیمت‌های هند
ملزومات SKU: تکمیل خودکار استفاده از جلسه لیست قیمت اصلی
لیست قیمت‌های هند
ملزومات SKU: جزئیات مکان ملزومات (فقط کارت‌های شناسایی) لیست قیمت اصلی
لیست قیمت‌های هند
ملزومات SKU: جزئیات مکان ملزومات لیست قیمت اصلی
لیست قیمت‌های هند
ملزومات SKU: ملزومات جستجوی متن (فقط شناسه‌ها) لیست قیمت اصلی
لیست قیمت‌های هند
حرفه‌ای شناسه محصول: جستجوی حرفه‌ای نزدیک لیست قیمت اصلی
لیست قیمت‌های هند
حرفه‌ای شناسه محصول: Place Details Pro لیست قیمت اصلی
لیست قیمت‌های هند
حرفه‌ای شناسه محصول: جستجوی متن حرفه‌ای لیست قیمت اصلی
لیست قیمت‌های هند
تصدی شناسه محصول: جستجوی نزدیک، سازمانی لیست قیمت اصلی
لیست قیمت‌های هند
تصدی شناسه محصول: جستجوی نزدیک Enterprise + Atmosphere لیست قیمت اصلی
لیست قیمت‌های هند
تصدی شناسه محصول: جزئیات مکان، سازمانی لیست قیمت اصلی
لیست قیمت‌های هند
تصدی شناسه محصول: جزئیات مکان، سازمانی + فضایی لیست قیمت اصلی
لیست قیمت‌های هند
تصدی شناسه محصول: جستجوی متنی سازمانی لیست قیمت اصلی
لیست قیمت‌های هند
تصدی شناسه محصول: جستجوی متنی Enterprise + Atmosphere لیست قیمت اصلی
لیست قیمت‌های هند
تصدی شناسه محصول: جزئیات مکان عکس‌ها لیست قیمت اصلی
لیست قیمت‌های هند
دسته بندی جزئیات SKU مربوط به Places API (قدیمی) قیمت‌گذاری SKU
ملزومات شناسه محصول: تکمیل خودکار - به ازای هر درخواست لیست قیمت اصلی
لیست قیمت‌های هند
ملزومات شناسه محصول: تکمیل خودکار (همراه با جزئیات مکان) - به ازای هر جلسه لیست قیمت اصلی
لیست قیمت‌های هند
ملزومات

شناسه محصول: داده‌های پایه

هزینه‌های اضافی:

لیست قیمت اصلی
لیست قیمت‌های هند
ملزومات شناسه محصول: یافتن مکان - فقط شناسه لیست قیمت اصلی
لیست قیمت‌های هند
ملزومات شناسه محصول: ملزومات جزئیات مکان - به‌روزرسانی شناسه لیست قیمت اصلی
لیست قیمت‌های هند
ملزومات شناسه محصول: تکمیل خودکار پرس‌وجو - به ازای هر درخواست لیست قیمت اصلی
لیست قیمت‌های هند
حرفه‌ای SKU: تکمیل خودکار بدون جزئیات مکان - به ازای هر جلسه لیست قیمت اصلی
لیست قیمت‌های هند
حرفه‌ای

شناسه محصول: یافتن مکان

هزینه‌های اضافی:

لیست قیمت اصلی
لیست قیمت‌های هند
حرفه‌ای

شناسه محصول: مکان‌ها - جستجوی نزدیک

هزینه‌های اضافی:

لیست قیمت اصلی
لیست قیمت‌های هند
حرفه‌ای

شناسه محصول: مکان‌ها - جستجوی متن

هزینه‌های اضافی:

لیست قیمت اصلی
لیست قیمت‌های هند
حرفه‌ای

شناسه محصول: جزئیات مکان‌ها

هزینه‌های اضافی:

لیست قیمت اصلی
لیست قیمت‌های هند
تصدی

شناسه محصول: داده‌های جوی

هزینه‌های اضافی:

لیست قیمت اصلی
لیست قیمت‌های هند
تصدی

شناسه محصول: اطلاعات تماس

هزینه‌های اضافی:

لیست قیمت اصلی
لیست قیمت‌های هند
تصدی شناسه محصول: عکس‌های مکان لیست قیمت اصلی
لیست قیمت‌های هند

محدودیت‌های استفاده

برای بررسی و مدیریت سهمیه‌ها و محدودیت‌های استفاده خود، به سهمیه‌ها و هشدارهای سهمیه مراجعه کنید.

  • API مکان‌ها (جدید) : محدودیت نرخ در هر دقیقه برای هر روش API در هر پروژه است. به عبارت دیگر، هر روش API سهمیه جداگانه‌ای دارد.

  • API مکان‌ها (قدیمی) : محدودیت سرعت در هر دقیقه به صورت مجموع درخواست‌های سمت کلاینت و سمت سرور برای همه برنامه‌هایی که از اعتبارنامه‌های همان پروژه استفاده می‌کنند، محاسبه می‌شود.

استراتژی‌های مقرون‌به‌صرفه برای Places API

این بخش روش‌هایی را برای بهینه‌سازی استفاده و کاهش هزینه‌های مرتبط با Places API ارائه می‌دهد.

از ماسک‌های میدانی استفاده کنید

استفاده از پوشش فیلد تضمین می‌کند که شما داده‌های غیرضروری درخواست نمی‌کنید، که به کاهش تأخیر و هزینه‌های صدور صورتحساب کمک می‌کند.

برای درخواست‌های «جزئیات مکان» (جدید)، «جستجوی نزدیک» (جدید) و «جستجوی متن» (جدید)، از یک ماسک فیلد برای مشخص کردن لیست فیلدهایی که باید در پاسخ برگردانده شوند، استفاده کنید.

سپس برای شما بالاترین SKU مربوط به درخواستتان محاسبه می‌شود. برای مثال، اگر فیلدهایی را از هر دو SKU ضروری و حرفه‌ای انتخاب کنید، هزینه بر اساس SKU حرفه‌ای محاسبه می‌شود.

استفاده از قیمت‌گذاری جلسه با جزئیات مکان (جدید)

اگر حجم تماس ماهانه برنامه‌های شما بین ۱۰۰,۰۰۱ تا ۵۰۰,۰۰۰ یا بیشتر است، یا اگر کاربران در هر جلسه بیش از ۱۲ درخواست تکمیل خودکار ارسال می‌کنند، گوگل استفاده از جلسات با قابلیت تکمیل خودکار (جدید) را توصیه می‌کند. جلسات به ساده‌سازی قیمت‌گذاری کمک می‌کنند و یک مدل قیمت‌گذاری ثابت برای استفاده با قابلیت تکمیل خودکار (جدید) ارائه می‌دهند.

برای اطلاعات بیشتر، به تکمیل خودکار (جدید) و قیمت‌گذاری جلسه مراجعه کنید.

سهمیه را تنظیم کنید

محدودیت‌های سهمیه، حداکثر تعداد درخواست‌های مجاز برای یک API یا سرویس خاص را در یک بازه زمانی مشخص تعریف می‌کنند. وقتی تعداد درخواست‌ها در پروژه شما به حد سهمیه برسد، سرویس شما دیگر به درخواست‌ها پاسخ نمی‌دهد.

برای تغییر مقدار سهمیه برای API خود، این مراحل را دنبال کنید:

  1. در کنسول ابری، به مسیر Google Maps Platform > Quotas بروید.
  2. API مورد نظر برای تغییر سهمیه را انتخاب کنید.
  3. مقدار سهمیه‌ای که می‌خواهید تغییر دهید را مشخص کنید و با استفاده از کادر انتخاب، آن را انتخاب کنید.
  4. روی ویرایش کلیک کنید، مقدار سهمیه جدید را وارد کنید و روی ارسال درخواست کلیک کنید.

مشاهده درخواست‌های افزایش سهمیه

برای مشاهده همه درخواست‌های افزایش سهمیه، شامل درخواست‌های گذشته و در حال بررسی:

  1. در کنسول ابری، به مسیر Google Maps Platform > Quotas بروید.
  2. API مورد نظر خود را برای مشاهده درخواست افزایش سهمیه انتخاب کنید.
  3. روی افزایش درخواست‌ها کلیک کنید.

محدودیت‌های شرایط استفاده

برای اطلاعات بیشتر در مورد شرایط استفاده، به سیاست‌های مربوط به API مکان‌ها و بخش محدودیت‌های مجوز در شرایط خدمات پلتفرم نقشه‌های گوگل مراجعه کنید.