Autocomplete (新推出) 和工作階段定價

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) BasicAdvancedPreferred 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 提出要求來驗證所選地址,以終止工作階段。則後續的費用如下:

計費範例

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

情境 要求範例 計費的 SKU 每 1,000 個要求的價格
位置資料
  • 向 Autocomplete (新版) 發出的 5 項要求,費用為 $2.83 美元 (上限為 12 個工作階段要求)
  • 1 項 Place Details (新版) 要求,費用為 $5 美元
探索地點
  • 向 Autocomplete (新品) 發出的 5 項要求,費用為 $0
  • 1 項 Place Details (新版) 要求,費用為 $25 美元
結帳和外送
  • 「自動完成」功能的 5 項要求 (新推出)
  • 1 項用於地址驗證的要求
  • 向 Autocomplete (新品) 發出的 5 項要求,費用為 $0
  • 1 項地址驗證要求,偏好以 $25 美元計費

不含工作階段的計費範例

如果您不使用工作階段,則會依照每 1, 000 個要求 $2.83 美元的價格,使用 SKU:Autocomplete 要求的個別要求,向 Autocomplete (新版) 計費。

不完整或放棄工作階段的備用定價

如果工作階段遭到捨棄 (亦即未因呼叫 Place Details (新版) 或 Address Validation 而終止),Autocomplete (New) 要求會還原為按要求計費模式,並按照 SKU:Autocomplete 要求定義的要求,以每 1,000 次要求 $2.83 美元計費。