オートコンプリート(新機能)とセッションの料金

プラットフォームを選択: Android iOS JavaScript ウェブサービス

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(新版)リクエスト: SKU: Autocomplete Requests を使用して、Autocomplete(新版)リクエストごとに最大 12 件のリクエストまで課金されます。
  • 同じセッションで 13 件以上の Autocomplete(新版)リクエストを行った場合: SKU: Autocomplete Session Usage で課金されます。つまり、これらのリクエストに対して料金は発生しません。
  • Place Details(新版)Essentials: 終了リクエストに対しても、SKU: Places API Place Details Essentials で課金されます。

Address Validation または Place Details(新版)(Essentials 以外)リクエストで終了するセッション

Place Details ProEnterprise、または Enterprise + Atmosphere のフィールドを使用して Address Validation リクエストまたは Place Details(新規)リクエストで終了する Autocomplete(新規)セッションの場合:

  • Autocomplete(新版)リクエスト: Autocomplete(新版)リクエストはすべて SKU: Autocomplete Session Usage に基づいて課金されます。つまり、このリクエストに対して料金は発生しません。
  • Place Details(新版)または Address Validation リクエスト: 終了リクエストも、適切な SKU で課金されます。

セッションの料金シナリオ

最も一般的なセッション料金シナリオは次の 3 つです。

以降のセクションでは、各シナリオの個々の課金について説明します。

Place Autocomplete を使って位置情報を取得する

このシナリオでは、Place Autocomplete(新版)と Place Details(新版)を使用して、特定の場所の位置情報を取得します。たとえば、Autocomplete(新版)から候補を選択し、Place Details(新版)を使用して場所の緯度と経度の座標を取得し、その場所を地図上に表示します。

位置情報には、次のような情報が含まれます。

  • 住所
  • 緯度と経度の座標で表した位置情報
  • Plus Code
  • タイプ
  • ビューポート

このセッションは、SKU: Place Details Essentials で定義されたフィールドをリクエストする、Place Details(新版)に対する 1 件のリクエストで終了します。

次のように課金されます。

位置情報データの Autocomplete シナリオの課金図

Place Autocomplete を使って場所のその他の情報を取得する

このシナリオでは、場所に関する位置情報以外のデータも取得できます。たとえば、次のいずれかをリクエストできます。

  • ユーザー補助機能の設定
  • 現在の営業時間
  • 駐車場の種類
  • クチコミ
  • 評価

このシナリオでは、Place Details(新版)の ProEnterpriseEnterprise + Atmosphere の各 SKU に含まれる任意のフィールドをリクエストする Place Details(新版)への単一のリクエストによって、セッションが終了します。

次のように課金されます。

Place Autocomplete を使って場所のその他の情報を取得するシナリオの課金図

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 に基づいて課金されます。