自動完成和工作階段定價

Google 建議您搭配 Place Autocomplete 使用工作階段。工作階段有助於簡化定價流程,並為 Place Autocomplete 提供一致的定價模式。

工作階段定價會從第一個包含工作階段符記的 Place Autocomplete 要求開始,接著接續每一個後續的 Place Autocomplete 要求,然後由使用工作階段符記的 Place Details 要求終止。

工作階段終止後,如果呼叫 Place Autocomplete、使用過期工作階段符記的 Place Details (新版) 呼叫,系統會視為沒有任何工作階段符記來計費。

未完成的工作階段 (亦即未由 Place Details 要求終止的工作階段),只會針對使用 SKU:Autocomplete Request 的自動完成要求計費。

三種最常見的計費情境如下:

  • 位置資料的自動完成功能
  • 搜尋地點的自動完成功能
  • 結帳和貨品交付的自動完成功能

位置資料的自動完成功能

在此情況下,您想使用 Autocomplete 和 Place Details (新版) 取得地點的位置資訊。舉例來說,您可以從自動完成功能中選取建議,然後使用 Place Details 取得地點的經緯度座標,在地圖上顯示該地點。

位置資訊可能包含地點的下列資訊:

  • 地址
  • 經緯度座標的地點
  • Plus Code
  • 類型
  • 可視區域

向 Place Details 發出的單一要求會終止,這個工作階段會要求 SKU:Place Details (Location Only) 定義的任何欄位。

則計費方式如下:

  • 每個 Place Autocomplete 要求使用 SKU:Autocomplete 要求,最多 12 個要求。
    • 每 1,000 個要求以 $2.83 美元計費,最多 100,000 個要求
    • 每 1,000 個要求最多 500,000 個要求,費用為每 1,000 個要求 $2.27 美元
  • 如果您處於執行中的工作階段,Place Autocomplete 要求 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 基本進階偏好的 SKU 中包含的任何欄位,就會終止工作階段。

則計費方式如下:

  • 所有 Place Autocomplete 要求都是按照 SKU:Autocomplete Session Usage 計費,因此這些要求不會產生任何費用。
  • 一個 SKU:Place Details (Preferred) 要求:
    • 每 1,000 個要求最多 100,000 個要求,費用為每 1,000 個要求 $25.00 美元
    • 每 1,000 個要求最多 500,000 個要求,費用為每 1,000 個要求 $20.00 美元

計費範例

下表列出三個主要工作階段情境的計費示例。下表也針對每項情境列出了您的對帳單中顯示的 SKU。

情境 要求範例 計費的 SKU 每 1,000 次要求的價格
位置資料
  • 向 Place Autocomplete 發出的 5 項要求,費用為 $2.83 美元 (工作階段上限為 12 個要求)
  • 1 項 Place Details 要求,費用為 $5 美元
探索地點
  • 向 Place Autocomplete 發出的 5 個要求,費用為 $0 美元
  • 1 項 Place Details 要求,費用為 $25 美元
結帳和外送
  • 5 個向 Place Autocomplete 發出的要求
  • 1 項地址驗證要求
  • 向 Place Autocomplete 發出的 5 項要求,費用為 $0 美元
  • 1 項地址驗證要求 (建議使用 $25 美元)

不含工作階段的計費範例

如未使用工作階段,則系統會按每個要求向 Place Autocomplete 要求收取費用,其使用 SKU:Autocomplete Request,每 1, 000 個要求 $2.83 美元。

將未完成或放棄的工作階段設為備用定價

如果工作階段遭到捨棄,也就是不透過對 Place Details (新版) 的呼叫而終止,Place Autocomplete 要求會還原為按個別要求的定價模式,並按 SKU:Autocomplete Request 的定義,以每 1,000 個要求 2.83 美元計費。