セッションでは Place Autocomplete を使うことをおすすめします。セッションによって料金設定が簡素化され、Place Autocomplete で使用する一貫した料金モデルが提供されます。
セッションの料金は、セッション トークンを含む最初の Place Autocomplete リクエストから始まり、後続の各 Place Autocomplete リクエストまで継続され、セッション トークンを使用する Place Details へのリクエストによって終了します。
セッションが終了すると、期限切れのセッション トークンを使用する Place Autocomplete、Place Details(New)の呼び出しは、セッション トークンがない場合と同様に課金されます。
不完全なセッション、つまり Place Details へのリクエストによって終了しないセッションは、SKU: Autocomplete リクエストを使用した予測入力リクエストに対してのみ課金されます。
最も一般的な料金シナリオは次の 3 つです。
- 位置情報の予測入力
- Place Discovery の予測入力
- 購入手続きと配送の予測入力
位置情報の予測入力
このシナリオでは、Autocomplete と Place Details(新版)を使用して、ある場所の位置情報を取得します。たとえば、予測入力から候補を選択し、Place Details を使用して場所の緯度と経度の座標を取得し、その場所を地図上に表示します。
位置情報には、次のような場所が含まれます。
- 住所
- 緯度と経度の座標で表した位置情報
- Plus Code
- タイプ
- ビューポート
このセッションは、Place Details に対する 1 回のリクエストで SKU: Place Details (Location Only) で定義されたフィールドをリクエストすることで終了します。
次のように課金されます。
- Place Autocomplete リクエスト 1 件につき、最大 12 件のリクエスト。SKU: Autocomplete リクエストを使用します。
- リクエスト 1,000 件あたり $2.83(最大 100,000 リクエストまで)
- リクエスト 1,000 件あたり $2.27(最大 500,000 リクエストまで)
- ユーザーがアクティブなセッション中に Place Autocomplete 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 の Basic / Advanced / Preferred SKU に含まれる任意のフィールドをリクエストすることでセッションが終了します。
次のように課金されます。
- Place Autocomplete リクエストはすべて SKU: Autocomplete Session Usage で課金されます。つまり、これらのリクエストに対して料金は発生しません。
- SKU: Place Details (Preferred) リクエスト 1 件:
- リクエスト 1,000 件あたり $25.00(最大 100,000 リクエストまで)
- リクエスト 1,000 件あたり $20.00(最大 500,000 リクエストまで)
料金の例
次の表に、3 つの主なセッション シナリオの料金例を示します。この表には、各シナリオの請求明細に表示される SKU もリストされています。
シナリオ | リクエストの例 | 請求対象の SKU | リクエスト 1,000 件あたりの料金 |
---|---|---|---|
位置情報 |
|
|
|
Place Discovery |
|
|
|
購入手続きと配送 |
|
|
|
セッションがない場合の料金の例
セッションを使用しない場合は、SKU: Autocomplete リクエストを使用して Place Autocomplete へのリクエストごとに、リクエスト 1, 000 件あたり $2.83 が課金されます。
未完了のセッションや放棄されたセッションの代替料金
セッションが放棄された場合、つまり Place Details(新版)への呼び出しによって終了されなかった場合、Place Autocomplete リクエストはリクエストごとの料金モデルに戻り、SKU: Autocomplete リクエストの定義に沿って、リクエスト 1,000 件あたり 2.83 米ドルが課金されます。