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