בתכונה 'השלמה אוטומטית למקומות' (מדור קודם) נעשה שימוש באסימוני סשן כדי לקבץ את שלבי השאילתה והבחירה בחיפוש של משתמש עם השלמה אוטומטית לסשן נפרד למטרות חיוב. הסשן מתחיל כשהמשתמש מתחיל להקליד שאילתה, ומסתיים כשהמשתמש בוחר מקום ומתבצעת קריאה ל-Place Details (Legacy). כל סשן יכול לכלול כמה שאילתות להשלמה אוטומטית, ואחריה בחירה של מקום אחד. מפתחות ה-API שמשמשים לכל בקשה בסשן חייבים להיות שייכים לאותו פרויקט במסוף Google Cloud. בסיום הסשן, האסימון כבר לא תקף. האפליקציה צריכה ליצור אסימון חדש לכל סשן. אם הפרמטר sessiontoken לא יצוין או אם תשתמשו שוב באסימון סשן, הסשן יחויב כאילו לא סופק אסימון סשן (כל בקשה מחויבת בנפרד).
מומלץ לפעול לפי ההנחיות הבאות:
- שימוש באסימוני סשן לכל סשנים של מילוי אוטומטי.
- יוצרים טוקן חדש לכל סשן.
- חשוב לוודא שמפתחות ה-API שמשמשים לכל הבקשות של Place Autocomplete (מדור קודם) ושל פרטי מקום (מדור קודם) בסשן שייכים לאותו פרויקט במסוף Google Cloud.
- חשוב להעביר אסימון סשן ייחודי לכל סשן חדש. שימוש באותו אסימון ביותר מסשן אחד יוביל לחיוב בנפרד על כל בקשה.
אפשר להשמיט את אסימון הסשן של ההשלמה האוטומטית מבקשה. אם משמיטים את אסימון הסשן, כל בקשה מחויבת בנפרד, וכתוצאה מכך מופעל המק"ט Autocomplete – Per Request. אם משתמשים שוב באסימון סשן, הסשן נחשב לא תקף והבקשות יחויבו כאילו לא סופק אסימון סשן.
דוגמה
כשהמשתמש מקלידים שאילתות, מתבצעת קריאה לבקשה להשלמה אוטומטית אחרי כל כמה הקשות (לא לכל תו) והמערכת מחזירה רשימה של תוצאות אפשריות. כשהמשתמש בוחר מתוך רשימת התוצאות, הבחירה נספרת כבקשה, וכל הבקשות שנשלחות במהלך החיפוש מקובצות ונספרות כבקשה אחת. אם המשתמש בוחר מקום, שאילתת החיפוש זמינה ללא תשלום, ורק הבקשה לנתוני המקום מחויבת. אם המשתמש לא מבצע בחירה תוך כמה דקות מתחילת הסשן, מתבצע חיוב רק על שאילתה החיפוש.
נבחן את תהליך האירועים הזה מנקודת המבט של אפליקציה.
- משתמש מתחיל להקליד שאילתה לחיפוש 'פריז, צרפת'.
- כשהאפליקציה מזהה קלט של משתמש, היא יוצרת אסימון סשן חדש, 'אסימון א'.
- כשהמשתמש מקלידים, ה-API שולח בקשה להשלמה אוטומטית אחרי כל כמה תווים, ומציג רשימה חדשה של תוצאות אפשריות לכל אחד מהם:
"P"
"Par"
"Paris,"
"Paris, Fr"
- כשהמשתמש מבצע בחירה:
- כל הבקשות שמתקבלות מהשאילתה מקובצות ומתווספות לסשן שמיוצג על ידי אסימון א', כבקשה אחת.
- הבחירה של המשתמש נספרת כבקשה לפרטים של מקום, ומתווספת לסשן שמיוצג על ידי אסימון א'.
- הסשן מסתיים והאפליקציה משליכה את אסימון א'.
למידע נוסף על החיוב על בקשות להשלמה אוטומטית של מקומות (מדור קודם), קראו את המאמר שימוש וחיוב.
יצירת אסימוני סשן
כדי ליצור אסימון סשן, צריך להפעיל את הפונקציה AutocompleteSessionToken.newInstance().