אסימוני סשנים

התכונה 'השלמה אוטומטית למקומות' משתמשת באסימוני סשן כדי לקבץ את שלבי השאילתה והבחירה בחיפוש של משתמש עם השלמה אוטומטית לסשן נפרד למטרות חיוב. הסשן מתחיל כשהמשתמש מתחיל להקליד שאילתה, ומסתיים כשהמשתמש בוחר מקום ומתבצעת קריאה לפונקציה Place Details. בכל סשן יכולות להיות כמה שאילתות להשלמה אוטומטית, ואחריה בחירה של מקום אחד. מפתחות ה-API שמשמשים לכל בקשה בסשן חייבים להיות שייכים לאותו פרויקט במסוף Google Cloud. בסיום הסשן, האסימון כבר לא תקף. האפליקציה צריכה ליצור אסימון חדש לכל סשן. אם הפרמטר sessiontoken לא יצוין או אם תשתמשו שוב באסימון סשן, הסשן יחויב כאילו לא סופק אסימון סשן (כל בקשה מחויבת בנפרד).

מומלץ לפעול לפי ההנחיות הבאות:

• שימוש באסימוני סשן לכל סשנים של מילוי אוטומטי.
• יוצרים טוקן חדש לכל סשן.
• חשוב לוודא שמפתחות ה-API ששימשו לכל הבקשות של השלמה אוטומטית של מקומות ושל פרטי מקומות במהלך סשן שייכים לאותו פרויקט במסוף Google Cloud.
• חשוב להעביר אסימון סשן ייחודי לכל סשן חדש. שימוש באותו אסימון ביותר מסשן אחד יוביל לחיוב בנפרד על כל בקשה.

אפשר להשמיט את אסימון הסשן של ההשלמה האוטומטית מהבקשה. אם משלימים את אסימון הסשן, כל בקשה מחויבת בנפרד, וכתוצאה מכך מופעל המק"ט Autocomplete – Per Request. אם משתמשים שוב באסימון סשן, הסשן נחשב לא תקף והבקשות יחויבו כאילו לא סופק אסימון סשן.

דוגמה

כשהמשתמש מקלידים שאילתות, מתבצעת קריאה לבקשה להשלמה אוטומטית אחרי כל כמה הקשות (לא לכל תו) והמערכת מחזירה רשימה של תוצאות אפשריות. כשהמשתמש בוחר מתוך רשימת התוצאות, הבחירה נספרת כבקשה, וכל הבקשות שנשלחות במהלך החיפוש מקובצות ונספרות כבקשה אחת. אם המשתמש בוחר מקום, שאילתת החיפוש זמינה ללא תשלום, ורק הבקשה לנתוני המקום מחויבת. אם המשתמש לא מבצע בחירה תוך כמה דקות מתחילת הסשן, תחויבו רק על שאילתה החיפוש.

נבחן את תהליך האירועים הזה מנקודת המבט של אפליקציה.

1. משתמש מתחיל להקליד שאילתת חיפוש עבור 'פריז, צרפת'.
2. כשהאפליקציה מזהה קלט של משתמש, היא יוצרת טוקן סשן חדש, 'אסימון א'.
3. כשהמשתמש מקלידים, ה-API שולח בקשה להשלמה אוטומטית אחרי כל כמה תווים, ומציג רשימה חדשה של תוצאות אפשריות לכל אחד מהם:
   "P"
   "Par"
   "Paris,"
   "Paris, Fr"
   
4. כשהמשתמש מבצע בחירה:
   • כל הבקשות שנובעות מהשאילתה מקובצות ומתווספות לסשן שמיוצג על ידי אסימון א', כבקשה אחת.
   • הבחירה של המשתמש נספרת כבקשה לפרטים של מקום, ומתווספת לסשן שמיוצג על ידי אסימון א'.
5. הסשן מסתיים והאפליקציה משליכה את אסימון א'.

למידע נוסף על החיוב על בקשות להשלמה אוטומטית, קראו את המאמר שימוש וחיוב.

יצירת אסימוני סשן

כדי ליצור אסימון סשן, צריך להפעיל את הפונקציה AutocompleteSessionToken.newInstance().