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