«تکمیل خودکار مکان» (قدیمی) از نشان‌های جلسه برای گروه‌بندی مراحل پُرسمان و انتخاب جستجوی تکمیل خودکار کاربر در یک جلسه مجزا برای اهداف صدور صورت‌حساب استفاده می‌کند. جلسه زمانی شروع می‌شود که کاربر شروع به تایپ کردن پُرسمان می‌کند و زمانی به‌پایان می‌رسد که کاربر مکانی را انتخاب می‌کند و تماسی با «جزئیات مکان (قدیمی)» برقرار می‌شود. هر جلسه می‌تواند
چندین پُرسمان تکمیل خودکار داشته باشد که با یک انتخاب مکان دنبال می‌شود. کلید(های) API مورداستفاده برای هر درخواست در یک جلسه باید متعلق به پروژه
کنسول Google Cloud یکسان باشد. پس‌از پایان جلسه، کد دیگر معتبر نیست؛ برنامه شما باید برای هر جلسه کد جدیدی تولید کند. اگر پارامتر
sessiontoken حذف شود، یا اگر از رمز جلسه مجدداً استفاده کنید، هزینه جلسه به‌گونه‌ای محاسبه می‌شود که انگار رمز جلسه ارائه نشده است (هزینه هر درخواست
به‌طور جداگانه محاسبه می‌شود).
توصیه می‌کنیم از رهنمودهای زیر پیروی کنید:
- از نشان‌های جلسه برای همه جلسه‌های تکمیل خودکار استفاده کنید.
- برای هر جلسه کد جدیدی تولید کنید.
- مطمئن شوید که کلید(های) API استفاده‌شده برای همه درخواست‌های «تکمیل خودکار مکان» (قدیمی) و «جزئیات مکان» (قدیمی) در یک جلسه متعلق به یک پروژه «واحد مدیریت Google Cloud» باشد.
- حتماً برای هر جلسه جدید، کد جلسه یکتایی ارسال کنید. استفاده از یکسان برای بیش از یک جلسه منجر به صورت‌حساب جداگانه برای هر درخواست می‌شود.
می‌توانید به‌صورت اختیاری کد جلسه تکمیل خودکار را از درخواست حذف کنید. اگر کد جلسه حذف شود، هر درخواست به‌طور جداگانه صورت‌حساب می‌شود و تکمیل خودکار - به‌ازای هر درخواست SKU را فعال می‌کند. اگر از کد جلسه مجدداً استفاده کنید، جلسه نامعتبر درنظر گرفته می‌شود و درخواست‌ها طوری محاسبه می‌شود که انگار کد جلسه ارائه نشده است.
مثال
وقتی کاربر پُرسمانی را تایپ می‌کند، درخواست تکمیل خودکار هر چند ضربه کلید (نه به‌ازای هر نویسه) فراخوانی می‌شود و فهرستی از نتایج احتمالی برگردانده می‌شود. وقتی کاربر از فهرست نتایج انتخابی انجام می‌دهد، انتخاب به‌عنوان درخواست محسوب می‌شود و همه درخواست‌های انجام‌شده درطول جستجو دسته‌بندی و به‌عنوان یک درخواست واحد شمارش می‌شوند. اگر کاربر مکانی را انتخاب کند، پرسمان جستجو بدون هزینه دردسترس است و فقط هزینه درخواست داده‌های «مکان» از کاربر کسر می‌شود. اگر کاربر ظرف چند دقیقه پس‌از شروع جلسه انتخابی انجام ندهد، فقط هزینه پُرسمان جستجو از او کسر می‌شود.
بیایید این جریان رویدادها را از دیدگاه یک برنامه بررسی کنیم.
- کاربری شروع به تایپ کردن پُرسمانی برای جستجوی «پاریس، فرانسه» می‌کند.
- پس‌از شناسایی ورودی کاربر، برنامه کد جلسه جدیدی به‌نام «کد A» ایجاد می‌کند.
- همان‌طور که کاربر تایپ می‌کند، میانای برنامه‌سازی کاربردی هر چند نویسه یک‌بار درخواست تکمیل خودکار می‌کند و فهرست جدیدی از نتایج احتمالی را برای هرکدام نمایش می‌دهد:
«P»
«Par»
«Paris,»
«Paris, Fr»
- وقتی کاربر انتخابی انجام می‌دهد:
- همه درخواست‌های ناشی از پُرسمان گروه‌بندی می‌شوند و به‌عنوان یک درخواست واحد به جلسه نشان‌داده‌شده با «نشان A» اضافه می‌شوند.
- انتخاب کاربر به‌عنوان درخواست «جزئیات مکان» محاسبه می‌شود و به جلسه نشان‌داده‌شده با «نشان A» اضافه می‌شود.
- جلسه به‌پایان می‌رسد و برنامه «رمز A» را دور می‌اندازد.
برای اطلاعات بیشتر درباره نحوه صورت‌حساب درخواست‌های «تکمیل خودکار مکان» (قدیمی)، به استفاده و صورت‌حساب مراجعه کنید.
ایجاد کردن نشان‌های جلسه
برای ایجاد کردن نشان جلسه،
GMSAutocompleteSessionToken.init() را فراخوانی کنید.