使用工作階段符記

選取平台： Android iOS 網路服務

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

建立工作階段權杖

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

範例

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

現在就從應用程式的角度來檢視這個事件流程。

  1. 使用者開始輸入查詢，搜尋「法國巴黎」。
  2. 偵測到使用者輸入內容後，應用程式會建立新的工作階段符記「Token A」。
  3. 使用者輸入時，API 會每隔幾個字元發出自動完成要求，並為每個字元顯示新的潛在結果清單：
    「P」
    「Par」
    「Paris」
    「Paris, Fr」
  4. 使用者選取項目時：
    • 查詢產生的所有要求都會分組，並以單一要求的形式新增至以「Token A」表示的工作階段。
    • 系統會將使用者的選取項目計為 Place Detail 要求，並加入以「符記 A」表示的工作階段。
  5. 工作階段結束，應用程式會捨棄「權杖 A」。

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