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