Google 建議您搭配使用工作階段和 Autocomplete (新版)。工作階段可簡化定價,並為 Autocomplete (New) 提供一致的計費模式。
工作階段從第一個包含工作階段符記的 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 (New) 要求:系統會以 SKU:Autocomplete Session Usage 計費,也就是說,這些要求不會產生費用。
- Place Details (新版) Essentials:系統也會針對終止要求,按照 SKU:Places API Place Details Essentials 計費。
在地址驗證或 Place Details (New) (非 Essentials) 要求中終止的工作階段
如果 Autocomplete (新版) 工作階段以地址驗證要求或 Place Details (新版) 要求終止,且使用 Place Details Pro、Enterprise 或 Enterprise + Atmosphere 的欄位:
- Autocomplete (新版) 要求:所有 Autocomplete (新版) 要求都會以 SKU:Autocomplete Session Usage 計費,也就是說,這些要求不會產生費用。
-
Place Details (New) 或地址驗證要求:系統也會根據適當的 SKU,針對終止要求向您收費:
- 無論要求哪些欄位,Place Details (新版) 終止要求都會依 SKU:Place Details Enterprise + Atmosphere 計費。
- 地址驗證 終止要求會以 SKU:Address Validation Enterprise 計費。
工作階段計費情境
以下是三種最常見的工作階段定價情境:
以下各節將說明各情境的個別帳單費用。
自動完成位置資料
在「自動完成位置資料」情境中,您想使用 Autocomplete (新版) 和 Place Details (新版) 取得地點的位置資訊。舉例來說,您從 Autocomplete (新版) 選取建議,然後使用 Place Details (新版) 取得地點的經緯度座標,在地圖上顯示該地點。
位置資訊可能包括:
- 地址
- 位置 (經緯度座標)
- Plus Code
- 類型
- 可視區域
只要對 Place Details (New) 發出單一要求,要求 SKU:Place Details Essentials 定義的欄位,就會終止工作階段。
計費方式如下:
- 前 12 項 Autocomplete (新版) 要求會以 SKU:Autocomplete Requests 計費。
- 所有剩餘的 Autocomplete (New) 要求都會以 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 Session Usage 計費,也就是說,這些要求不會產生費用。
- 終止的 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 要求計費。