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