generate-report

カナダ週間天気レポート生成ツール

目的

Open-Meteo API のリアルタイムデータを使用して、カナダのプロフェッショナルな PDF 天気レポートを生成します（無料、API キー不要）。レポートには「オレンジと黒のモダンな年次報告書」テンプレートのスタイルを使用します。

入力

• 週の開始日（任意）：レポート対象期間の開始日（デフォルトは今週）
• 都市（任意）：含めるカナダの都市のリスト（デフォルトは主要都市）

デフォルトのカナダの都市

デフォルトでは、以下の主要都市を対象とします。

• 西海岸：バンクーバー、ビクトリア
• プレーリー地域：カルガリー、エドモントン、ウィニペグ
• 中部：トロント、オタワ、モントリオール
• 大西洋岸：ハリファックス、セントジョンズ
• 北部：ホワイトホース、イエローナイフ

スクリプト

すべてのスクリプトは ./scripts/ にあります。

• fetch_weather.py - Open-Meteo API から天気データを取得します（API キー不要）
• generate_report_pdf.py - スタイル付き PDF レポートを生成します

手順

1. 天気データを取得

python3 ./scripts/fetch_weather.py --output .tmp/canada_weather.json

任意のパラメーター：

• --cities "Vancouver,Toronto,Montreal" - 都市のカスタムリスト
• --days 7 - 予報日数（デフォルト：7、最大：16）

2. PDF レポートを生成

python3 ./scripts/generate_report_pdf.py \
  --input .tmp/canada_weather.json \
  --output .tmp/canada_weekly_weather_report.pdf \
  --template ".tmp/Orange and Black Modern Annual Report.pdf"

3. 確認して納品

• .tmp/canada_weekly_weather_report.pdf を開いて確認します
• リクエストに応じて、Google Drive にアップロードするか、メールで送信します

レポートの構成（テンプレートに準拠）

1. 表紙：「カナダ週間天気レポート」と日付範囲
2. 目次：地域別のセクション一覧
3. 全国の概要：カナダ全域の天候パターンの概要
4. 地域別のハイライト：主な指標（平均気温、降水量、最高・最低値）
5. 西海岸の天気：バンクーバー、ビクトリアの詳細
6. プレーリー地域の天気：カルガリー、エドモントン、ウィニペグの詳細
7. カナダ中部の天気：トロント、オタワ、モントリオールの詳細
8. 大西洋岸の天気：ハリファックス、セントジョンズの詳細
9. 北部準州：ホワイトホース、イエローナイフの詳細
10. 7 日間の見通し：傾向を含む予報の概要
11. 気象警報：発令中の警報・注意報
12. データソース：Open-Meteo のクレジット表記

出力

主な成果物：.tmp/canada_weekly_weather_report.pdf の PDF レポート

レポートには以下が含まれます。

• 各都市の現在の天気
• 最高気温・最低気温を含む 7 日間の予報
• 降水量
• 地域ごとの比較

エラー処理

• 都市が見つからない場合：その都市をスキップし、警告を記録して続行します
• ネットワークエラー：バックオフを挟んで最大 3 回再試行します
• データが不足している場合：「N/A」をプレースホルダーとして使用します

環境

API キーは不要です！ Open-Meteo は無料のオープンソースです。

データソース：https://open-meteo.com/

---

スキーマ

入力

名前	型	必須	説明
week_start_date	string	いいえ	レポート対象期間の開始日（デフォルトは今週）
cities	string	いいえ	カンマ区切りのカナダの都市一覧

出力

名前	型	説明
pdf_path	file_path	.tmp/canada_weekly_weather_report.pdf の PDF レポート

費用

無料（Open-Meteo API）