使用工作階段符記

工作階段符記會將使用者自動完成搜尋的查詢和選取階段歸入不同的工作階段，以用於計費。

建立工作階段符記

使用者必須為每個工作階段產生專屬的工作階段權杖。Google 建議使用第 4 版 UUID。

範例

使用者輸入查詢時，系統每隔幾次按鍵 (而非每個字元) 就會呼叫自動完成要求，並傳回可能結果的清單。使用者從結果清單中選取項目時，該選取項目會計為一項要求，而搜尋期間提出的所有要求都會合併並計為一項要求。如果使用者選取地點，搜尋查詢本身免付費，系統只會針對 Place Data 要求收費。如果使用者在工作階段開始後幾分鐘內未選取任何項目，系統只會收取搜尋查詢費用。

我們從應用程式的角度來檢視這個事件流程。

1. 使用者開始輸入查詢，搜尋「法國巴黎」。
2. 偵測到使用者輸入內容後，應用程式會建立新的工作階段符記「符記 A」。
3. 使用者輸入時，API 每隔幾個字元就會提出自動完成要求，並顯示每個要求的潛在結果新清單：
   「P」
   「Par」
   「Paris,」
   「Paris, Fr」
4. 使用者選取後：

• 系統會將查詢產生的所有要求分組，並以單一要求的形式，新增至「權杖 A」代表的工作階段。
• 系統會將使用者的選取項目計為 Place Detail 要求，並新增至「符記 A」代表的工作階段。
• 工作階段結束，應用程式捨棄「權杖 A」。

如要進一步瞭解 Autocomplete 要求的計費方式，請參閱「用量與計費」一文。