# 🧾 Coord Click — 使用ガイド

Coord Click は、**Cadmus** パッケージに含まれるツールで、マップ上をクリックすることで、その地点の詳細情報（座標、投影情報、住所、標高）を取得できます。

---

## 🎯 目的

マップ上の任意の地点を迅速に確認するために、以下の情報を提供します：

* WGS84 座標（10進法および度分秒）
* UTM 座標（SIRGAS 2000）
* ゾーンおよび EPSG 情報
* 推定標高（OpenTopoData）
* 逆ジオコーディングによる住所（OpenStreetMap）

---

## 🛠️ 使用方法

### 1️⃣ ツールを有効化

メニュー → Cadmus → Coord Click

### 2️⃣ マップをクリック

キャンバス上の任意の地点をクリックします。

### 3️⃣ 結果を確認

ダイアログが表示（または更新）され、以下の情報が表示されます：

* **WGS84**

  * 緯度/経度（10進法）
  * 緯度/経度（度分秒）

* **UTM**

  * Easting (X)
  * Northing (Y)
  * ゾーン、半球、EPSG

* **標高**

  * 自動取得される推定値

* **住所**

  * 市区町村
  * 中間地域
  * 州/都道府県
  * 地域
  * 国

---

## ⚙️ 内部動作

本ツールは非同期パイプラインを使用します：

* 並列処理：

  * 逆ジオコーディング
  * 標高取得
* エンジン：`AsyncPipelineEngine`
* ステップ：

  * `ReverseGeocodeStep`
  * `AltimetryStep`

パイプラインが失敗した場合：

* `QgsTask` によるフォールバック処理が実行されます

---

## 🔎 依存関係

* OpenStreetMap（逆ジオコーディング）
* OpenTopoData（標高）

インターネット接続が必要です。

---

## 🧾 利用可能な操作

* **WGS情報をコピー**
* **UTM情報をコピー**
* **位置情報をまとめてコピー（専用ボタン）**
* 新しい地点をクリックすると自動更新

---

## 🧠 注意点

* ダイアログが既に開いている場合 → 再利用されます
* 以前のタスクは自動的にキャンセルされます
* スナッピングが有効な場合はそれが優先されます
* 非同期データ（住所・標高）の取得には数秒かかる場合があります

---

## ⚠️ 制限事項

* 標高は推定値です（外部モデル使用）
* 住所は OSM のデータに依存します
* オフライン時 → 座標のみ表示されます

---

##  作成者

Matheus A.S. Martinelli
