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

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

Autocomplete(新版)でセッションを使用することをおすすめします。セッションを使用すると、料金設定が簡素化され、Autocomplete(新規)の使用に対して一貫した料金モデルが提供されます。

セッションの料金設定は、セッション トークンを含む最初の Autocomplete(新規)リクエストから始まり、後続の各 Autocomplete(新規)リクエストまで継続され、セッション トークンを使用する Place Details(新規)または Address Validation へのリクエストによって終了します。

セッションが終了すると、期限切れのセッション トークンを使用する Autocomplete(新規)、Place Details(新規)、Address Validation の呼び出しは、セッション トークンがない場合と同様に課金されます。

不完全なセッション、つまり Place Details(新版)または Address Validation へのリクエストによって終了しないセッションは、SKU: Autocomplete Requests を使用した予測入力リクエストに対してのみ課金されます。

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

  • Place Autocomplete を使って位置情報を取得する
  • Place Autocomplete を使って場所のその他の情報を取得する
  • Place Autocomplete を使って購入手続きと配送の情報を取得する

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

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

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

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

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

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

  • Autocomplete(新規)リクエスト単位、最大 12 件のリクエスト、SKU: Autocomplete Requests を使用:
    • リクエスト 1,000 件あたり 2.83 ドル(最大 100,000 件)
    • リクエスト 1,000 件あたり 2.27 ドル(最大 500,000 件)
  • セッションがアクティブな間に Autocomplete(新版)が 13 件以上のリクエストを行った場合は、SKU: Autocomplete Session Usage で課金されます。つまり、これらのリクエストに対して料金は発生しません。
  • Places Details リクエスト 1 件、SKU: Place Details (Location Only) を使用:
    • リクエスト 1,000 件あたり 5.00 ドル(最大 100,000 件)
    • リクエスト 1,000 件あたり 4.00 ドル(最大 500,000 件)

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

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

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

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

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

  • Autocomplete(新規)リクエストはすべて SKU: Autocomplete Session Usage に基づいて課金されます。つまり、このリクエストに対して料金は発生しません。
  • SKU: Place Details (Preferred) リクエスト 1 件:
    • リクエスト 1,000 件あたり 25.00 ドル(最大 100,000 件)
    • リクエスト 1,000 件あたり 20.00 ドル(最大 500,000 件)

Place Autocomplete を使って購入手続きと配送の情報を取得する

Address Validation API は、住所を受け入れるサービスです。住所のコンポーネントを特定して検証します。また、郵送用の住所を標準化し、その住所に最適な既知の緯度と経度の座標を検索します。

購入手続きと配達の Autocomplete シナリオでは、Address Validation API へのリクエストでセッションを終了し、選択した住所を検証します。次のように課金されます。

  • Autocomplete(新規)リクエストはすべて SKU: Autocomplete Session Usage に基づいて課金されます。つまり、このリクエストに対して料金は発生しません。
  • SKU: Address Validation Preferred リクエスト 1 件:
    • リクエスト 1,000 件あたり 25.00 ドル(最大 100,000 件)
    • リクエスト 1,000 件あたり 20.00 ドル(最大 500,000 件)

料金の例

次の表に、3 つの主なセッション シナリオの料金設定の例を示します。この表には、各シナリオの請求明細に表示される SKU もリストされています。

シナリオ リクエストの例 請求対象の SKU リクエスト 1,000 件あたりの料金
位置情報
  • Autocomplete(新版)への 5 件のリクエストに対して 2.83 ドル課金(セッションあたりのリクエスト数の上限は 12 件)
  • Place Details (New) への 1 件のリクエストに対して 5 ドル課金
場所のその他の情報
  • Autocomplete(新機能)への 5 件のリクエストに対して課金なし
  • Place Details (New) への 1 件のリクエストに対して 25 ドル課金
購入手続きと配送の情報
  • Autocomplete(新機能)への 5 件のリクエスト
  • Address Validation への 1 件のリクエスト
  • Autocomplete(新版)への 5 件のリクエストに対して課金なし
  • Address Validation への 1 件のリクエストに対して 25 ドル課金

セッションを使用しない場合の料金設定の例

セッションを使用しない場合は、SKU: Autocomplete Requests を使用して Autocomplete(新版)へのリクエスト単位で、リクエスト 1, 000 件あたり 2.83 ドルが課金されます。

未完了のセッションや放棄されたセッションの代替料金

セッションが放棄された場合、つまり Place Details(新版)または Address Validation への呼び出しによって終了されなかった場合、Autocomplete(新版)リクエストはリクエスト単位の料金モデルに戻り、SKU: Autocomplete Requests の定義に沿って、リクエスト 1,000 件あたり 2.83 ドルが課金されます。