Place Autocomplete とセッション料金設定

プラットフォームを選択: Android iOS JavaScript ウェブサービス
欧州経済領域（EEA）のデベロッパー

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 Pro、Enterprise、または 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（新版）の Pro、Enterprise、Enterprise + 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 に基づいて課金されます。