כשהמשתמש מקלידים שאילתות, מתבצעת קריאה לבקשה להשלמה אוטומטית אחרי כל כמה הקשות (לא לכל תו) והמערכת מחזירה רשימה של תוצאות אפשריות. כשהמשתמש בוחר מתוך רשימת התוצאות, הבחירה נספרת כבקשה, וכל הבקשות שנשלחות במהלך החיפוש מקובצות ונספרות כבקשה אחת. אם המשתמש בוחר מקום, שאילתת החיפוש זמינה ללא תשלום, ורק הבקשה לנתוני המקום מחויבת. אם המשתמש לא יבצע בחירה תוך כמה דקות מתחילת הסשן, יחויב רק על שאילתה החיפוש.
נבחן את תהליך האירועים הזה מנקודת המבט של אפליקציה.
משתמש מתחיל להקליד שאילתה לחיפוש 'פריז, צרפת'.
כשהאפליקציה מזהה קלט של משתמש, היא יוצרת טוקן סשן חדש, 'אסימון א'.
כשהמשתמש מקלידים, ה-API שולח בקשה להשלמה אוטומטית אחרי כל כמה תווים, ומציג רשימה חדשה של תוצאות אפשריות לכל אחד מהם:
"P"
"Par"
"Paris,"
"Paris, Fr"
כשהמשתמש מבצע בחירה:
כל הבקשות שנובעות מהשאילתה מקובצות ומתווספות לסשן שמיוצג על ידי 'אסימון א', כבקשה אחת.
הבחירה של המשתמש נספרת כבקשה לפרטים של מקום, ומתווספת לסשן שמיוצג על ידי אסימון א'.
הסשן מסתיים והאפליקציה משליכה את אסימון א'.
מידע נוסף על החיוב של בקשות להשלמה אוטומטית זמין במאמר שימוש וחיובים.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-02-28 (שעון UTC)."],[[["Session tokens are used to group autocomplete search queries and selections for billing purposes."],["Each session requires a unique token, ideally a version 4 UUID."],["Autocomplete requests are bundled and billed as a single request when a user makes a selection."],["If no selection is made, only the search query is charged after a few minutes."],["Session tokens can be shared across different Google Cloud projects, but must be unique within a single project."]]],["This document details the use of session tokens with the Places API. A session token groups a user's autocomplete search into a single session for billing. Users must create unique session tokens (version 4 UUIDs recommended) for each session, ensuring uniqueness within a project. Requests are bundled into a session. If a user selects a place, only the place details are charged; otherwise, only the search query is charged. Each session ends after a user's selection or inactivity, at which point the token is discarded.\n"]]
