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