工作階段符記

選取平台： Android iOS JavaScript 網路服務

Place Autocomplete 會使用工作階段符記，將使用者自動完成搜尋的查詢和選取階段歸入不同的工作階段，以用於計費。工作階段是從使用者輸入查詢時開始，到使用者選取地點並呼叫 Place Details 時結束。每個工作階段都可以有多個自動完成查詢，並在之後選擇一個地點。在工作階段中，每個要求使用的 API 金鑰必須屬於同一個 Google Cloud 控制台專案。工作階段結束後，符記就會失效；您的應用程式必須為每個工作階段產生新的符記。如果省略 sessiontoken 參數或重複使用工作階段符記，系統會視為未提供工作階段符記，並針對工作階段收費 (每個要求分別收費)。

建議您遵守下列規範：

  • 在所有自動完成工作階段使用工作階段符記。
  • 為每個工作階段產生新的權杖。
  • 確認同一個工作階段中，所有 Place Autocomplete 和 Place Details 要求使用的 API 金鑰屬於同一個 Google Cloud 控制台專案。
  • 請務必針對每個新的工作階段傳遞不重複的工作階段符記。如果多個工作階段使用同一個符記，則每個要求會分別計費。

您可以選擇省略要求中的 Autocomplete 工作階段符記。如果省略工作階段符記，則每個要求會分開計費，觸發 Autocomplete - Per Request SKU。假如您重複使用工作階段符記，系統會將工作階段視為無效，並依照未提供工作階段符記的情況收取相關要求費用。

範例

使用者輸入查詢時，每隔幾下按鍵 (非每個字元) 都會呼叫自動完成要求，並傳回可能的結果清單。當使用者從結果清單中做出選擇時，所選設定會計為要求，且搜尋期間發出的所有要求都會組成組合，並計為單一要求。如果使用者選取地點，則可免費使用搜尋查詢，且只會收取地點資料要求的費用。如果使用者未在工作階段開始的幾分鐘內進行選擇，系統只會收取搜尋查詢費用。

接著從應用程式的角度來探索這個事件流程。

  1. 使用者開始輸入查詢，以便搜尋「法國巴黎」。
  2. 偵測到使用者輸入內容時，應用程式會建立新的工作階段符記「權杖 A」。
  3. 隨著使用者輸入內容，API 每隔幾個字元就會發出自動完成要求，並顯示各個字元的可能結果清單：
    「P」
    「Par」
    「巴黎」、「
    」「巴黎」
  4. 使用者做出選擇時：
    • 從查詢產生的所有要求都會經過分組，並加進以「權杖 A」表示的工作階段，做為單一要求。
    • 使用者選擇的項目會計為 Place Detail 要求，並加進以「權杖 A」代表的工作階段。
  5. 工作階段已結束，應用程式捨棄「權杖 A」。

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

建立工作階段符記

如要建立工作階段符記，請呼叫 AutocompleteSessionToken.newInstance()。