درباره پوشش فیلد
برای «جزئیات مکان» (جدید)، «جستجوی اطراف» (جدید)، و
«جستجوی نوشتاری» (جدید)، از سرصفحه FieldMask در درخواست‌های API استفاده کنید تا
فهرست فیلدهایی را که باید در پاسخ برگردانده شود مشخص کنید. سپس با بالاترین واحد نگهداری کالا (SKU) قابل‌اعمال برای درخواستتان صورت‌حساب برایتان صادر می‌شود. یعنی اگر فیلدهایی را در هر دو واحد نگهداری کالای
Essentials و Pro انتخاب کنید، براساس واحد نگهداری کالای Pro صورت‌حساب برایتان صادر می‌شود.
استفاده از پوشش فیلد یک روش طراحی خوب است که تضمین می‌کند داده‌های غیرضروری درخواست نمی‌کنید و به این ترتیب از زمان پردازش غیرضروری و هزینه‌های صورت‌حساب جلوگیری می‌شود.
درباره جلسه‌های «تکمیل خودکار (جدید)»
جلسه «تکمیل خودکار (جدید)» شامل یک یا چند درخواست «تکمیل خودکار (جدید)» و یک درخواست «جزئیات مکان (جدید)» یا درخواست «اعتبارسنجی نشانی» است. همان نشان جلسه به درخواست «تکمیل خودکار (جدید)» و به درخواست بعدی «جزئیات مکان (جدید)» یا درخواست «درستی‌سنجی نشانی» ارسال می‌شود.
جلسه با اولین درخواست «تکمیل خودکار (جدید)» شروع می‌شود. سپس وقتی کاربر یکی از پیشنهادهای «تکمیل خودکار» (جدید) را انتخاب می‌کند، درخواست «جزئیات مکان» (جدید) یا درخواست «اعتبارسنجی نشانی» ایجاد می‌شود. اگر جلسه‌ای رها شود، یعنی درخواست «جزئیات مکان» (جدید) یا درخواست «درستی‌سنجی نشانی» انجام نشود، هزینه درخواست‌های «تکمیل خودکار» (جدید) به‌گونه‌ای محاسبه می‌شود که انگار هیچ کد جلسه ارائه نشده است.
پس‌از اینکه کاربر مکانی را انتخاب کرد (یعنی درخواست «جزئیات مکان (جدید)» یا درخواست «درستی‌سنجی نشانی» انجام شد)، باید جلسه جدیدی را بااستفاده از کد جلسه جدید شروع کنید.
یک کد جلسه برای یک جلسه مناسب است و نمی‌توان از آن برای بیش‌از یک جلسه استفاده کرد. اگر از کد جلسه مجدداً استفاده کنید، جلسه نامعتبر تلقی می‌شود و هزینه درخواست‌ها به‌گونه‌ای محاسبه می‌شود که گویی هیچ کد جلسه‌ای ارائه نشده است.
جزئیات واحد نگهداری کالا و قیمت‌گذاری برای «میانای برنامه‌سازی کاربردی مکان‌ها»
جدول زیر جزئیات واحد نگهداری کالا و قیمت‌گذاری «میانای برنامه‌سازی کاربردی مکان‌ها» را نشان می‌دهد.
حدود استفاده
برای بررسی و مدیریت سهمیه‌ها و حدود استفاده، به سهمیه‌ها و هشدارهای سهمیه مراجعه کنید.
Places API (New): حد نرخ در دقیقه برای هر روش API در هر پروژه است. به‌عبارت دیگر، هر روش API سهمیه جداگانه‌ای دارد.
Places API (قدیمی): حد نرخ در دقیقه به‌عنوان مجموع درخواست‌های سمت کارخواه و سمت سرور برای همه برنامه‌هایی که از اطلاعات اعتباری پروژه یکسان استفاده می‌کنند محاسبه می‌شود.
استراتژی‌های مقرون‌به‌صرفه برای Places API
این بخش روش‌هایی برای بهینه‌سازی استفاده شما و کاهش هزینه‌های مرتبط با Places API ارائه می‌دهد.
استفاده از پوشش فیلد
استفاده از پوشش فیلد تضمین می‌کند که داده‌های غیرضروری درخواست نمی‌کنید، که به کاهش تأخیر و هزینه‌های صورت‌حساب کمک می‌کند.
برای درخواست‌های «جزئیات مکان» (جدید)، «جستجوی اطراف» (جدید)، و «جستجوی نوشتاری» (جدید)، از ماسک فیلد برای مشخص کردن فهرست فیلدهایی که در پاسخ برگردانده می‌شود استفاده کنید.
سپس هزینه بالاترین واحد نگهداری کالا (SKU) قابل‌اعمال برای درخواستتان از شما کسر می‌شود. برای مثال، اگر فیلدهایی را از هر دو «واحد نگهداری موجودی» Essentials و Pro انتخاب کنید، صورت‌حساب شما براساس «واحد نگهداری موجودی» Pro صادر می‌شود.
استفاده از قیمت‌گذاری جلسه با «جزئیات مکان (جدید)»
اگر برنامه‌های شما حجم تماس ماهانه
برای اطلاعات بیشتر، تکمیل خودکار (جدید) و قیمت‌گذاری جلسه را ببینید.
تنظیم سهمیه
محدودیت‌های سهمیه حداکثر تعداد درخواست‌های مجاز برای یک API یا سرویس خاص در یک بازه زمانی معین را تعریف می‌کنند. وقتی تعداد درخواست‌های پروژه شما به حد مجاز سهمیه می‌رسد، سرویس شما به درخواست‌ها پاسخ نمی‌دهد.
برای اصلاح مقدار سهمیه برای API خود، این مراحل را دنبال کنید:
- در کنسول Cloud، به Google Maps Platform > سهمیه‌ها پیمایش کنید.
- API مدنظرتان را برای اصلاح سهمیه انتخاب کنید.
- مقدار سهمیه‌ای را که می‌خواهید تغییر دهید شناسایی کنید و آن را بااستفاده از چارگوش انتخاب انتخاب کنید.
- روی ویرایش کلیک کنید، مقدار سهمیه جدیدی وارد کنید، و روی ارسال درخواست کلیک کنید.
مشاهده درخواست‌های افزایش سهمیه
برای مشاهده همه درخواست‌های افزایش سهمیه، ازجمله درخواست‌های قبلی و معلقه:
- در کنسول Cloud، به Google Maps Platform > سهمیه‌ها پیمایش کنید.
- میانای برنامه‌سازی کاربردی‌ای را که می‌خواهید درخواست افزایش سهمیه آن را مشاهده کنید انتخاب کنید.
- روی افزایش درخواست‌ها کلیک کنید.
محدودیت‌های «شرایط خدمات»
برای کسب اطلاعات درباره شرایط استفاده، خط‌مشی‌های میانای برنامه‌سازی کاربردی «مکان‌ها»، و بخش «محدودیت‌های پروانه» «شرایط خدمات پلاتفرم Google Maps» را ببینید.