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