Google 建議您搭配使用工作階段和 Autocomplete (新版)。工作階段可簡化計價方式,並提供一致的 Autocomplete (新版) 計價模式。
工作階段從第一個包含工作階段符記的 Autocomplete (New) 要求開始,並在後續每個 Autocomplete (New) 要求中持續進行,最後由使用工作階段符記的 Place Details (New) 或地址驗證要求終止。
工作階段終止後,如果使用過期的工作階段符記呼叫 Autocomplete (New)、Place Details (New) 或 Address Validation,系統會視為沒有工作階段符記來計費。
如果工作階段不完整 (也就是未因 Place Details (新版) 或地址驗證要求而終止),系統只會針對 Autocomplete (新版) 要求,按照 SKU:Autocomplete Requests 計費。
工作階段計費
以 Place Details (New) Essentials 要求結束的工作階段
如果 Autocomplete (新版) 工作階段結束時,要求使用 SKU:Places API Place Details Essentials 的欄位:
- 前 12 個 Autocomplete (新版) 要求:系統會依據 SKU:Autocomplete 要求,針對每個 Autocomplete (新版) 要求收費,最多 12 個要求。
- 在同一個工作階段中,第 13 次及之後的 Autocomplete (新版) 要求:系統會以 SKU:Autocomplete Session Usage 計費,也就是不收取這些要求的費用。
- Place Details (新版) Essentials:系統也會針對終止要求,按照 SKU:Places API Place Details Essentials 計費。
在地址驗證或 Place Details (New) (非 Essentials) 要求中終止的工作階段
如果 Autocomplete (新版) 工作階段終止於地址驗證要求,或使用 Place Details Pro、Enterprise 或 Enterprise + Atmosphere 欄位的 Place Details (新版) 要求:
- Autocomplete (新版) 要求:所有 Autocomplete (新版) 要求都會依 SKU:Autocomplete Session Usage 計費,也就是說,系統不會針對這些要求收費。
-
Place Details (新版) 或地址驗證要求:系統也會根據適用的 SKU,向您收取終止要求的費用:
- 無論要求的欄位為何,Place Details (新版) 終止要求都會依 SKU:Place Details Enterprise + Atmosphere 計費。
- 地址驗證 終止要求會依 SKU:Address Validation Enterprise 計費。
工作階段計費情境
以下是三種常見的工作階段定價情境:
以下各節將說明各情境的個別帳單費用。
自動完成位置資料
在「位置資料自動完成」情境中,您想使用 Autocomplete (新版) 和 Place Details (新版) 取得地點的位置資訊。舉例來說,您從 Autocomplete (新版) 選取建議,然後使用 Place Details (新版) 取得地點的經緯度座標,在地圖上顯示該地點。
位置資訊可能包括:
- 地址
- 以經緯度座標表示的位置
- Plus Code
- 類型
- 可視區域
對 Place Details (新版) 提出單一要求,且要求 SKU:Place Details Essentials 定義的欄位,即可終止工作階段。
計費方式如下:
- 前 12 個 Autocomplete (新版) 要求,會以 SKU:Autocomplete 要求計費。
- 其餘的 Autocomplete (新版) 要求會以 SKU:Autocomplete Session Usage 計費,也就是說,這些要求不會產生費用。
- 終止 Place Details (新版) 要求:依 SKU:Places API Place Details Essentials 計費。
使用自動完成功能探索地點
在「使用自動完成功能探索地點」情境中,您不只要取得地點的位置資料,例如,您可以要求下列任一項目:
- 無障礙功能選項
- 目前營業時間
- 停車選項
- 評論
- 評分
在這種情況下,只要向 Place Details (New) 提出單一要求,要求 Place Details (New) Pro、Enterprise 或 Enterprise + Atmosphere SKU 包含的任何欄位,工作階段就會終止。
計費方式如下:
- 所有 Autocomplete (新版) 要求都會以 SKU:Autocomplete 工作階段用量計費,也就是說,這些要求不會產生費用。
- 終止 Place Details (新版) 要求:按 SKU:Places API Place Details Enterprise + Atmosphere 計費。
自動完成結帳和運送資訊
Address Validation API 是一項可接受地址的服務。這項服務會識別地址元件並加以驗證。此外,這項服務也會將地址標準化以利郵寄,並找出最合適的經緯度座標。
在結帳和運送情境中,您會向 Address Validation API 傳送要求,驗證所選地址,並終止工作階段。
計費方式如下:
- 所有 Autocomplete (新版) 要求都會以 SKU:Autocomplete 工作階段用量計費,也就是說,這些要求不會產生費用。
- 如果在終止地址驗證要求前,提出選用的 Place Details Essentials 要求,則不需付費。
- 終止的地址驗證要求會依 SKU:地址驗證企業版 計費。
不含工作階段的定價
如果不使用工作階段,系統會依據 Autocomplete (新版) 的要求次數,按照 SKU:Autocomplete 要求計費。
未完成或放棄工作階段的定價
如果工作階段遭到捨棄 (也就是未透過呼叫 Place Details (新版) 或 Address Validation 終止),Autocomplete (新版) 要求會改用按要求計價模式,並依 SKU:Autocomplete 要求計費。