工作階段符記

工作階段符記是使用者產生的字串 (或物件),可將 Autocomplete (新版) 的呼叫視為「工作階段」來追蹤。Autocomplete (新版) 會使用工作階段符記,將使用者自動完成搜尋的查詢和選取階段歸入不同的工作階段,以用於計費。

使用者須負責為每個工作階段建立工作階段符記。工作階段符記必須是網址和檔案名稱安全 Base64 字串。使用者可以以任何方式產生工作階段符記,但 Google 建議您針對工作階段符記使用第 4 版的通用唯一識別碼 (UUID)

工作階段從對 Autocomplete (新版) 的呼叫開始,然後結束呼叫 Place Details (New)Address Validation。每個工作階段都可以有多項 Autocomplete (新版) 查詢,後面接著一項對 Place Details (新版) 或地址驗證的要求。工作階段中每個要求使用的 API 金鑰,都必須屬於同一個 Google Cloud 控制台專案。

工作階段符記終止方式如下:

  • 呼叫 Place Details (新版)。
  • 呼叫地址驗證。
  • 工作階段已遭捨棄。

工作階段結束後,憑證就會失效;應用程式必須為每個新的工作階段產生新的符記。如果省略 sessionToken 參數或重複使用工作階段符記,系統會視為未提供工作階段符記,針對新的工作階段收費 (每個要求分別收費)。

如要進一步瞭解 Autocomplete (新版) 要求的計費方式,請參閱「Autocomplete (新版) 和工作階段定價」。