> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/workflows/ja/burokku/blocks/visualize-predictions/polygon-zone-visualization.md).

# ポリゴンゾーン可視化

不規則でカスタム定義された領域内のオブジェクトを追跡する、ゾーンベースの検出およびカウントのワークフロー向けに、画像上にポリゴンゾーンを描画して監視領域を可視化し、色付きのポリゴンオーバーレイを表示します。

## このブロックの仕組み

このブロックは、画像とポリゴンゾーン座標（ポリゴン形状を定義する点のリスト）を受け取り、監視ゾーンを可視化するために塗りつぶしのポリゴンオーバーレイを描画します。このブロックは、

1. 画像とポリゴンゾーン座標（点のリスト: \[(x1, y1), (x2, y2), (x3, y3), ...]）を入力として受け取ります
2. 指定された色を使用して、ゾーン座標から塗りつぶしのポリゴンマスクを作成します
3. 指定された不透明度で塗りつぶしのポリゴンを画像に重ね、半透明のゾーン可視化を作成します
4. 元の画像上にポリゴンゾーンのオーバーレイを付けた注釈付き画像を返します

このブロックは、検出、カウント、または追跡のワークフローで不規則な監視領域を定義するために使用されるポリゴンゾーンを可視化します。ポリゴンは指定された点の間を塗りつぶされた形状として描画され、長方形のバウンディングボックスとは異なり、任意のカスタム領域形状を表現できる閉じた領域を作成します。これにより、特定の床面積、不規則な関心領域、複雑な監視ゾーンなど、実世界の境界に合う柔軟なゾーン定義が可能になります。ゾーンのオーバーレイは半透明で、下の画像の詳細を見せたまま監視領域を明確に示します。注意: このブロックは通常、ワークフロー内の他の可視化ブロックより前に配置すべきです。ポリゴンゾーンは物体検出の可視化のための背景参照レイヤーを提供するためです。

## 一般的な使用例

* **ゾーン検出の可視化**: 不規則でカスタム定義された領域内でオブジェクトを追跡する物体検出またはカウントのワークフロー向けに、監視境界を明確に表示しながらポリゴンゾーンを可視化します
* **エリアベースの監視**: 占有状況の追跡、特定領域での人数カウント、定義された空間内での物体存在検出などのエリアベース監視アプリケーション向けにポリゴンゾーンを表示します
* **カスタム領域の可視化**: 長方形の境界に収まらない監視領域、たとえば不規則な床面積、複雑な部屋レイアウト、または大きな空間内の特定ゾーンなどを可視化します
* **セキュリティと監視**: 特定エリアを視覚的にマーキングして監視する必要があるセキュリティ監視、アクセス制御、または監視ワークフロー向けにポリゴンゾーンを表示します
* **小売・ビジネス分析**: 小売、ホスピタリティ、またはビジネスインテリジェンス用途における、人流分析、顧客移動の追跡、またはスペース利用状況の監視向けにポリゴンゾーンを可視化します
* **リアルタイムゾーン監視**: リアルタイム監視ダッシュボード、ライブ映像フィード、または監視インターフェース向けに、監視領域を示すポリゴンゾーンを明確に表示する可視オーバーレイを作成します

## 他のブロックへの接続

このブロックの注釈付き画像は次に接続できます:

* **ゾーン検出またはカウントのブロック** 可視化するポリゴンゾーン座標を受け取るために
* **他の可視化ブロック** (例: Bounding Box Visualization、Label Visualization、Polygon Visualization) を使用して、ポリゴンゾーンの可視化の上に物体検出の注釈を追加します
* **データ保存ブロック** (例: Local File Sink、CSV Formatter、Roboflow Dataset Upload) を使用して、ドキュメント化、レポート作成、または分析用にポリゴンゾーンの可視化付き画像を保存します
* **Webhookブロック** ポリゴンゾーンを含む可視化結果を外部システム、API、またはWebアプリケーションに送信し、ダッシュボードや監視ツールに表示します
* **通知ブロック** (例: Email Notification、Slack Notification) を使用して、アラートやレポートの視覚的証拠としてポリゴンゾーン付きの注釈画像を送信します
* **動画出力ブロック** ライブ監視、ゾーンの可視化、または後処理分析用に、ポリゴンゾーンの可視化を含む注釈付き動画ストリームまたは録画を作成します

### 型識別子

ステップで次の識別子を使用してください `"type"` フィールド： `roboflow_core/polygon_zone_visualization@v1` ワークフローにこのブロックをステップとして追加するには。

### プロパティ

| **名前**       | **型**       | **説明**                                                                                                                                                                                                         | 参照 |
| ------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `name`       | `str`       | このステップの一意の識別子を入力してください。                                                                                                                                                                                        | ❌  |
| `copy_image` | `bool`      | このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元の画像を保持します。複数の可視化を重ねる場合に使用してください。                                                                                                                                             | ✅  |
| `zone`       | `List[Any]` | ポリゴンゾーン座標は \[\[(x1, y1), (x2, y2), (x3, y3), ...], ...] の形式で、1つ以上のポリゴン形状を定義します。各ゾーンは有効なポリゴンを形成するために2点を超える点で構成されている必要があります。ポリゴンはこれらの点を順番に結んだ塗りつぶしの形状として描画され、閉じた領域を作成します。通常は、監視領域を定義するゾーン検出またはカウントのブロックから接続されます。 | ✅  |
| `color`      | `str`       | ポリゴンゾーンのオーバーレイの色。色名（例: 'WHITE'、'RED'）、16進カラーコード（例: '#5bb573'、'#FFFFFF'）、またはRGB形式（例: 'rgb(255, 255, 255)'）で指定できます。ポリゴンはこの色で塗りつぶされ、指定された不透明度で重ねられます。                                                             | ✅  |
| `opacity`    | `float`     | ポリゴンゾーンのオーバーレイの不透明度。0.0（完全に透明）から1.0（完全に不透明）までの範囲です。画像上でポリゴンゾーンがどの程度透明に見えるかを制御します。低い値ほど背景とよくなじむ透明なゾーンになり、高い値ほどより不透明で見えやすいゾーンになります。通常は、ゾーンと下地の画像の両方が見えるバランスのよい可視性のために0.2〜0.5の範囲がよく使われます。                         | ✅  |

この **参照** 列は、で利用可能な動的値を使ってプロパティをパラメータ化できる可能性を示します `ワークフロー` 実行時。参照 *バインディング* 詳細は。

### 入力と出力のバインディング

利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が `ポリゴンゾーンの可視化` のバージョン `v1` あるか確認してください。

<details>

<summary>入力と出力のバインディング</summary>

* 入力
  * `image` ([*`image`*](/workflows/ja/gaido/developer-guide/kinds/image.md)): 可視化対象の画像。
  * `copy_image` ([*`boolean`*](/workflows/ja/gaido/developer-guide/kinds/boolean.md)): このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元の画像を保持します。複数の可視化を重ねる場合に使用してください。
  * `zone` ([*`list_of_values`*](/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)): ポリゴンゾーン座標は \[\[(x1, y1), (x2, y2), (x3, y3), ...], ...] の形式で、1つ以上のポリゴン形状を定義します。各ゾーンは有効なポリゴンを形成するために2点を超える点で構成されている必要があります。ポリゴンはこれらの点を順番に結んだ塗りつぶしの形状として描画され、閉じた領域を作成します。通常は、監視領域を定義するゾーン検出またはカウントのブロックから接続されます。
  * `color` ([*`文字列`*](/workflows/ja/gaido/developer-guide/kinds/string.md)): ポリゴンゾーンのオーバーレイの色。色名（例: 'WHITE'、'RED'）、16進カラーコード（例: '#5bb573'、'#FFFFFF'）、またはRGB形式（例: 'rgb(255, 255, 255)'）で指定できます。ポリゴンはこの色で塗りつぶされ、指定された不透明度で重ねられます。
  * `opacity` ([*`float_zero_to_one`*](/workflows/ja/gaido/developer-guide/kinds/float-zero-to-one.md)): ポリゴンゾーンのオーバーレイの不透明度。0.0（完全に透明）から1.0（完全に不透明）までの範囲です。画像上でポリゴンゾーンがどの程度透明に見えるかを制御します。低い値ほど背景とよくなじむ透明なゾーンになり、高い値ほどより不透明で見えやすいゾーンになります。通常は、ゾーンと下地の画像の両方が見えるバランスのよい可視性のために0.2〜0.5の範囲がよく使われます。
* 出力
  * `image` ([`image`](/workflows/ja/gaido/developer-guide/kinds/image.md)): ワークフロー内の画像。

</details>

<details>

<summary>JSON 定義の例</summary>

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/polygon_zone_visualization@v1",
	    "image": "$inputs.image",
	    "copy_image": true,
	    "zone": "$inputs.zones",
	    "color": "WHITE",
	    "opacity": 0.3
	}
```

</details>