工作階段符記會將使用者自動完成搜尋的查詢和選取階段歸入不同的工作階段,以用於計費。
建立工作階段符記
使用者負責為每個工作階段產生不重複的工作階段符記。Google 建議您使用第 4 版 UUID。
範例
當使用者輸入查詢時,每隔幾個按鍵動作就會呼叫自動完成要求 (而非每個字元),並傳回可能的結果清單。使用者從結果清單中做出選擇時,所選動作會計為一次要求,且搜尋期間的所有要求都會組合成單一要求,並計為單一要求。如果使用者選取地點,即可免費使用搜尋查詢,而且只有地點資料要求會計費。如果使用者未在工作階段開始的幾分鐘內做出選擇,則系統只會針對搜尋查詢收費。
接著我會從應用程式的角度仔細檢視這個事件流程。
- 使用者開始輸入查詢,以搜尋「法國巴黎」。
- 偵測到使用者輸入內容時,應用程式會建立新的工作階段權杖「權杖 A」。
- 當使用者輸入內容時,API 每隔幾位字元就會發出自動完成要求,並為每個字元顯示新的可能結果清單:
"P"
"Par"
"巴黎,
"巴黎, Fr"
- 使用者做出選擇後:
- 系統會將查詢產生的所有要求分門別類,並新增至以「符記 A」表示的工作階段,做為單一要求。
- 使用者的所選項目會計為 Place Details 要求,並新增至「代碼 A」代表的工作階段。
- 工作階段已結束,應用程式會捨棄「權杖 A」。
如要進一步瞭解 Autocomplete 要求的計費方式,請參閱「用量與計費」一文。