تکمیل خودکار مکان از نشانه‌های جلسه برای گروه‌بندی مراحل جستجو و انتخاب یک جستجوی تکمیل خودکار کاربر در یک جلسه مجزا برای اهداف صورتحساب استفاده می‌کند. جلسه زمانی شروع می شود که کاربر شروع به تایپ یک پرس و جو می کند، و زمانی که یک مکان را انتخاب می کند و تماسی با جزئیات مکان برقرار می شود، به پایان می رسد. هر جلسه می تواند چندین پرس و جو تکمیل خودکار داشته باشد و به دنبال آن یک مکان انتخاب شود. کلید(های) API مورد استفاده برای هر درخواست در یک جلسه باید متعلق به همان پروژه Google Cloud Console باشد. پس از پایان جلسه، رمز دیگر معتبر نیست. برنامه شما باید برای هر جلسه یک توکن جدید تولید کند. اگر پارامتر sessiontoken حذف شود، یا اگر از یک نشانه جلسه استفاده مجدد کنید، هزینه جلسه به گونه ای محاسبه می شود که گویی هیچ نشانه جلسه ارائه نشده است (هر درخواست جداگانه صورتحساب می شود).
ما دستورالعمل های زیر را توصیه می کنیم:
- از نشانه‌های جلسه برای تمام جلسات تکمیل خودکار استفاده کنید.
- برای هر جلسه یک نشانه جدید ایجاد کنید .
- اطمینان حاصل کنید که کلید(های) API مورد استفاده برای همه درخواست‌های تکمیل خودکار مکان و جزئیات مکان در یک جلسه متعلق به همان پروژه Google Cloud Console است.
- مطمئن شوید که برای هر جلسه جدید یک نشانه جلسه منحصر به فرد ارسال می کنید. استفاده از یک نشانه برای بیش از یک جلسه باعث می شود که هر درخواست به صورت جداگانه صورتحساب شود.
شما می توانید به صورت اختیاری نشانه تکمیل خودکار جلسه را از یک درخواست حذف کنید. اگر نشانه جلسه حذف شود، هر درخواست جداگانه صورتحساب می‌شود و SKU تکمیل خودکار - هر درخواست را راه‌اندازی می‌کند. اگر از یک نشانه جلسه استفاده مجدد کنید، جلسه نامعتبر تلقی می شود و درخواست ها به گونه ای محاسبه می شوند که گویی نشانه جلسه ارائه نشده است.
مثال
همانطور که کاربر یک پرس و جو را تایپ می کند، هر چند ضربه کلید (نه به ازای هر کاراکتر) یک درخواست تکمیل خودکار فراخوانی می شود و لیستی از نتایج ممکن برگردانده می شود. هنگامی که کاربر انتخابی را از لیست نتایج انجام می دهد، انتخاب به عنوان یک درخواست حساب می شود و همه درخواست های انجام شده در طول جستجو به صورت دسته بندی شده و به عنوان یک درخواست شمارش می شوند. اگر کاربر مکانی را انتخاب کند، درخواست جستجو بدون هزینه در دسترس است و فقط درخواست داده مکان هزینه می شود. اگر کاربر ظرف چند دقیقه پس از شروع جلسه انتخابی انجام ندهد، فقط درخواست جستجو شارژ می شود.
بیایید این جریان رویدادها را از منظر یک اپلیکیشن بررسی کنیم.
- کاربر شروع به تایپ یک پرس و جو برای جستجوی "پاریس، فرانسه" می کند.
- پس از شناسایی ورودی کاربر، برنامه یک نشانه جلسه جدید، "Token A" ایجاد می کند.
- همانطور که کاربر تایپ می کند، API هر چند کاراکتر یک درخواست تکمیل خودکار می کند و لیست جدیدی از نتایج بالقوه را برای هر یک نمایش می دهد:
"پ"
"پار"
"پاریس"
"پاریس، فر" - هنگامی که کاربر انتخاب می کند:
- تمام درخواست های حاصل از پرس و جو گروه بندی می شوند و به عنوان یک درخواست به جلسه ارائه شده توسط "Token A" اضافه می شوند.
- انتخاب کاربر به عنوان یک درخواست جزئیات مکان شمارش می شود و به جلسه ای که با "Token A" نشان داده می شود اضافه می شود.
- جلسه به پایان می رسد و برنامه "Token A" را کنار می گذارد.
برای اطلاعات بیشتر درباره نحوه صدور صورتحساب درخواست‌های تکمیل خودکار، استفاده و صورتحساب را ببینید.
ایجاد نشانه های جلسه
برای ایجاد یک نشانه جلسه، AutocompleteSessionToken.newInstance() را فراخوانی کنید.