Place Autocomplete (舊版) 會使用工作階段符記,將使用者自動完成搜尋的查詢和選取階段歸入不同的工作階段,以用於計費。工作階段是從使用者輸入查詢時開始,到使用者選取地點並呼叫 Place Details (舊版) 時結束。在每個工作階段中,使用者可以輸入多筆自動完成查詢,最終選擇一個地點。在工作階段中,每個要求使用的 API 金鑰必須屬於同一個 Google Cloud 控制台專案。工作階段結束後,符記就會失效,因此應用程式必須為每個工作階段產生新的符記。如果省略 sessiontoken 參數或重複使用工作階段符記,系統會視為未提供工作階段符記,並針對工作階段收費 (每個要求分別收費)。
建議遵循下列規範:
- 在所有自動完成工作階段使用工作階段符記。
- 為每個工作階段產生新的權杖。
- 確認工作階段中所有 Place Autocomplete (舊版) 和 Place Details (舊版) 要求使用的 API 金鑰,都屬於同一個 Google Cloud 控制台專案。
- 請務必針對每個新的工作階段傳遞不重複的工作階段符記。如果多個工作階段使用同一個符記,則每個要求會分別計費。
您可以選擇在要求中省略自動完成工作階段符記。如果省略工作階段符記,系統會針對每項要求分別收費,並觸發 Autocomplete - Per Request SKU。假如您重複使用工作階段符記,系統會將工作階段視為無效,並依照未提供工作階段符記的情況收取相關要求費用。
範例
使用者輸入查詢時,系統每隔幾次按鍵 (而非每個字元) 就會呼叫自動完成要求,並傳回可能結果的清單。使用者從結果清單中選取項目時,該選取項目會計為一項要求,而搜尋期間提出的所有要求都會合併並計為一項要求。如果使用者選取地點,搜尋查詢本身免付費,系統只會針對 Place Data 要求收費。如果使用者在工作階段開始後幾分鐘內未選取任何項目,系統只會收取搜尋查詢費用。
從應用程式的角度來看,事件流程如下:
- 使用者開始輸入查詢,搜尋「法國巴黎」。
- 偵測到使用者輸入內容後,應用程式會建立新的工作階段符記「符記 A」。
- 使用者輸入時,API 每隔幾個字元就會發出自動完成要求,並顯示新的潛在結果清單:
「P」
「Par」
「Paris,」
「Paris, Fr」
- 使用者選取後:
- 查詢產生的所有要求都會分組,並以單一要求的形式,新增至「Token A」代表的工作階段。
- 系統會將使用者的選取項目計為 Place Detail 要求,並新增至「符記 A」代表的工作階段。
- 工作階段結束,應用程式捨棄「權杖 A」。
如要進一步瞭解 Place Autocomplete (舊版) 要求的計費方式,請參閱「用量與計費」一文。
建立工作階段符記
您可以使用偏好的程式輔助機制建立工作階段符記。建議使用第 4 版 UUID 做為工作階段符記。