Runcast

Go言語で作られたランニング特化の天気予報CLIツール「Runcast（ランキャスト）」です。

機能

• 🏃‍♂️ ランニングに特化した天気情報（体感温度、コンディション評価、服装提案）
• 指定した都市のランニング向け天気分析
• 📍 カスタム位置設定（自宅・会社など任意の位置を設定可能）
• 距離別推奨システム（5k, 10k, ハーフ, フル）
• 時間帯・日付指定によるランニング計画支援
• 🌫️ 大気質情報（黄砂・PM2.5・PM10の表示と注意喚起）
• 🌿 花粉情報（花粉飛散レベルの表示と注意喚起）
• Open-Meteo / ウェザーニューズ ポールンロボ のデータを使用

使用方法

インストール

go build -o runcast

基本的な使用方法

# 🏃‍♂️ 東京の現在のランニング情報を取得
./runcast -city tokyo

# ⏰ 東京の早朝時間帯のランニング情報を取得
./runcast -city tokyo -time morning

# 📅 明日の東京のランニング情報を取得
./runcast -city tokyo -date tomorrow

# 📅 明後日の札幌の早朝ランニング情報を取得
./runcast -city sapporo -date day-after-tomorrow -time morning

# 🏃‍♂️ 距離別推奨: フルマラソン用の天気評価
./runcast -city tokyo -distance full

# 🏃‍♂️ 距離別推奨: 10km用の明日の天気評価
./runcast -city osaka -distance 10k -date tomorrow

# ⏰ 大阪の夕方時間帯のハーフマラソン用情報
./runcast -city osaka -time evening -distance half

# 📍 カスタム位置を使用（要：.runcast.conf設定）
./runcast -city home -time morning

オプション

• -city: 都市名を指定（デフォルト: tokyo）
• -time: ⏰ 時間帯を指定（morning=早朝5-9時, noon=昼11-15時, evening=夕方17-19時, night=夜21-23時）
• -date: 📅 日付を指定（today=今日, tomorrow=明日, day-after-tomorrow=明後日）
• -distance: 🏃‍♂️ 目標距離を指定（5k, 10k, half, full）

対応都市

• fukuoka（福岡）
• hiroshima（広島）
• kobe（神戸）
• kyoto（京都）
• nagoya（名古屋）
• naha（那覇）
• osaka（大阪）
• sapporo（札幌）
• sendai（仙台）
• shiga（滋賀）
• tokyo（東京）
• yokohama（横浜）

カスタム位置設定

プライベートな位置（自宅、会社、よく行く公園など）を設定できます。

設定ファイル

.runcast.conf ファイルを作成して任意の位置を設定：

[locations]
home = { name = "自宅", lat = 35.6762, lon = 139.6503 }
office = { name = "会社", lat = 35.6584, lon = 139.7016 }
park = { name = "公園", lat = 35.6694, lon = 139.6049 }

設定ファイルの配置場所（優先順）

1. カレントディレクトリ: .runcast.conf
2. ホームディレクトリ: ~/.runcast.conf
3. 設定ディレクトリ: ~/.config/runcast/config.toml

使用例

# カスタム位置を使用
./runcast -city=home
./runcast -city=office -time=morning
./runcast -city=park -date=tomorrow -distance=10k

🏃‍♂️ ランニング特化機能

コンディション評価システム

• ランニング指数: 0-100ポイントで評価
• 5段階評価: 最高 / 良好 / 普通 / 注意 / 危険
• 総合判定: 気温・体感温度・湿度・風速・降水状況・大気質を総合考慮

表示情報

• 体感温度: 実際に感じる温度を表示
• 風向・風速: 16方位で風向を表示
• 降水情報: 雨量をmm/hで表示

アドバイス機能

• 服装推奨: 気温帯別の適切なウェアを推奨
• 安全警告: 熱中症、寒さ、雷雨などの注意報
• コンディション推奨: 実行すべきかどうかの判断

🌫️ 大気質情報（黄砂・PM2.5）

Open-Meteo Air Quality APIを利用して、黄砂・PM2.5・PM10の情報を取得・表示します。

黄砂レベル判定

レベル	dust値 (μg/m³)	表示	ペナルティ
0	0-50	なし	なし
1	51-100	少ない	-5点
2	101-200	やや多い	-15点
3	201-500	多い	-30点
4	500超	非常に多い	-50点

PM2.5レベル判定（日本の環境基準に基づく）

PM2.5 (μg/m³)	状態	ペナルティ	警告
35以下	環境基準内	なし	-
36-50	やや高め	-5点	敏感な方は注意
51-70	高い	-15点	長時間運動に注意
71以上	注意喚起レベル	-30点	激しい運動を避ける

距離別ペナルティ倍率

長距離ほど呼吸量が増えるため、大気質の影響が大きくなります。

• 5キロ: 1.0倍（標準）
• 10キロ: 1.2倍
• ハーフマラソン: 1.5倍
• フルマラソン: 2.0倍

装備推奨

• 黄砂レベル2以上 または PM2.5が50超: スポーツマスク
• 黄砂レベル3以上: サングラス（目の保護）

⏰ 時間帯別天気情報

対応時間帯

• 早朝 (morning): 5:00-9:00 - 朝ランに最適な時間帯
• 昼 (noon): 11:00-15:00 - 日中の活動時間帯
• 夕方 (evening): 17:00-19:00 - 夕方ランの人気時間帯
• 夜 (night): 21:00-23:00 - ナイトランニング時間帯

時間帯別ランニング分析

• 各時間の詳細コンディション評価
• 最適時間の自動推奨: その時間帯で最もランニングに適した時刻を表示
• 時間ごとの気温変化と体感温度
• 降水予測とランニング可否判断

📅 相対日付指定機能

対応日付

• 今日 (today): 当日の天気・ランニング情報
• 明日 (tomorrow): 翌日の予報情報
• 明後日 (day-after-tomorrow): 翌々日の予報情報

日付指定の特徴

• 前日からの計画立案: ランニング予定を事前に確認
• 時間帯との組み合わせ: 明日の早朝、明後日の夕方など具体的な計画
• 全て自動ランニング分析: 日付指定でも常にランニング評価・推奨を提供
• 詳細な予報データ: 当日と同じ粒度での情報表示

🏃‍♂️ 距離別推奨機能

対応距離カテゴリー

• 5キロ (5k): 3-7km - 短距離ランニング
• 10キロ (10k): 8-12km - 中距離ランニング
• ハーフマラソン (half): 19-23km - 長距離ランニング
• フルマラソン (full): 40-44km - 超長距離ランニング

距離別評価の特徴

• 段階的厳格化: 距離が長くなるほど厳しい条件で評価
• 距離別ペナルティ: 温度・湿度・風に対する追加減点
• 専用装備推奨: 長距離では水分補給・エネルギー補給用品を推奨
• 特別警告: フルマラソンでは高温・高湿度時の特別警告

距離別評価例

同じ天候条件下での評価差：

• 5キロ: 75/100 (良好) - 標準的な評価
• 10キロ: 68/100 (良好) - 軽度のペナルティ
• ハーフマラソン: 60/100 (良好) - 中程度のペナルティ + 補給装備推奨
• フルマラソン: 50/100 (普通) - 重いペナルティ + 特別警告

🌿 花粉情報

花粉情報はウェザーニューズ「ポールンロボ」オープンデータを使用しています。

対応都市

組み込み都市（12都市）のみ対応。カスタム位置（.runcast.conf）では花粉情報は表示されません。

花粉レベル判定

レベル	個/cm²	表示	スコアペナルティ
0	0	なし	なし
1	1-29	少ない	-5点
2	30-99	やや多い	-15点
3	100-199	多い	-30点
4	200以上	非常に多い	-50点

• 長距離ほど吸入量が増えるため、黄砂・PM2.5と同じ距離別倍率を適用
• レベル2以上でマスク着用推奨、レベル3以上でサングラスも推奨

データ出典

花粉情報：ウェザーニューズ ポールンロボ

注意事項

• ランニング評価は参考情報です。最終的な安全判断は自己責任でお願いします