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(新版)リクエスト: Autocomplete(新版)リクエストごとに、最大 12 件のリクエストまで、SKU: Autocomplete Requests を使用して課金されます。
- 同じセッションで 13 件以上の Autocomplete(新版)リクエストを行った場合: SKU: Autocomplete Session Usage で課金されます。つまり、これらのリクエストに対して料金は発生しません。
- Place Details(新版)Essentials: 終了リクエストに対しても、SKU: Places API Place Details Essentials で課金されます。
Address Validation または Place Details(新版)(Essentials 以外)リクエストで終了するセッション
Place Details Pro、Enterprise、または Enterprise + Atmosphere のフィールドを使用して Address Validation リクエストまたは 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 を使って位置情報を取得する
このシナリオでは、Place 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 を使って場所のその他の情報を取得する
このシナリオでは、場所に関する位置情報以外のデータも取得できます。たとえば、次のいずれかをリクエストできます。
- ユーザー補助機能の設定
- 現在の営業時間
- 駐車場の種類
- クチコミ
- 評価
このシナリオでは、Place Details(新版)の Pro、Enterprise、Enterprise + Atmosphere の各 SKU に含まれる任意のフィールドをリクエストする Place Details(新版)への単一のリクエストによって、セッションが終了します。
次のように課金されます。
- すべての 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 に基づいて課金されます。つまり、これらのリクエストに対して料金は発生しません。
- 終了する Address Validation リクエストの前にリクエストされた場合、オプションの Place Details Essentials リクエストは無料で課金されます。
- 終了する Address Validation リクエストは、SKU: Address Validation Enterprise で課金されます。
セッションを使用しない場合の料金設定
セッションを使用しない場合は、SKU: Autocomplete Requests を使用して Autocomplete(新版)へのリクエスト単位で課金されます。
未完了のセッションや放棄されたセッションの料金
セッションが放棄された場合、つまり Place Details(新版)または Address Validation への呼び出しによって終了されなかった場合、Autocomplete(新版)リクエストはリクエスト単位の料金モデルに戻り、SKU: Autocomplete Requests に基づいて課金されます。