Name: YAMAKAGE - WatchApp
Author: YAMAKAGE

YAMAKAGE - Terrain-Aware Sunset & Sunrise Prediction

■Overview & Key Features
Darkness falls faster in mountains than standard sunset times suggest. YAMAKAGE is a smartwatch app that calculates and visualizes "true" sunrise, sunset, moonrise, and moonset times by analyzing surrounding terrain. 
By scanning elevation data up to 30 km away, it compares celestial trajectories with mountain heights to predict exactly when the sun or moon will be hidden or revealed, offering an intuitive graphical understanding of your environment.
Displayed Data & Views

After pressing "START" to run the calculation, you can swipe to explore three distinct screens:
・Panorama View: Overlays obstacles (like mountains) and their elevation angles in your watch's current heading alongside the sun/moon trajectory.
・SkyPlot: A 360-degree overhead circular graph displaying surrounding elevation profiles and celestial paths.
・Radar View: A top-down radar showing real-time distances (in km) to obstacles and open directions.
・Details: Displays terrain-adjusted times and obstacle elevation angles based on your heading.

■Mechanism & Privacy
To minimize battery consumption and processing load, YAMAKAGE delegates complex calculations to a cloud server:
・The app sends your current GPS coordinates to the server.
・The server analyzes global terrain data within a 30 km radius.
・It calculates trajectories against the terrain cross-section and returns rendering data to your device.
・Privacy Note: Location data is transmitted solely for calculations using a random temporary hash. No personal data is collected, and locations are instantly discarded after processing.

■Precautions, Disclaimer & Links
・Requirements: Requires a connected smartphone (Garmin Connect Mobile app) and a clear outdoor GPS signal.
・Limitations: Polar regions (e.g., midnight sun) will display as --:--. Ensure good connectivity to avoid communication errors.
・Disclaimer: Times are predictions based on ~38m mesh terrain data. Because weather, trees, and buildings are not accounted for, actual times may vary. Always plan activities with a generous time margin.

■Explore More:
・Data Field Version: Garmin Store
https://apps.garmin.com/apps/cbe81d8e-661d-49b0-bc4c-a1fc8ab10d53

・Source Code: YAMAKAGE is an open-source project. Anyone can view its internals on GitHub.
https://github.com/tomopumipumi/yamakage

・Browser Demo: Try it Here
https://yamakage-site.pages.dev/

YAMAKAGE - WatchApp

YAMAKAGE - 地形を考慮した日没・日の出予測

■概要
山間部の暗闇は、一般的な日没時間よりも早く訪れます。

YAMAKAGEは、周囲の地形（標高データ）を読み込み、実際の山や影を考慮した「本当の日の出・日の入り時刻」を算出・可視化するウォッチアプリです。
また、それだけではなく月が現れる時間や稜線に隠れる時間の可視化にも対応しました。

■主な特徴
現在地から周囲最大30kmの地形データをスキャンし、太陽の軌道と山の高さを照らし合わせることで、実際にいつ太陽(月)が隠れるか（現れるか）を予測します。

データフィールド版から表現力が大幅に進化し、直感的なグラフィックで周囲の状況を把握できるようになりました。

■表示されるデータ・機能
アプリを起動し「START」ボタンを押して計算を実行すると、以下の3つの画面（スワイプ等で切り替え）で結果を確認できます。

・パノラマビュー: スマートウォッチが向いている方向の障害物(山など)の仰角と、太陽(月)の軌道や現在位置を重ね合わせて表示します。
・天空図: 360度全方位の仰角地形と、空を横切る太陽(月)の動きを円形グラフで俯瞰できます。
・レーダー図: 上空から見下ろしたレーダーのような視点で、周囲の障害物の有無や開けている方向を直感的に可視化します。時計が向いている方向の障害物までの距離（km）もリアルタイムで表示されます。
・詳細データ: 地形を考慮した正確な「日(月)の出時刻」「日(月)の入り時刻」、および現在向いている方角の障害物の仰角を確認できます。

■仕組み
デバイスのバッテリー消費と処理負荷を最小限に抑えるため、YAMAKAGEは複雑な地形計算を専用のクラウドサーバーで行っています。

1. アプリから現在地のGPS座標を専用サーバーへ送信します。
2. サーバーが、公開されている世界中の地形データを読み込み、現在地を中心とした30km圏内の標高を瞬時に解析します。
3. その地形の断面図と太陽の軌道計算を掛け合わせ、デバイスへ結果を送り返してグラフを描画します。

※プライバシーに関する注釈
本アプリは日没計算のために位置情報を外部サーバーへ送信しますが、アカウント情報やデバイス識別子など、個人を特定できる情報は一切取得・送信していません。通信には匿名性を保つため、完全にランダムに生成された一時的なハッシュ値のみを使用しています。
送信された位置情報についてもサーバー側に保存（永続化）されることはなく、計算完了後に即座に破棄されます（動作ログとして一時的に残るのみで、計算以外の目的には一切使用されません）。安心してお使いください。

■ご利用上の注意（必ずお読みください）

・スマートフォンとの通信が必須です: 地形データを外部から取得するため、計算実行時はスマートフォン（Garmin Connect Mobileアプリ）と接続されている必要があります。
・GPSの取得: 計算には現在地のGPSデータを使用します。GPS信号を捕捉しやすい屋外で実行してください。
・通信の失敗: 外部サーバーとの通信に失敗した場合やスマートフォンと繋がっていない場合は、エラー画面が表示されます。通信環境の良い場所で再度実行してください。
・例外時の表示: 夏の北欧など、白夜・極夜の地域で「日の出・日没」の概念が存在しない日は、時刻が --:-- と表示され、日の出・日の入りアイコンは表示されません。

■ご免責事項・誤差について
本アプリが算出する時刻やグラフは、地形データ（約38mメッシュ）と太陽軌道から計算された予測値です。
大気の状態、周囲の樹木や建物の高さ、天候（雲）などは考慮されないため、実際の体感とは数分〜十数分程度の誤差が生じる場合があります。
「予測時刻までは絶対に明るい」と過信せず、常に余裕を持ったスケジュールでの行動を心がけてください。

■データフィールド版
https://apps.garmin.com/ja-JP/apps/cbe81d8e-661d-49b0-bc4c-a1fc8ab10d53

■ソースコード
https://github.com/tomopumipumi/yamakage

■ブラウザでも試せます！
https://yamakage-site.pages.dev/