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