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

درباره ماسک های میدانی

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

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

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

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

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

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

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

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

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

دسته بندی جزئیات SKU API مکان‌ها (جدید). قیمت گذاری SKU
ملزومات SKU: تکمیل خودکار درخواست ها لیست قیمت اصلی
لیست قیمت هند
ملزومات SKU: استفاده از جلسه تکمیل خودکار لیست قیمت اصلی
لیست قیمت هند
ملزومات SKU: جزئیات مکان (فقط شناسه ها) لیست قیمت اصلی
لیست قیمت هند
ملزومات SKU: جزئیات مکان ضروری است لیست قیمت اصلی
لیست قیمت هند
ملزومات SKU: موارد ضروری جستجوی متن (فقط شناسه ها) لیست قیمت اصلی
لیست قیمت هند
حرفه ای SKU: Nearby Search Pro لیست قیمت اصلی
لیست قیمت هند
حرفه ای SKU: Place Details Pro لیست قیمت اصلی
لیست قیمت هند
حرفه ای SKU: Text Search Pro لیست قیمت اصلی
لیست قیمت هند
تصدی SKU: شرکت جستجوی نزدیک لیست قیمت اصلی
لیست قیمت هند
تصدی SKU: Nearby Search Enterprise Plus لیست قیمت اصلی
لیست قیمت هند
تصدی SKU: جزئیات مکان سازمانی لیست قیمت اصلی
لیست قیمت هند
تصدی SKU: جزئیات مکان سازمانی + جو لیست قیمت اصلی
لیست قیمت هند
تصدی SKU: شرکت جستجوی متن لیست قیمت اصلی
لیست قیمت هند
تصدی SKU: شرکت جستجوی متن + جو لیست قیمت اصلی
لیست قیمت هند
تصدی SKU: عکس‌های جزئیات مکان لیست قیمت اصلی
لیست قیمت هند
دسته بندی جزئیات SKU API مکان‌ها (قدیمی). قیمت گذاری SKU
ملزومات SKU: تکمیل خودکار - به ازای هر درخواست لیست قیمت اصلی
لیست قیمت هند
ملزومات SKU: تکمیل خودکار (شامل جزئیات مکان) - در هر جلسه لیست قیمت اصلی
لیست قیمت هند
ملزومات SKU: داده های پایه لیست قیمت اصلی
لیست قیمت هند
ملزومات SKU: مکان را پیدا کنید - فقط شناسه لیست قیمت اصلی
لیست قیمت هند
ملزومات SKU: Place Details Essentials- ID Refresh لیست قیمت اصلی
لیست قیمت هند
ملزومات SKU: پرس و جو تکمیل خودکار - در هر درخواست لیست قیمت اصلی
لیست قیمت هند
حرفه ای SKU: تکمیل خودکار بدون جزئیات مکان - در هر جلسه لیست قیمت اصلی
لیست قیمت هند
حرفه ای SKU: مکان را پیدا کنید لیست قیمت اصلی
لیست قیمت هند
حرفه ای SKU: مکان‌ها - جستجوی نزدیک لیست قیمت اصلی
لیست قیمت هند
حرفه ای SKU: مکان ها - جستجوی متن لیست قیمت اصلی
لیست قیمت هند
حرفه ای SKU: Place Details Pro لیست قیمت اصلی
لیست قیمت هند
تصدی SKU: داده های جو لیست قیمت اصلی
لیست قیمت هند
تصدی SKU: اطلاعات تماس لیست قیمت اصلی
لیست قیمت هند
تصدی SKU: عکس‌های مکان لیست قیمت اصلی
لیست قیمت هند

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

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

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

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

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

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