Places API の使用量と請求額

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

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

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

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

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

セッションは、最初の Autocomplete(New)リクエストで開始されます。ユーザーが 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 (IDs Only) メインの料金リスト
インドの料金リスト
Essentials SKU: Place Details Essentials メインの料金リスト
インドの料金リスト
Essentials SKU: Text Search Essentials(ID のみ) メインの料金リスト
インドの料金リスト
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 Plus メインの料金リスト
インドの料金リスト
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: Place Details Pro メインの料金リスト
インドの料金リスト
Enterprise SKU: Atmosphere Data メインの料金リスト
インドの料金リスト
Enterprise SKU: Contact Data メインの料金リスト
インドの料金リスト
Enterprise SKU: Place Photos メインの料金リスト
インドの料金リスト

使用量上限

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

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

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

割り当てを調整する

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

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

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

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

過去のリクエストと保留中のリクエストを含む、すべての割り当て増加リクエストを表示するには:

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

利用規約による制限

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