フィールド マスクについて
Place Details(新版)、Nearby Search(新版)、テキスト検索(新版)では、API リクエストで FieldMask ヘッダーを使用して、レスポンスで返されるフィールドのリストを指定します。リクエストに適用される最も高い SKU の料金が請求されます。つまり、Essentials SKU と Pro SKU の両方でフィールドを選択した場合、Pro SKU に基づいて課金されます。
フィールド マスキングを使用すると、不要なデータをリクエストしないようにできるため、不要な処理時間や課金を回避できます。
Autocomplete(新版)セッションについて
Autocomplete(新版)セッションには、1 つ以上の Autocomplete(新版)リクエストと、Place Details(新版)リクエストまたは Address Validation リクエストが含まれます。Autocomplete(新版)リクエストと、後続の Place Details(新版)リクエストまたは Address Validation リクエストには、同じセッション トークンが渡されます。
セッションは、最初の Autocomplete(新版)リクエストで開始されます。Autocomplete(新版)のいずれかの候補をユーザーが選択すると、Place Details(新版)リクエストまたは Address Validation リクエストが送信されます。セッションが放棄された場合、つまり Place Details(新版)リクエストまたは Address Validation リクエストが送信されなかった場合、Autocomplete(新版)リクエストは、セッション トークンが指定されていない場合と同様に課金されます。
ユーザーが場所を選択したら(つまり、Place Details(新版)リクエストまたは Address Validation リクエストが送信されたら)、新しいセッション トークンを使用して新しいセッションを開始する必要があります。
セッション トークンは 1 回のセッションでのみ有効です。同じセッション トークンを複数のセッションで使用することはできません。セッション トークンを再使用すると、そのセッションは無効とみなされ、セッション トークンを渡さなかった場合と同様にリクエストが課金されます。
Places API の SKU の詳細と料金
次の表に、Places API の SKU の詳細と料金を示します。
使用量上限
割り当てと使用量上限を確認して管理するには、割り当てと割り当て アラートをご覧ください。
Places API(新版): 1 分あたりのレート上限は、 プロジェクトごとの API メソッドごとに設定されます。つまり、API メソッドごとに個別の割り当てがあります。
Places API(旧版): 1 分あたりのレート上限は、同じプロジェクトの認証情報を使用するすべてのアプリケーションのクライアントサイド リクエストとサーバーサイド リクエストの合計として計算されます。
割り当てを調整する
割り当て上限は、特定の期間内に特定の API またはサービスに対して許可されるリクエストの最大数を定義します。プロジェクト内のリクエスト数が割り当て上限に達すると、サービスはリクエストへの応答を停止します。
API の割り当て値を変更する手順は次のとおりです。
- Cloud コンソールで、[Google Maps Platform] > [割り当て] に移動します。
- 割り当てを変更する API を選択します。
- 変更する割り当て値を特定し、チェックボックスを使用して選択します。
- [編集] をクリックし、新しい割り当て値を入力して [リクエストを送信] をクリックします。
割り当て増加リクエストを表示する
過去のリクエストと保留中のリクエストを含む、すべての割り当て増加リクエストを表示するには:
- Cloud コンソールで、[Google Maps Platform] > [割り当て] に移動します。
- 割り当て増加リクエストを表示する API を選択します。
- [リクエストの増加] をクリックします。
利用規約による制限
利用規約については、 Places API のポリシーと Google Maps Platform の利用規約のライセンス制限に関するセクション をご覧ください。