Google 建議您採用自動完成 (新版) 的工作階段。工作階段有助於簡化價格流程,並提供一致的定價模式與 Autocomplete (新版) 搭配使用。
工作階段價格從包含工作階段符記的第一個 Autocomplete (新版) 要求開始,並持續到後續的每個 Autocomplete (新版) 要求,然後在使用工作階段符記的 Place Details (新版) 或地址驗證要求結束後結束。
工作階段終止後,凡是使用過期工作階段符記的 Autocomplete (新版)、Place Details (新版) 或 Address Validation (地址驗證),系統都會計費,就像沒有任何工作階段符記。
對於未完成的工作階段 (也就是未因 Place Details (新版) 或地址驗證要求而終止的工作階段),系統只會針對使用 SKU:Autocomplete Requests 的自動完成要求收費。
最常見的三種定價情境如下:
- 位置資料的自動完成功能
- 自動完成地點探索
- 結帳和運送資訊的自動完成功能
位置資料的自動完成功能
在這個情境中,您想使用 Autocomplete 和 Place Details (新版) 取得地點的相關位置資訊。舉例來說,您可以從自動完成功能中選取建議,然後使用 Place Details (新版) 取得地點的經緯度座標,在地圖上顯示該地點。
位置資訊可能包含地點的下列資訊:
- 地址
- 經緯度座標的地點
- Plus Code
- 類型
- 可視區域
這個工作階段會在向 Place Details (新版) 提出單一要求後結束,該要求會要求 SKU:Place Details (僅限位置) 定義的任何欄位。
則計費方式如下:
- 每個 Autocomplete (新版) 要求 (最多 12 個要求),使用 SKU:自動完成要求。
- 每 1000 項要求收費 $2.83 美元,最多 100,000 項要求
- 每 1,000 項要求收費 $2.27 美元,最多 500,000 項要求
- 如果您處於有效工作階段,自動完成 (新版) 要求的價格為 13 以上,系統會依據 SKU:Autocomplete Session Usage 向您收費。也就是說,這些要求不會產生任何費用。
- 使用 SKU:Place Details (Location Only) 的一個 Place Details 要求:
- 每 1,000 項要求收費 $5.00 美元,最多 100,000 項要求
- 每 1000 項要求收費 $4.00 美元,最多 500,000 項要求
自動完成地點探索
在地點探索情境的自動完成功能中,您除了取得地點位置資料之外,還想取得其他資料。舉例來說,您可以要求下列其中一項:
- 無障礙選項
- 目前營業時間
- 停車選項
- 評論
- 評分
在這種情況下,系統會在 Place Details (New) 要求中,要求 Place Details (New) Basic、Advanced 或 Preferred SKU 中包含的任何欄位,並終止您的工作階段。
則計費方式如下:
- 所有 Autocomplete (新版) 要求都會以 SKU:Autocomplete 工作階段使用量計費,也就是說,系統不會針對這些要求收費。
- 一個 SKU:Place Details (Preferred) 要求:
- 每 1,000 個要求收費 $25.00 美元,最多 100,000 個要求
- 每 1000 項要求收費 $20.00 美元,最多 500,000 項要求
結帳和運送資訊的自動完成功能
Address Validation API 是接受位址的服務。可識別地址元件並驗證。此外,它還會將郵寄的地址標準化,並找出最佳的已知經緯度座標。
在結帳和運送情況下使用自動完成功能時,您可以向 Address Validation API 提出要求,藉此驗證所選地址,並終止工作階段。則計費方式如下:
- 所有 Autocomplete (新版) 要求均以 SKU:Autocomplete 工作階段用量計費,因此這類要求不會產生任何費用。
- 一個 SKU:Address Validation Preferred 要求:
- 每 1,000 個要求收費 $25.00 美元,最多 100,000 個要求
- 每 1000 項要求收費 $20.00 美元,最多 500,000 項要求
計費示例
下表列出三個主要工作階段情境的計費範例。這個表格也會列出每個情況下帳單明細中顯示的 SKU。
情境 | 要求範例 | 已計費的 SKU | 每 1,000 次要求的價格 |
---|---|---|---|
位置資料 |
|
|
|
地點探索 |
|
|
|
結帳和外送 |
|
|
不含工作階段的計費示例
如果您未使用工作階段,系統會以 SKU:自動完成要求 的費用,針對每項自動完成 (新版) 要求收取 $2.83 美元,每 1, 000 項要求收費 $2.83 美元。
針對未完成或放棄的工作階段提供備用價格
如果工作階段遭到捨棄,也就是不會因為呼叫 Place Details (新版) 或地址驗證而終止,Autocomplete (新版) 要求會還原為按要求計價模式,並依照 SKU:Autocomplete 要求的定義,以每 1,000 個要求 2.83 美元計費。