Places API の使用量と請求額

フィールド マスクについて

Place Details(新版)、Nearby Search(新版)、テキスト検索(新版)では、API リクエストの FieldMask ヘッダーを使用して、レスポンスで返すフィールドのリストを指定します。リクエストに適用される最も高い SKU で課金されます。つまり、Essentials SKU と Pro SKU の両方のフィールドを選択すると、Pro SKU に基づいて課金されます。

フィールド マスキングを使用することは、不要なデータをリクエストしないようにするための優れた設計手法です。これにより、不要な処理時間と請求を回避できます。

予測入力(新版)セッションについて

Autocomplete(新版)セッションには、1 つ以上の Autocomplete(新版)リクエストと、Place Details(新版)リクエストまたは Address Validation リクエストが含まれます。Autocomplete(新版)リクエストと、後続の Place Details(新版)リクエストまたは Address Validation リクエストには、同じセッション トークンが渡されます。

セッションは、最初の Autocomplete(新規)リクエストで開始されます。予測入力(新版)のいずれかの候補をユーザーが選択すると、Place Details(新版)リクエストまたは Address Validation リクエストが実行されます。セッションが放棄された場合、つまり Place Details(新版)リクエストまたは Address Validation リクエストが行われなかった場合、Autocomplete(新版)リクエストはセッション トークンが提供されなかった場合と同様に課金されます。

ユーザーが場所を選択したら(つまり、Place Details(新規)リクエストまたは Address Validation リクエストが行われたら)、新しいセッション トークンを使用して新しいセッションを開始する必要があります。

セッション トークンは 1 回のセッションでのみ有効です。同じセッション トークンを複数のセッションで使用することはできません。セッション トークンを再使用すると、そのセッションは無効とみなされ、セッション トークンを渡さなかった場合と同様にリクエストが課金されます。

Places API の SKU の詳細と料金

次の表に、Places API の従量課金制 SKU の詳細と料金を示します。

カテゴリPlaces API(新版)の SKU の詳細SKU 料金
Essentials SKU: Autocomplete Requests グローバル料金表
インドの料金表
Essentials SKU: Autocomplete Session Usage グローバル料金表
インドの料金表
Essentials SKU: Place Details Essentials(ID のみ) グローバル料金表
インドの料金表
Essentials SKU: Place Details Essentials グローバル料金表
インドの料金表
Essentials SKU: Text Search Essentials (IDs Only) グローバル料金表
インドの料金表
Pro SKU: Nearby Search Pro グローバル料金表
インドの料金表
Pro SKU: Place Details Pro グローバル料金表
インドの料金表
Pro SKU: Text Search Pro グローバル料金表
インドの料金表
Enterprise SKU: Nearby Search Enterprise グローバル料金表
インドの料金表
Enterprise SKU: Nearby Search Enterprise + Atmosphere グローバル料金表
インドの料金表
Enterprise SKU: Place Details Enterprise グローバル料金表
インドの料金表
Enterprise SKU: Place Details Enterprise + Atmosphere グローバル料金表
インドの料金表
Enterprise SKU: Text Search Enterprise グローバル料金表
インドの料金表
Enterprise SKU: Text Search Enterprise + Atmosphere グローバル料金表
インドの料金表
Enterprise SKU: Place Details Photos グローバル料金表
インドの料金表
カテゴリPlaces API(従来版)の SKU の詳細SKU 料金
Essentials SKU: Autocomplete - Per Request グローバル料金表
インドの料金表
Essentials SKU: Autocomplete (included with Place Details) - Per Session グローバル料金表
インドの料金表
Essentials

SKU: Basic Data

追加料金:

グローバル料金表
インドの料金表
Essentials SKU: Find Place - ID only グローバル料金表
インドの料金表
Essentials SKU: Place Details Essentials - ID Refresh グローバル料金表
インドの料金表
Essentials SKU: Query Autocomplete - Per Request グローバル料金表
インドの料金表
Pro SKU: Autocomplete without Place Details - Per Session グローバル料金表
インドの料金表
Pro

SKU: Find Place

追加料金:

グローバル料金表
インドの料金表
Pro

SKU: Places - Nearby Search

追加料金:

グローバル料金表
インドの料金表
Pro

SKU: Places - Text Search

追加料金:

グローバル料金表
インドの料金表
Pro

SKU: Places Details

追加料金:

グローバル料金表
インドの料金表
Enterprise

SKU: Atmosphere Data

追加料金:

グローバル料金表
インドの料金表
Enterprise

SKU: Contact Data

追加料金:

グローバル料金表
インドの料金表
Enterprise SKU: Place Photos グローバル料金表
インドの料金表

使用量上限

割り当てと使用量上限を確認して管理するには、割り当てと割り当てアラートをご覧ください。

  • Places API(新規): 1 分あたりのレート制限は、プロジェクトごとの API メソッドごとに適用されます。つまり、API メソッドごとに個別の割り当てがあります。

  • Places API(従来版): 1 分あたりのレート制限は、同じプロジェクトの認証情報を使用するすべてのアプリケーションのクライアントサイド リクエストとサーバーサイド リクエストの合計として計算されます。

Places API の費用対効果の高い戦略

このセクションでは、Places API の使用量を最適化し、関連する費用を削減する方法について説明します。

フィールド マスクを使用する

フィールド マスキングを使用すると、不要なデータをリクエストしないようにできるため、レイテンシと請求額を削減できます。

Place Details(新版)、Nearby Search(新版)、テキスト検索(新版)のリクエストでは、フィールド マスクを使用して、レスポンスで返すフィールドのリストを指定します。

その後、リクエストに適用される最も高い SKU で請求されます。たとえば、Essentials SKU と Pro SKU の両方からフィールドを選択すると、Pro SKU に基づいて課金されます。

Place Details(新版)でセッション料金を使用する

アプリケーションの月間呼び出し数が 100,001 ~ 500,000 以上の場合、またはユーザーがセッションごとに 12 件を超える予測入力リクエストを行う場合は、Autocomplete(新版)でセッションを使用することをおすすめします。セッションを使用すると、料金設定が簡素化され、Autocomplete(新版)の使用に対して一貫した料金モデルが提供されます。

詳細については、予測入力(新版)とセッションの料金をご覧ください。

割り当てを調整

割り当て上限は、特定の API またはサービスに対して、特定の期間内に許可されるリクエストの最大数を定義します。プロジェクトのリクエスト数が割り当て上限に達すると、サービスはリクエストへの応答を停止します。

API の割り当て値を変更する手順は次のとおりです。

  1. Cloud コンソールで、[Google Maps Platform] > [割り当て] に移動します。
  2. 割り当てを変更する API を選択します。
  3. 変更する割り当て値を特定し、チェックボックスを使用して選択します。
  4. [編集] をクリックし、新しい割り当て値を入力して、[リクエストを送信] をクリックします。

割り当て増加リクエストを表示する

過去のリクエストと保留中のリクエストを含む、すべての割り当て増加リクエストを表示する手順は次のとおりです。

  1. Cloud コンソールで、[Google Maps Platform] > [割り当て] に移動します。
  2. 割り当て増加リクエストを表示する API を選択します。
  3. [リクエストの増加] をクリックします。

利用規約による制限

利用規約の詳細については、Places API のポリシーと、Google Maps Platform 利用規約のライセンス制限に関するセクションをご覧ください。