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