【コピペで動く】PythonとAPIで天気予報CLIアプリを作ろう！初心者でも安心のステップ・バイ・ステップ解説

$ python weather.py Tokyo

[ 東京 (JP) の天気 ]
天気: 晴れ ☀️
気温: 28.5℃ (体感: 29.1℃)
湿度: 65%
風速: 3.1 m/s

pip install requests

import requests
import json

# STEP1で取得したあなたのAPIキーに書き換えてください
API_KEY = "あなたのAPIキーをここに貼り付け"
CITY_NAME = "Tokyo"

# APIリクエストURLを組み立て
api_url = f"https://api.openweathermap.org/data/2.5/weather?q={CITY_NAME}&appid={API_KEY}&units=metric&lang=ja"

try:
    # 実際にAPIにリクエストを送信
    response = requests.get(api_url)
    response.raise_for_status() # エラーがあれば例外を発生させる

    # 結果をJSON形式からPythonの辞書型に変換
    data = response.json()

    # データを分かりやすく表示
    print(json.dumps(data, indent=2, ensure_ascii=False))

except requests.exceptions.RequestException as e:
    print(f"通信エラーが発生しました: {e}")
except Exception as e:
    print(f"予期せぬエラーが発生しました: {e}")

$ python weather.py

{
  "coord": {
    "lon": 139.6917,
    "lat": 35.6895
  },
  "weather": [
    {
      "id": 800,
      "main": "Clear",
      "description": "晴れ",
      "icon": "01d"
    }
  ],
  "base": "stations",
  "main": {
    "temp": 28.5,
    "feels_like": 29.1,
    "temp_min": 27.21,
    "temp_max": 29.58,
    "pressure": 1012,
    "humidity": 65
  },
  "visibility": 10000,
  "wind": {
    "speed": 3.09,
    "deg": 190
  },
  // ...まだまだ続く
}

import requests
import argparse
import os

def get_weather_emoji(weather_main):
    """天気の英語名から絵文字を返す"""
    if weather_main == "Clear":
        return "☀️"
    elif weather_main == "Clouds":
        return "☁️"
    elif weather_main == "Rain":
        return "🌧️"
    elif weather_main == "Drizzle":
        return "🌦️"
    elif weather_main == "Thunderstorm":
        return "⛈️"
    elif weather_main == "Snow":
        return "❄️"
    else:
        return "🌫️" # Mist, Smoke, Haze, Dust, Fog, Sand, Ash, Squall, Tornado

def format_weather_data(data):
    """APIレスポンスを整形して文字列で返す"""
    try:
        city_name = data["name"]
        country = data["sys"]["country"]
        weather_description = data["weather"][0]["description"]
        weather_main = data["weather"][0]["main"]
        emoji = get_weather_emoji(weather_main)
        temp = data["main"]["temp"]
        feels_like = data["main"]["feels_like"]
        humidity = data["main"]["humidity"]
        wind_speed = data["wind"]["speed"]

        # 見やすいように出力文字列を組み立てる
        output = f"[ {city_name} ({country}) の天気 ]\n"
        output += f"天気: {weather_description} {emoji}\n"
        output += f"気温: {temp}°C (体感: {feels_like}°C)\n"
        output += f"湿度: {humidity}%\n"
        output += f"風速: {wind_speed} m/s"
        
        return output
    except KeyError:
        return "天気データの解析に失敗しました。レスポンスの形式が不正な可能性があります。"

def main():
    # 1. APIキーを環境変数から取得する
    #    より安全にキーを管理するため
    api_key = os.getenv("OPENWEATHERMAP_API_KEY")
    if not api_key:
        print("エラー: 環境変数 'OPENWEATHERMAP_API_KEY' が設定されていません。")
        print("APIキーを設定してから再度実行してください。")
        return # プログラムを終了

    # 2. コマンドライン引数を設定する
    parser = argparse.ArgumentParser(description="指定された都市の現在の天気情報を表示します。")
    parser.add_argument("city", help="天気情報を取得したい都市名 (例: Tokyo)")
    parser.add_argument("-u", "--units", choices=["metric", "imperial"], default="metric", 
                        help="温度の単位を指定します ('metric' for Celsius, 'imperial' for Fahrenheit)")
    
    args = parser.parse_args()
    
    # 3. APIにリクエストを送信する
    base_url = "https://api.openweathermap.org/data/2.5/weather"
    params = {
        "q": args.city,
        "appid": api_key,
        "units": args.units,
        "lang": "ja"
    }

    try:
        response = requests.get(base_url, params=params)
        # 4xx, 5xx のエラーコードが返ってきた場合に例外を発生させる
        response.raise_for_status()

        weather_data = response.json()
        
        # 4. 結果を表示する
        formatted_output = format_weather_data(weather_data)
        print(formatted_output)

    except requests.exceptions.HTTPError as e:
        if e.response.status_code == 401:
            print("エラー: APIキーが無効です。正しいAPIキーが設定されているか確認してください。")
        elif e.response.status_code == 404:
            print(f"エラー: 都市 '{args.city}' が見つかりませんでした。都市名を確認してください。")
        else:
            print(f"HTTPエラーが発生しました: {e}")
    except requests.exceptions.RequestException as e:
        print(f"通信エラーが発生しました: {e}")
    except Exception as e:
        print(f"予期せぬエラーが発生しました: {e}")


if __name__ == "__main__":
    main()

export OPENWEATHERMAP_API_KEY="あなたのAPIキー"

set OPENWEATHERMAP_API_KEY="あなたのAPIキー"

$Env:OPENWEATHERMAP_API_KEY="あなたのAPIキー"

$ python weather.py Osaka

$ python weather.py "New York" -u imperial