> 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).
# GeoTag検出
カメラ位置メタデータを使用して、物体検出のバウンディングボックスを実世界の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シリーズ）をカバーします。他のカメラでは調整してください。FOVが広いほど、フレームごとの地上投影範囲は大きくなります。。 | ✅ |
| `進行方向` | `float` | 画像上端が向いている方角を、真北を0度として時計回りの度数で示すコンパス方位です。0は画像上が北（デフォルト）であることを意味します。ジンバルがヨーを報告しない場合は、機首前向き飛行では飛行コース（連続するGPS固定点間の方位）からこれを導出します。地上投影範囲を回転させ、検出結果が北に固定されるのではなく、正しい実世界の方位に配置されるようにします。。 | ✅ |
この **参照** 列は、で利用可能な動的値を使ってプロパティをパラメータ化できる可能性を示します `ワークフロー` 実行時。参照 *バインディング* 詳細は。
### 入力と出力のバインディング
利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が `GeoTag検出` のバージョン `v1` あるか確認してください。
入力と出力のバインディング
* 入力
* `image` ([*`image`*](/workflows/ja/gaido/developer-guide/kinds/image.md)): 検出が生成された画像です。座標投影のための画像サイズを決定するために使用します。。
* `predictions` (*Union\[*[*`object_detection_prediction`*](/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*,* [*`instance_segmentation_prediction`*](/workflows/ja/gaido/developer-guide/kinds/instance-segmentation-prediction.md)*]*): ジオタグ付けする物体検出予測です。各検出のバウンディングボックス中心がGPS座標に投影されます。。
* `緯度` ([*`float`*](/workflows/ja/gaido/developer-guide/kinds/float.md)): カメラ位置のGPS緯度を10進度で指定します。ドローン画像では、これは飛行制御装置のGPSに由来します。正の値は北、負の値は南です。。
* `経度` ([*`float`*](/workflows/ja/gaido/developer-guide/kinds/float.md)): カメラ位置のGPS経度を10進度で指定します。ドローン画像では、これは飛行制御装置のGPSに由来します。正の値は東、負の値は西です。。
* `高度` ([*`float`*](/workflows/ja/gaido/developer-guide/kinds/float.md)): 地上高に対するカメラの高度をメートルで指定します。視野角と組み合わせて地上投影範囲を算出するために使用します。ドローンの場合、これは絶対高度ではなく、飛行制御装置が報告する相対高度です。。
* `水平視野角` ([*`float`*](/workflows/ja/gaido/developer-guide/kinds/float.md)): カメラの水平視野角を度で指定します。デフォルトの73.7は、ほとんどのDJIコンシューマー向けドローン（Mini、Air、Mavicシリーズ）をカバーします。他のカメラでは調整してください。FOVが広いほど、フレームごとの地上投影範囲は大きくなります。。
* `進行方向` ([*`float`*](/workflows/ja/gaido/developer-guide/kinds/float.md)): 画像上端が向いている方角を、真北を0度として時計回りの度数で示すコンパス方位です。0は画像上が北（デフォルト）であることを意味します。ジンバルがヨーを報告しない場合は、機首前向き飛行では飛行コース（連続するGPS固定点間の方位）からこれを導出します。地上投影範囲を回転させ、検出結果が北に固定されるのではなく、正しい実世界の方位に配置されるようにします。。
* 出力
* `geo_detections` ([`list_of_values`](/workflows/ja/gaido/developer-guide/kinds/list-of-values.md))：任意の型の値のリスト。
* `geojson` ([`辞書`](/workflows/ja/gaido/developer-guide/kinds/dictionary.md)）：辞書。
JSON 定義の例
```json
{
"name": "",
"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
}
```