工作階段符記

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

使用者必須為每個工作階段建立工作階段權杖。工作階段權杖必須是網址和檔案名稱安全 Base64 字串。使用者可以透過任何方式產生工作階段權杖,但 Google 建議使用第 4 版通用專屬 ID (UUID) 做為工作階段權杖。

工作階段的開頭是呼叫 Autocomplete (New),結尾是呼叫地點詳細資料 (新版)地址驗證。在每個工作階段中,使用者可以輸入多筆 Autocomplete (New) 查詢,最終提出一項 Place Details (New) 或 Address Validation 要求。工作階段中每個要求使用的 API 金鑰必須屬於同一個 Google Cloud 控制台專案。

工作階段符記會透過下列方式終止:

  • 呼叫 Place Details (New)。
  • 系統會呼叫地址驗證。
  • 工作階段已遭捨棄。

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

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