自動完成和工作階段定價

Google 建議您使用 Place Autocomplete 工作階段。工作階段可簡化定價,並提供與 Place Autocomplete 搭配使用的一致定價模式。

工作階段價格從包含工作階段符記的第一個 Place Autocomplete 要求開始,並持續到後續的每個 Place Autocomplete 要求,然後由使用工作階段符記的地點詳細資料要求終止。

工作階段結束後,如果使用已過期的工作階段符記呼叫 Place Autocomplete 和 Place Details (新版),系統會視為沒有提供工作階段符記來計費。

對於未完成的工作階段 (也就是未因對 Place Details 的要求而終止的工作階段),系統只會針對使用 SKU:Autocomplete Requests 的自動完成要求收費。

最常見的三種定價情境如下:

  • 位置資料的自動完成功能
  • 自動完成地點探索
  • 結帳和運送資訊的自動完成功能

位置資料的自動完成功能

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

位置資訊可能包含以下資訊:

  • 地址
  • 位置資訊以經緯度座標表示
  • Plus Code
  • 類型
  • 可視區域

這個工作階段會在向 Place Details 提出單一要求後結束,該要求會要求 SKU:Place Details (僅限位置) 定義的任何欄位。

則計費方式如下:

  • 每個 Place Autocomplete 要求 (最多 12 個要求),使用 SKU:Autocomplete Requests
    • 每 1000 項要求收費 $2.83 美元,最多 100,000 項要求
    • 每 1,000 項要求收費 $2.27 美元,最多 500,000 項要求
  • 在您處於有效工作階段時,系統會以 SKU:自動完成工作階段用量計費,也就是說,系統不會針對這些要求收費。
  • 使用 SKU:Place Details (Location Only) 的一個 Place Details 要求:
    • 每 1,000 項要求收費 $5.00 美元,最多 100,000 項要求
    • 每 1000 項要求收費 $4.00 美元,最多 500,000 項要求

自動完成地點探索

在地點探索情境的 Autocomplete 中,您除了取得地點的定位資料之外,還想取得其他資訊。舉例來說,您可以要求下列任何項目:

  • 無障礙選項
  • 目前營業時間
  • 停車選項
  • 評論
  • 評分

在這種情況下,您的工作階段會因 Place Details (New) 要求而終止,該要求會要求 Place Details BasicAdvancedPreferred SKU 中包含的「任何欄位」

則計費方式如下:

  • 所有 Place Autocomplete 要求都會以 SKU:Autocomplete Session Usage 計費,也就是說,系統不會針對這些要求收費。
  • 一個 SKU:Place Details (Preferred) 要求:
    • 每 1,000 個要求收費 $25.00 美元,最多 100,000 個要求
    • 每 1000 項要求收費 $20.00 美元,最多 500,000 項要求

計費示例

下表列出三種主要工作階段的定價範例。下表也列出每個情況下帳單明細中顯示的 SKU。

情境 要求範例 已計費的 SKU 價格
位置資料
  • 5 個 Place Autocomplete 要求,每個收費 $0.00283 美元 (每個工作階段最多 12 個要求)
  • 1 次 Place Details 要求,費用為 $0.005 美元
地點探索
  • 5 個 Place Autocomplete 要求,每個收費 $0 美元
  • 1 次 Place Details 要求,計費 $0.025 美元
結帳和送達
  • 5 個 Place Autocomplete 要求
  • 1 個地址驗證要求
  • 5 個 Place Autocomplete 要求,計費 $0
  • 1 次 Address Validation Preferred 要求,費用為 $0.025 美元

不含工作階段的計費示例

如果您不使用工作階段,系統會使用 SKU:自動完成要求,針對每項 Place Autocomplete 要求收取 $2.83 美元,每 1, 000 項要求收費 $2.83 美元。

針對未完成或放棄的工作階段提供備用價格

如果工作階段遭到放棄,也就是未因呼叫 Place Details (新版) 而終止,Place Autocomplete 要求就會恢復為按要求計費的模式,並依 SKU:Autocomplete 要求定義的價格,以每 1000 個要求 2.83 美元計費。