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