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

درباره پوشش‌های فیلد

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

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

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

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

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

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

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

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

جدول زیر جزئیات و قیمت‌گذاری شناسه کالا با پرداخت به اندازه استفاده را برای Places API نشان می‌دهد.

دسته	جزئیات شناسه محصول Places API (جدید)	قیمت‌گذاری SKU
Essentials	واحد نگهداری موجودی: درخواست‌های تکمیل خودکار	فهرست قیمت جهانی فهرست قیمت هند
Essentials	واحد نگهداری موجودی: Autocomplete Session Usage	فهرست قیمت جهانی فهرست قیمت هند
Essentials	SKU: Place Details Essentials (IDs Only)	فهرست قیمت جهانی فهرست قیمت هند
Essentials	SKU: Place Details Essentials	فهرست قیمت جهانی فهرست قیمت هند
Essentials	SKU: Text Search Essentials (IDs Only)	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Nearby Search Pro	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Place Details Pro	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Text Search Pro	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	واحد نگهداری موجودی: Nearby Search Enterprise	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	SKU: Nearby Search Enterprise + Atmosphere	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	SKU: Place Details Enterprise	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	SKU: Place Details Enterprise + Atmosphere	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	SKU: Text Search Enterprise	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	SKU: Text Search Enterprise + Atmosphere	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	SKU: Place Details Photos	فهرست قیمت جهانی فهرست قیمت هند
دسته	جزئیات SKU مربوط به Places API (قدیمی)	قیمت‌گذاری SKU
Essentials	SKU: Autocomplete - Per Request	فهرست قیمت جهانی فهرست قیمت هند
Essentials	SKU: Autocomplete (included with Place Details) - Per Session	فهرست قیمت جهانی فهرست قیمت هند
Essentials	واحد نگهداری موجودی: داده‌های اصلی هزینه‌های اضافی: SKU: Places Details SKU: Find Place SKU: Places - Nearby Search واحد نگهداری موجودی: مکان‌ها - جستجوی نوشتار	فهرست قیمت جهانی فهرست قیمت هند
Essentials	واحد نگهداری موجودی: Find Place - ID only	فهرست قیمت جهانی فهرست قیمت هند
Essentials	SKU: Place Details Essentials - ID Refresh	فهرست قیمت جهانی فهرست قیمت هند
Essentials	SKU: Query Autocomplete - Per Request	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Autocomplete without Place Details - Per Session	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Find Place هزینه‌های اضافی: واحد نگهداری موجودی: داده‌های اصلی SKU: Contact Data واحد نگهداری موجودی: داده‌های جوی	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Places - Nearby Search هزینه‌های اضافی: واحد نگهداری موجودی: داده‌های اصلی SKU: Contact Data واحد نگهداری موجودی: داده‌های جوی	فهرست قیمت جهانی فهرست قیمت هند
Pro	واحد نگهداری موجودی: مکان‌ها - جستجوی نوشتار هزینه‌های اضافی: واحد نگهداری موجودی: داده‌های پایه SKU: Contact Data واحد نگهداری موجودی: داده‌های جوی	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Places Details هزینه‌های اضافی: واحد نگهداری موجودی: داده‌های پایه SKU: Contact Data واحد نگهداری موجودی: داده‌های جوی	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	واحد نگهداری موجودی: داده‌های جوی هزینه‌های اضافی: SKU: Places Details SKU: Find Place SKU: Places - Nearby Search واحد نگهداری موجودی: مکان‌ها - جستجوی نوشتار	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	SKU: Contact Data هزینه‌های اضافی: SKU: Places Details SKU: Find Place SKU: Places - Nearby Search واحد نگهداری موجودی: مکان‌ها - جستجوی نوشتار	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	SKU: عکس‌های مکان	فهرست قیمت جهانی فهرست قیمت هند

حدود استفاده

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

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

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

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

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

استفاده از پوشش فیلد

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

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

سپس صورت‌حساب شما براساس بالاترین SKU قابل‌اعمال برای درخواستتان صادر می‌شود. برای مثال، اگر فیلدهایی را از هر دو SKU «ضروریات» و Pro انتخاب کنید، براساس SKU‏ Pro صورت‌حساب دریافت می‌کنید.

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

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

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

تنظیم سهمیه

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

برای تغییر دادن مقدار سهمیه برای میانای برنامه‌سازی کاربردی‌تان، این مراحل را دنبال کنید:

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

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

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

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

محدودیت‌های «شرایط خدمات»

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