工作階段符記
工作階段符記是使用者產生的字串 (或物件),可追蹤 Autocomplete (新版) 呼叫的工作階段。Autocomplete (New) 會使用工作階段符記,將使用者自動完成搜尋的查詢和選取階段歸入不同的工作階段,以用於計費。
使用者必須為每個工作階段建立工作階段權杖。工作階段符記必須是網址和檔案名稱安全的 Base64 字串。使用者可以以任何方式產生工作階段權杖,不過 Google 建議您使用第 4 版通用專屬 ID (UUID) 做為工作階段權杖。
工作階段一開始會呼叫 Autocomplete (新版),結束時則會呼叫 Place Details (新版) 或 Address Validation。每個工作階段可以有多個 Autocomplete (New) 查詢,接著是對 Place Details (New) 或 Address Validation 的單一要求。在單一工作階段中,用於每項要求的 API 金鑰必須屬於同一個 Google Cloud 控制台專案。
工作階段符記會以以下方式終止:
- 呼叫 Place Details (New)。
- 呼叫 Address Validation。
- 工作階段已中斷。
工作階段結束後,符記就會失效;您的應用程式必須為每個新的工作階段產生新的符記。如果省略 sessionToken 參數或重複使用工作階段符記,系統會視為未提供工作階段符記,並針對新工作階段收費 (每個要求分別收費)。
如要進一步瞭解 Autocomplete (新版) 要求的計費方式,請參閱「Autocomplete (新版) 和工作階段的定價」。