工作階段符記

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

建議您遵循下列準則：

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

您可以選擇從要求中省略自動完成工作階段符記。如果省略工作階段符記，系統會針對每項要求分別收費，並觸發 Autocomplete - Per Request SKU。假如您重複使用工作階段符記，系統會將工作階段視為無效，並針對相關要求收費 (因為系統會將其視為未提供工作階段符記)。

範例

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

讓我們從應用程式的角度，探討這個事件流程。

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

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

建立工作階段符記

您可以使用任何偏好的程式輔助機制建立工作階段權杖。建議您使用第 4 版 UUID 做為工作階段符記。