Google 建議您使用含有自動完成 (新版) 的工作階段。工作階段可簡化定價,並提供一致的定價模式,以便與 Autocomplete 搭配使用 (新功能)。
工作階段價格從包含工作階段符記的第一個 Autocomplete (新版) 要求開始,並持續到後續的每個 Autocomplete (新版) 要求,然後由使用工作階段符記的地點詳細資料 (新版) 或地址驗證要求終止。
工作階段結束後,如果使用過期的工作階段符記呼叫 Autocomplete (新版)、Place Details (新版) 或 Address Validation,系統會視為沒有提供工作階段符記而收費。
對於未完成的工作階段 (也就是未因要求提供 Place Details (新版) 或地址驗證而終止的工作階段),系統只會針對使用 SKU:Autocomplete Requests 的 Autocomplete 要求收費。
最常見的三種定價情境如下:
- 位置資料的自動完成功能
- 自動完成地點探索
- 結帳和運送資訊的自動完成功能
位置資料的自動完成功能
在這個情境中,您想使用 Autocomplete 和 Place Details (新版) 取得地點的相關資訊。舉例來說,您可以從自動完成功能選取建議,然後使用 Place Details (新版) 取得地點的經緯度座標,在地圖上顯示該地點。
位置資訊可能包含以下資訊:
- 地址
- 位置資訊以經緯度座標表示
- Plus Code
- 類型
- 可視區域
這個工作階段會在向 Place Details (新版) 提出單一要求後結束,該要求會要求 SKU:Place Details Essentials 定義的任何欄位。
工作階段從第一個包含工作階段符記的 Autocomplete (New) 要求開始,並在後續的 Autocomplete (New) 要求中持續進行,然後由使用工作階段符記的 Place Details (New) 或 Address Validation 要求終止。針對 Autocomplete (新版) 工作階段,系統會以以下方式向您收費:
- 前 12 個 Autocomplete (新版) 要求:系統會使用 SKU:Autocomplete Requests 為每個 Autocomplete (新版) 要求 (最多 12 個) 收費。
- 同一個工作階段中的 Autocomplete (New) 要求 13 以上:系統會以 SKU:Autocomplete 工作階段用量計費,也就是說,這些要求不會產生費用。
- Places Details 或 Address Validation 要求:您也必須為使用這些 SKU 的結束要求付費。
自動完成地點探索
在地點探索情境的 Autocomplete 中,您除了取得地點的定位資料之外,還想取得其他資訊。舉例來說,您可以要求下列任何項目:
- 無障礙選項
- 目前營業時間
- 停車選項
- 評論
- 評分
在這種情況下,您的工作階段會因向 Place Details (新版) 提出要求而終止,該要求會要求 Place Details (新版) Pro、Enterprise 或 Enterprise + Atmosphere SKU 中包含的任何欄位。
則計費方式如下:
- 所有 Autocomplete (新版) 要求都會以 SKU:自動完成工作階段使用量計費,也就是說,系統不會針對這些要求收費。
結帳和運送資訊的自動完成功能
Address Validation API 是接受地址的服務。可識別地址元件並驗證。它也會將郵寄地址標準化,並找出最可靠的經緯度座標。
在結帳和運送情境的 Autocomplete 中,您會透過對 Address Validation API 提出要求來終止工作階段,以驗證所選地址。則計費方式如下:
- 所有 Autocomplete (新版) 要求都會以 SKU:自動完成工作階段使用量計費,也就是說,系統不會針對這些要求收費。
- 一個 SKU:Address Validation Enterprise 要求:
計費示例
下表列出三種主要工作階段情境的定價範例。下表也列出每個情況下帳單明細中顯示的 SKU。
情境 | 要求範例 | 已計費的 SKU | 已收費的要求 |
---|---|---|---|
位置資料 |
|
|
|
地點探索 |
|
|
|
結帳和送達 |
|
|
不含工作階段的計費示例
如果您未使用工作階段,系統會以 SKU:Autocomplete Requests 計費,每個 Autocomplete (New) 要求收費。
針對未完成或放棄的工作階段提供備用價格
如果工作階段遭到放棄,也就是未因呼叫 Place Details (新版) 或 Address Validation 而終止,Autocomplete (新版) 要求就會恢復採用按要求計費的模式,並依 SKU:Autocomplete Requests 計費。