フィールド マスクについて
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(新規): 1 分あたりのレート上限は、プロジェクトごとの API メソッドごとに設定されます。つまり、API メソッドごとに個別の割り当てがあります。
Places API(以前のバージョン): 1 分あたりのレート上限は、同じプロジェクトの認証情報を使用するすべてのアプリケーションのクライアント側リクエストとサーバー側リクエストの合計として計算されます。
割り当てを調整する
割り当て上限は、特定の API またはサービスに対して一定期間内に許可されるリクエストの最大数を定義します。プロジェクトのリクエスト数が割り当て上限に達すると、サービスはリクエストへの応答を停止します。
API の割り当て値を変更する手順は次のとおりです。
- Cloud コンソールで、[Google Maps Platform > 割り当て] に移動します。
- 割り当てを変更する API を選択します。
- 変更する割り当て値を特定し、チェックボックスを使用して選択します。
- [編集] をクリックし、新しい割り当て値を入力して、[リクエストを送信] をクリックします。
割り当て増加リクエストを表示する
過去のリクエストと保留中のリクエストを含む、すべての割り当て増加リクエストを表示するには:
- Cloud コンソールで、[Google Maps Platform > 割り当て] に移動します。
- 割り当て増加リクエストを表示する API を選択します。
- [リクエストの増加] をクリックします。
利用規約による制限
利用規約については、Places API のポリシーと、Google Maps Platform 利用規約のライセンス制限に関するセクションをご覧ください。