工作階段符記會將使用者自動完成搜尋的查詢和選取階段歸入不同的工作階段,以用於計費。
建立工作階段符記
使用者負責為每個工作階段產生專屬的工作階段權杖。Google 建議使用第 4 版 UUID。
範例
使用者輸入查詢時,系統會每隔幾個按鍵 (不是每個字元) 呼叫一次自動完成要求,並傳回可能的結果清單。當使用者從結果清單中選取項目時,系統會將該選取項目視為要求,並將搜尋期間提出的所有要求合併計算為單一要求。如果使用者選取地點,系統就會免費提供搜尋查詢,且只會收取地點資料要求的費用。如果使用者在工作階段開始後的幾分鐘內未選取任何項目,系統只會收取搜尋查詢費用。
讓我們從應用程式的角度來檢視這個事件流程。
- 使用者開始輸入查詢,搜尋「巴黎 (法國)」。
- 在偵測到使用者輸入內容後,應用程式會建立新的「Token A」工作階段符記。
- 使用者輸入內容時,API 會每隔幾個字元發出自動完成要求,並為每個字元顯示新的可能結果清單:
"P"
"Par"
"Paris,"
"Paris, Fr"
- 使用者選取項目時:
- 查詢產生的所有要求會分組,並以單一要求的形式新增至由「Token A」代表的工作階段。
- 使用者的選項會計為 Place Detail 要求,並新增至由「Token A」代表的工作階段。
- 工作階段結束,應用程式會捨棄「Token A」。
如要進一步瞭解自動完成要求的計費方式,請參閱「用量與計費」一文。