# Use Cases

## Use Cases

Use Case は、共通の目的とカスタムメタデータ構造を共有する Vision Events をグループ化します。各イベントは必ず 1 つの Use Case にのみ属します。同じ Use Case 内のイベントは通常、同じメタデータフィールドを共有するため、異なるソース間でデータを簡単に絞り込み、比較できます。

### 1 つの Use Case と複数の Use Case を使い分けるタイミング

**イベントを同じ Use Case に入れる** 場所、カメラ、またはデバイスが異なっていても、類似したカスタムメタデータフィールドを共有している場合。たとえば、「Defect Detection」Use Case では複数の工場からイベントを受け取ることがありますが、すべてのイベントには `line_id`, `shift`、および `part_number`.

**別々の Use Case を作成する** メタデータ構造が根本的に異なる場合。たとえば:

* **Assembly Line QA** — を追跡 `line_id`, `shift`, `part_number`
* **Warehouse Inventory** — を追跡 `通路`, `棚`, `item_type`
* **Construction Site Safety** — を追跡 `zone`, `alert_type`, `contractor`

### Use Case を作成する

#### Dashboard で

1. に移動 **Vision Events** をワークスペースの左サイドバーで
2. クリック **+ Create Use Case**
3. Use Case の名前を入力する

<figure><img src="https://3740591140-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2FHeINTZfy9moBciMlrQpZ%2Fimage.png?alt=media&#x26;token=75581e01-5e61-46b4-958d-654ffb7014ac" alt="" width="375"><figcaption></figcaption></figure>

### Use Cases を表示する

#### Dashboard で

Vision Events ページには、すべての Use Cases の表が表示され、以下が確認できます:

* Use Case 名
* 合計イベント数
* 最後のイベントのタイムスタンプ
* 使用中のイベントタイプ

#### API 経由

ワークスペース内のすべての Use Cases を取得する:

```bash
curl -X GET "https://api.roboflow.com/vision-events/use-cases" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

完全なレスポンス形式については、 [Vision Events API Reference](https://docs.roboflow.com/developer/rest-api/vision-events) を参照してください。

### Use Case をアーカイブする

Use Cases は、不要になったときに Dashboard からアーカイブできます。アーカイブされた Use Cases とそのイベントには引き続きアクセスできますが、デフォルト表示では非表示になります。クリック **アーカイブ済みの use cases を表示** して、Use Cases 表の下部で確認してください。\ <br>

<figure><img src="https://3740591140-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2F71mElYpzCyYcZ3Fupy3A%2FDashboard%20view%20for%20solution%20nine%20status.png?alt=media&#x26;token=46dd10e0-d93b-45c3-8c71-5cf4884e10d2" alt=""><figcaption></figcaption></figure>

### Custom Metadata Schema

イベントが Use Case に送信されると、システムは観測されたフィールドと値の型に基づいてメタデータスキーマを推定します。Use Case の推定スキーマを取得して、どのキーと値の型が使用されているかを確認できます:

```bash
curl -X GET "https://api.roboflow.com/vision-events/custom-metadata-schema/assembly-line-qa" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**レスポンス例:**

```json
{
  "useCaseId": "assembly-line-qa",
  "fields": {
    "line_id": { "types": ["string"] },
    "shift": { "types": ["string"] },
    "temperature": { "types": ["number"] },
    "is_priority": { "types": ["boolean"] }
  }
}
```

完全なレスポンス形式については、 [Vision Events API Reference](https://docs.roboflow.com/developer/rest-api/vision-events) の完全な詳細については、