تکمیل خودکار و قیمت‌گذاری جلسه

پلاتفرم را انتخاب کنید: Android iOS JavaScript سرویس وب
توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

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

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

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

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

صدور صورت‌حساب جلسه

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

برای جلسه‌های «تکمیل خودکار (جدید)» که با درخواستی بااستفاده از فیلدهای SKU: Places API Place Details Essentials خاتمه می‌یابند:

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

برای جلسه‌های «تکمیل خودکار (جدید)» که به درخواست «اعتبارسنجی نشانی» یا درخواست «جزئیات مکان (جدید)» بااستفاده از فیلدهای «جزئیات مکان» Pro، Enterprise، یا Enterprise + Atmosphere ختم می‌شوند:

  • درخواست‌های «تکمیل خودکار (جدید)»: همه درخواست‌های «تکمیل خودکار (جدید)» با SKU: Autocomplete Session Usage صورت‌حساب می‌شوند، یعنی هزینه‌ای برای این درخواست‌ها دریافت نمی‌شود.
  • درخواست «جزئیات مکان» (جدید) یا «اعتبارسنجی نشانی»: همچنین برای درخواست خاتمه‌دهنده در شناسه واحد نگهداری کالا مناسب صورت‌حساب دریافت می‌کنید:

سناریوهای قیمت‌گذاری جلسه

سه سناریو رایج قیمت‌گذاری جلسه عبارت‌اند از:

بخش‌های زیر هزینه‌های صورت‌حساب جداگانه را برای هر سناریو شرح می‌دهند.

تکمیل خودکار برای داده‌های مکان

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

اطلاعات مکان می‌تواند شامل موارد زیر باشد:

  • نشانی
  • مکان به‌صورت مختصات طول و عرض جغرافیایی
  • Plus Code
  • انواع
  • ناحیه نمایش

این جلسه با یک درخواست به «جزئیات جا (جدید)» که فیلدهای تعریف‌شده توسط SKU: Place Details Essentials را درخواست می‌کند، خاتمه می‌یابد.

سپس صورت‌حساب شما به‌صورت زیر صادر می‌شود:

نمودار صورت‌حساب برای سناریوی «تکمیل خودکار» برای داده‌های مکان

تکمیل خودکار برای کاوش مکان

در سناریو «تکمیل خودکار برای کاوش مکان»، شما علاقه‌مند به دریافت اطلاعاتی بیشتر از صرفاً داده‌های مکان درباره یک مکان هستید. برای مثال، می‌توانید هرکدام از موارد زیر را درخواست کنید:

  • گزینه‌های دسترس‌پذیری
  • ساعت کاری فعلی
  • گزینه‌های پارکینگ
  • مرورها
  • رده‌بندی‌ها

در این سناریو، جلسه شما با یک درخواست به «جزئیات مکان (جدید)» که هر فیلدی را که در «جزئیات مکان (جدید)» گنجانده شده است درخواست می‌کند، Pro، Enterprise، یا Enterprise + Atmosphere SKUs.

سپس صورت‌حساب شما به‌صورت زیر صادر می‌شود:

نمودار صورت‌حساب برای «تکمیل خودکار» برای سناریوی کاوش مکان

تکمیل خودکار برای تسویه‌حساب و ارسال

Address Validation API سرویسی است که نشانی را می‌پذیرد. این ابزار اجزای نشانی را شناسایی و آن‌ها را اعتبارسنجی می‌کند. همچنین نشانی را برای ارسال پستی استاندارد می‌کند و بهترین مختصات عرض جغرافیایی و طول جغرافیایی شناخته‌شده را برای آن پیدا می‌کند.

در سناریو «تکمیل خودکار برای تسویه‌حساب و تحویل»، جلسه را با درخواستی به Address Validation API برای اعتبارسنجی نشانی انتخاب‌شده خاتمه می‌دهید.

سپس صورت‌حساب شما به‌صورت زیر صادر می‌شود:

  • همه درخواست‌های «تکمیل خودکار (جدید)» با SKU: Autocomplete Session Usage صورت‌حساب می‌شوند، یعنی هزینه‌ای برای این درخواست‌ها دریافت نمی‌شود.
  • درخواست اختیاری «جزئیات جا» (اصول) بدون هزینه صورت‌حساب می‌شود، اگر قبل‌از درخواست «اعتبارسنجی نشانی» پایانی درخواست شود.
  • درخواست «اعتبارسنجی نشانی» خاتمه‌دهنده با شناسه کالا: Address Validation Enterprise صورت‌حساب می‌شود.
نمودار صورت‌حساب برای «تکمیل خودکار» برای سناریوی تسویه‌حساب و تحویل

قیمت‌گذاری بدون جلسه

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

قیمت‌گذاری برای جلسه‌های ناقص یا رهاشده

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