Autocomplete(新版)でセッションを使用することをおすすめします。セッションを使用すると、料金設定が簡素化され、Autocomplete(新版)の使用に対して一貫した料金モデルが提供されます。
セッションは、セッション トークンを含む最初の Autocomplete(新版)リクエストから始まり、 後続の各 Autocomplete(新版)リクエストまで継続され、セッション トークンを使用する Place Details(新版)または Address Validation へのリクエストによって終了します。
セッションが終了すると、期限切れのセッション トークンを使用する Autocomplete(新版)、Place Details(新版)、Address Validation の呼び出しは、セッション トークンがない場合と同様に課金されます。
不完全なセッション、つまり Place Details(新版) または Address Validation へのリクエストによって終了しないセッションは、 SKU: Autocomplete Requests を使用した Autocomplete(新版)リクエストに対してのみ課金されます。
セッションの課金
Place Details(新版)Essentials リクエストで終了するセッション
SKU: Places API Place Details Essentials のフィールドを使用するリクエストで終了する Autocomplete(新版)セッションの場合:
- 最初の 12 件の Autocomplete(新版)リクエスト: SKU: Autocomplete Requests を使用して、Autocomplete(新版)リクエストごとに課金されます(最大 12 件)。
- 同じセッション内の 13 件目以降の Autocomplete(新版)リクエスト: SKU: Autocomplete Session Usageで課金されます。つまり、これらのリクエストに対して料金は発生しません。
- Place Details(新版)Essentials: 終了リクエストに対しても、SKU: Places API Place Details Essentials で課金されます。
Address Validation または Place Details(新版)(Essentials 以外)のリクエストで終了するセッション
Address Validation リクエストまたは Place Details Pro、Enterprise、Enterprise + Atmosphere のフィールドを使用する Place Details(新版)リクエストで終了する Autocomplete(新版)セッションの場合:
- Autocomplete(新版)リクエスト: Autocomplete(新版)リクエストはすべて SKU: Autocomplete Session Usageに基づいて課金されます。 つまり、このリクエストに対して料金は発生しません。
-
Place Details(新版)または Address Validation リクエスト: 終了リクエストに対しても、適切な SKU で課金されます。
- Place Details(新版) の終了リクエストは、リクエストされたフィールドに関係なく、SKU: Place Details Enterprise + Atmosphere で課金されます。
- Address Validation の終了リクエストは、SKU: Address Validation Enterprise で課金されます。
セッションの料金シナリオ
最も一般的なセッションの料金シナリオは次の 3 つです。
- Place Autocomplete を使って位置情報を取得する
- Place Autocomplete を使って場所のその他の情報を取得する
- Place Autocomplete を使って購入手続きと配送の情報を取得する
以降のセクションでは、各シナリオの個別の課金について説明します。
Place Autocomplete を使って位置情報を取得する
このシナリオでは、Autocomplete(新版)と Place Details(新版)を使用して、特定の場所の位置情報を取得します。たとえば、Autocomplete(新版)から候補を選択し、Place Details(新版)を使用して場所の緯度と 経度の座標を取得し、その場所を地図上に表示します。
位置情報には、次のようなものがあります。
- 住所
- 緯度と経度の座標で表した位置情報
- Plus Code
- タイプ
- ビューポート
このセッションは、SKU: Place Details Essentials で定義されたフィールドをリクエストする、Place Details(新版)に対する 1 件のリクエストで終了します。
次のように課金されます。
- 最初の 12 件の Autocomplete(新版)リクエスト は、SKU: Autocomplete Requests で課金されます。
- 残りの Autocomplete(新版)リクエスト は、 SKU: Autocomplete Session Usage で課金されます。 つまり、これらのリクエストに対して料金は発生しません。
- 終了する Place Details(新版)リクエスト は、 SKU: Places API Place Details Essentials で課金されます。
Place Autocomplete を使って場所のその他の情報を取得する
このシナリオでは、場所に関する 位置情報以外のデータも取得できます。たとえば、次のようなリクエストを行うことができます。
- ユーザー補助機能の設定
- 現在の営業時間
- 駐車場の種類
- クチコミ
- 評価
次のように課金されます。
- すべての Autocomplete(新版)リクエスト は、 SKU: Autocomplete Session Usage で課金されます。 つまり、これらのリクエストに対して料金は発生しません。
- 終了する Place Details(新版)リクエスト は、SKU: Places API Place Details Enterprise + Atmosphere で課金されます。
Place Autocomplete を使って購入手続きと配送の情報を取得する
Address Validation API は、住所を受け付ける サービスです。住所の構成要素を識別して検証します。また、郵送用のアドレスを標準化し、そのアドレスに最適な既知の緯度と経度の座標を見つけます。
このシナリオでは、選択した住所を検証するために Address Validation API にリクエストを送信してセッションを終了します。
次のように課金されます。
- すべての Autocomplete(新版)リクエスト は、 SKU: Autocomplete Session Usage で課金されます。 つまり、これらのリクエストに対して料金は発生しません。
- 省略可能な Place Details Essentials リクエスト は、終了する Address Validation リクエストの前にリクエストされた場合、無料で課金されます。
- 終了する Address Validation リクエスト は、 SKU: Address Validation Enterprise で課金されます。
セッションを使用しない場合の料金
セッションを使用しない場合は、 SKU: Autocomplete Requests を使用して、Autocomplete(新版)に対するリクエストごとに課金されます。
未完了のセッションや放棄されたセッションの料金
セッションが放棄された場合、つまり Place Details(新版)または Address Validation への呼び出しによって終了されなかった場合、Autocomplete(新版)リクエストはリクエスト単位の料金モデルに戻り、 SKU: Autocomplete Requests に基づいて課金されます。