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

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

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

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

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

不完全なセッション、つまり Place Details へのリクエストによって終了しないセッションは、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 件のリクエストで終了します。

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

  • Place Autocomplete リクエスト単位、最大 12 件のリクエスト、SKU: Autocomplete Requests を使用:
    • リクエスト 1,000 件あたり 2.83 ドル(最大 100,000 件)
    • リクエスト 1,000 件あたり 2.27 ドル(最大 500,000 件)
  • セッションがアクティブな間に Place 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 に含まれる任意のフィールドをリクエストすることでセッションが終了します。

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

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

料金設定の例

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

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

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

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

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

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