> 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/transformations/geo-tag-detection.md).

# ジオタグ検出

ピクセル座標から実世界の GPS 位置へ検出を投影します。

カメラ位置メタデータを使用して、物体検出のバウンディングボックスを実世界のGPS座標に変換します。

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

このブロックは物体検出予測とカメラのGPSメタデータ（緯度、経度、高度）を受け取り、各検出のピクセル位置を実世界の地上座標に投影します。投影ではカメラの画角と高度を使って地上フットプリントを計算し、画像中心からのピクセルオフセットをカメラ位置からの地理的オフセットに変換します。

1. **検出予測を受け取ります** 上流の物体検出ブロックから（バウンディングボックスを出力する任意のモデル）
2. **カメラのGPSメタデータを取得します** 入力として：緯度、経度、地上高、および任意で水平画角
3. **地上フットプリントを計算します** 高度とFOVから基本的な三角法を用いて
4. **各検出中心を投影します** ピクセル座標からカメラ位置からの緯度/経度オフセットへ
5. **GeoJSON対応のレコードを出力します** 各検出のクラス、信頼度、地理座標付き

この投影は、カメラが真下を向く（ナディア）向きであることを前提としています。これは、ほとんどのドローン調査飛行では正確です。斜めの角度では、画像中心から離れるほど精度が低下します。

## 一般的な使用例

* **ドローン調査解析**: 検出された対象（車両、人、動物、構造物）を実世界の位置にマッピングするためにドローン映像を処理し、調査、点検、監視用途に活用します
* **農業モニタリング**: 空撮画像から作物の損傷、機材、家畜の位置をマッピングし、精密農業のワークフローに活用します
* **セキュリティと監視**: 空撮カメラ映像から地理空間的な状況把握を行い、検出された活動を実世界の座標にマッピングして状況認識に役立てます
* **野生生物保全**: ドローン調査から動物の検出結果を追跡・マッピングし、個体群、移動パターン、または生息地の利用状況を監視します
* **建設現場モニタリング**: 空撮画像から機材、資材、要員の位置をマッピングし、現場管理と安全コンプライアンスに活用します
* **捜索救助**: ドローン映像から広範囲にわたる検出済みの人物や物体を迅速にマッピングし、対応活動の調整に役立てます

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

このブロックは検出結果を受け取り、地理空間データを生成します：

* **物体検出ブロックの後に** （YOLO、RF-DETR など）の予測に実世界座標を付与してジオタグ化します
* **追跡ブロックの後に** （ByteTrack、OC-SORT）で、移動経路付きのジオタグ付きトラックを生成します
* **データシンクブロックの前に** （CSV、JSON、Webhook）で検出位置をエクスポートし、GIS解析に利用します
* **可視化ブロックの前** GPS座標ラベルでフレームに注釈を付けるために
* **ビデオ処理パイプラインで** 各フレームのGPSがドローンのテレメトリまたはEXIFメタデータから取得される場合

### タイプ識別子

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

### プロパティ

| **名前** | **型**   | **説明**                                                                                                                                                      | 参照 |
| ------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `name` | `str`   | このステップの一意の識別子を入力してください。                                                                                                                                     | ❌  |
| `緯度`   | `float` | カメラ位置のGPS緯度（10進度）。ドローン画像では、これは飛行コントローラのGPSから取得されます。正の値は北、負の値は南です。                                                                                           | ✅  |
| `経度`   | `float` | カメラ位置のGPS経度（10進度）。ドローン画像では、これは飛行コントローラのGPSから取得されます。正の値は東、負の値は西です。                                                                                           | ✅  |
| `高度`   | `float` | 地上高メートル単位のカメラ高度。画角と組み合わせて地上フットプリントを計算するために使用します。ドローンでは、絶対高度ではなく飛行コントローラが報告する相対高度です。                                                                         | ✅  |
| `水平画角` | `float` | カメラの水平画角（度）。デフォルトの73.7は、ほとんどのDJIコンシューマードローン（Mini、Air、Mavicシリーズ）をカバーします。ほかのカメラでは調整してください。画角が広いほど、1フレームあたりの地上フットプリントは大きくなります。                                 | ✅  |
| `方位`   | `float` | 画像上部が向いているコンパス方位を、真北から時計回りの度数で示します。0は画像上が北を意味します（既定）。ジンバルがヨーを報告しない場合は、機首前方飛行では飛行経路（連続するGPS固定点間の方位）からこれを導出します。地上フットプリントを回転させ、検出結果が北固定ではなく正しい実世界の方位に載るようにします。 | ✅  |

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

### 入力および出力バインディング

利用可能な接続は、そのバインディング種別に依存します。 `GeoTag検出` バージョン `v1` に、どのバインディング種別があるか確認してください。

<details>

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

* input
  * `image` ([*`image`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/image.md)): 検出が生成された画像。座標投影のための画像サイズを決定するために使用されます。
  * `predictions` (*Union\[*[*`instance_segmentation_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/instance-segmentation-prediction.md)*,* [*`object_detection_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*]*): ジオタグ付けする物体検出予測。各検出のバウンディングボックス中心がGPS座標へ投影されます。
  * `緯度` ([*`float`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/float.md)): カメラ位置のGPS緯度（10進度）。ドローン画像では、これは飛行コントローラのGPSから取得されます。正の値は北、負の値は南です。
  * `経度` ([*`float`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/float.md)): カメラ位置のGPS経度（10進度）。ドローン画像では、これは飛行コントローラのGPSから取得されます。正の値は東、負の値は西です。
  * `高度` ([*`float`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/float.md)): 地上高メートル単位のカメラ高度。画角と組み合わせて地上フットプリントを計算するために使用します。ドローンでは、絶対高度ではなく飛行コントローラが報告する相対高度です。
  * `水平画角` ([*`float`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/float.md)): カメラの水平画角（度）。デフォルトの73.7は、ほとんどのDJIコンシューマードローン（Mini、Air、Mavicシリーズ）をカバーします。ほかのカメラでは調整してください。画角が広いほど、1フレームあたりの地上フットプリントは大きくなります。
  * `方位` ([*`float`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/float.md)): 画像上部が向いているコンパス方位を、真北から時計回りの度数で示します。0は画像上が北を意味します（既定）。ジンバルがヨーを報告しない場合は、機首前方飛行では飛行経路（連続するGPS固定点間の方位）からこれを導出します。地上フットプリントを回転させ、検出結果が北固定ではなく正しい実世界の方位に載るようにします。
* output
  * `geo_detections` ([`list_of_values`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)) : 任意の型の値のリスト。
  * `geojson` ([`dictionary`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/dictionary.md)) : 辞書。

</details>

<details>

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

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/geotag_detection@v1",
	    "image": "$inputs.image",
	    "predictions": "$steps.detection.predictions",
	    "latitude": 47.428681,
	    "longitude": -105.279125,
	    "altitude": 69.0,
	    "horizontal_fov": 73.7,
	    "heading": 0.0
	}
```

</details>
