OpenWeatherMap apiを使用した天気予報を取得する関数作成で発生したエラーを解消したい．

Question

実現したいこと

OpenWeatherMap APIから任意の気象予報データを取得したいです．

前提

最近プログラミング，pythonを勉強し始めた人間です．
初めて質問させていただくため，情報不足など至らない点があるかもしれませんが，ご了承ください．
基礎を勉強し，現在は最高気温や最低気温，降水確率を取得し，任意の時間にLINEに表示するbotを作成中です．
apiから気象予報データを取得するコードがある程度書けたため，試しに東京の3時間後の予報の取得を試みました．
するとエラーが発生し，色々調べましたが理由が分からず，困惑しています．
どなたか分かる方がいらっしゃったら助けてください．

OpenWeatherMap APIで取得できるjson形式のapi応答フィールドは以下の通りとなります．

cod：内部パラメータ
message：内部パラメータ
cntAPI ：応答で返されるタイムスタンプの数
list
ーlist.dt ：予測されたデータの時刻 (UNIX、UTC)
ーlist.main
ーーーlist.main.temp：温度
ーーーlist.main.feels_likeこの温度パラメータは、人間の天候の認識を説明しています。
ーーーlist.main.temp_min：計算時の最低気温
ーーーlist.main.temp_max：計算時の最高温度。
ーーーlist.main.pressure：デフォルトの海面大気圧
ーーーlist.main.sea_level：海面上の大気圧
ーーーlist.main.grnd_level：地上の大気圧
ーーーlist.main.humidity：湿度
ーーーlist.main.temp_kf：内部パラメータ
ーlist.weather
ーーーlist.weather.id：気象条件 ID
ーーーlist.weather.main：気象パラメータのグループ(雨、雪、雲など)
ーーーlist.weather.description：グループ内の気象条件（晴れ，快晴など）
ーーーlist.weather.icon：天気アイコン ID
ーlist.clouds
ーーーlist.clouds.all：曇り度
ーlist.wind
ーーーlist.wind.speed：風速
ーーーlist.wind.deg：風向
ーーーlist.wind.gust：突風
ーーーlist.visibility：平均視程
ーーーlist.pop：降水確率
ーlist.rain
ーーーlist.rain.3h：過去3時間の雨量
ーlist.snow
ーーーlist.snow.3h：過去3時間の積雪量
ーlist.sys
ーーーlist.sys.pod：一日の一部(n - 夜、d - 日)
ーlist.dt_txt：予測されるデータの時刻、ISO、UTC
city
ーcity.id ：市区町村 ID
ーcity.name 市区町村名
ーcity.coord
ーーcity.coord.lat ：緯度
ーーcity.coord.lon：経度
ーcity.country ：国コード(GB、JPなど)
ーcity.population市の人口
ーcity.timezone：UTC からの秒単位のシフト
ーcity.sunrise：日の出時刻 (ユニックス、UTC)
ーcity.sunset：サンセット時間, ユニックス, UTC

発生している問題・エラーメッセージ

KeyError: 'weather'

該当のソースコード

#天気予報を取得する関数
def get_weather(latitude,longitude):
    #OpenWeatherMap APIキー
    api_key = '{my_api_key}'
    #url作成
    endpoint = 'https://api.openweathermap.org/data/2.5/forecast?lat={lat}&lon={lon}&units=metric&lang=ja&appid={api_id}&cnt={limit}'
    #取得する予報時刻の数
    request_line = 1
    url = endpoint.format(lat = latitude , lon = longitude , api_id = api_key , limit = request_line)
    #APIから情報を取得(レスポンス)
    response = requests.get(url)
    #レスポンスの内容をJSONフォーマットからPythonフォーマットに変換
    response = response.json()
    #気象情報の取得
    climate = response['weather'][0]['description']
    temp_max = response['main']['temp_max']
    temp_min = response['main']['temp_min']
    precipitation = response['pop']
    #出力
    print(f'{weather}の予報です．')
    print(f'最高気温は{temp_max}℃です．')
    print(f'最低気温は{temp_min}℃です．')
    print(f'降水確率は{precipitation}％です．')
    if precipitation <= 0.5 :
        print('傘を持ち歩いた方が良いでしょう．お出かけの際は忘れずに！')
    else :
        print('傘は必要ありません．')
get_weather(35.6813,139.766)

試したこと

15行目の
climate = response['weather'][0]['description']
で発生していますが，この行全体をコメントアウトすると15行目で
Keyerror: 'main'
と出てきます．

responseの中身は以下の通りでした．
{'cod': '200', 'message': 0, 'cnt': 1, 'list': [{'dt': 1693828800, 'main': {'temp': 28.34, 'feels_like': 34.25, 'temp_min': 27.81, 'temp_max': 28.34, 'pressure': 1010, 'sea_level': 1010, 'grnd_level': 1008, 'humidity': 87, 'temp_kf': 0.53}, 'weather': [{'id': 500, 'main': 'Rain', 'description': '小雨', 'icon': '10n'}], 'clouds': {'all': 75}, 'wind': {'speed': 2.86, 'deg': 182, 'gust': 3.93}, 'visibility': 10000, 'pop': 0.62, 'rain': {'3h': 1.24}, 'sys': {'pod': 'n'}, 'dt_txt': '2023-09-04 12:00:00'}], 'city': {'id': 1857654, 'name': '東京都千代田区丸の内', 'coord': {'lat': 35.6813, 'lon': 139.766}, 'country': 'JP', 'population': 0, 'timezone': 32400, 'sunrise': 1693772087, 'sunset': 1693818368}}

見ていただいたら分かる通り，weatherは存在しています．

補足情報（FW/ツールのバージョンなど）

ここにより詳細な情報を記載してください。

Comments

[meg_]

> KeyError: 'weather'
辞書responseのキーとして'weather'がないんでしょうね。

[meg_]

> apiから気象予報データを取得するコードがある程度書けたため，
どんなコードでしたらエラーなく実行できましたか？

[kokou]

回答ありがとうございます！
>>　辞書responseのキーとして'weather'がないんでしょうね。
私もそう思うのですが，他に同じようなコードを書かれている方はこのコードでエラー無く実行できているようでして，なぜ私の場合はエラーが出るのかが分かりません．

>>どんなコードでしたらエラーなく実行できましたか？
14行目以降をコメントアウトして
print(response)
としたら，エラーは発生しませんでした．

[meg_]

> 他に同じようなコードを書かれている方はこのコードでエラー無く実行できているようでして
ご自身の（環境での）コードでデバッグしないと問題は解決しないと思います。
まずresponseのキーとして存在しているものは何なのか？を確認するところからではないでしょうか。

[kokou]

キーとして存在しているものは前提に書きましたapi取得フィールドだと思います．分かりにくくてすみません．公式サイトに書かれていたものをコピペしました．ここを見ると'weather'や'main'など存在しているため，なぜエラーが発生するのか分かりません．

[meg_]

> 見ていただいたら分かる通り，weatherは存在しています．
responseのキーとして存在しているものは 'cod', 'message', 'cnt', 'list', 'city' です。

Answer 1

見ていただいたら分かる通り，weatherは存在しています．

responseのキーとして存在しているものは 'cod', 'message', 'cnt', 'list', 'city' です。responseの中身に'weather'が存在していたとしてもそれはresponseのキーとしては存在していないのでキーとしては使用できません。

例えば「 '小雨'」を取り出すには

response['weather'][0]['description']

ではなく

response['list'][0]['weather'][0]['description']

と書く必要があります。

Comments

[kokou]

回答ありがとうございます！
無事改善できました！
基礎知識が不足していることを痛感しました．もっと勉強したいと思います．
何度もコメントにて解答していただき，ありがとうございました！

Answer 2

pythonを勉強中とのことですので、解決のきっかけを1つ。

    response = response.json()
    #気象情報の取得
    climate = response['weather'][0]['description']

エラーはこの下の行で起きていて、「KeyError: 'weather'」とあるように、responseに入っている辞書に'weather'という キーが無いと言っているわけです。
あるはずのものが無いのであれば、中を見てみればいいのです。responseは 上の行で取得しているのですから、その下で

• debug実行して取得後のresponseの中身を確認する。
• debugできないのであれば、print(response)などとして表示してみる

と、問題の原因が1つわかるでしょう。

また、

この行全体をコメントアウトする

とあるように、問題のある行を省いてみるのは意味が無いことが多いです。
その行は必要だからあるのだし、そもそもその行が原因ではなくその前に原因があるので、その行を無くしてしまえば、問題ほ増やしているだけだからです。

---

BAついていますが、コメントいただいたので追記します。

質問前に内容は見てみたとのこと。ですが、もしかして、以下のような形のまま見ていたのでしょうか？

{'cod': '200', 'message': 0, 'cnt': 1, 'list': [{'dt': 1693828800, 'main': {'temp': 28.34, 'feels_like': 34.25, 'temp_min': 27.81, 'temp_max': 28.34, 'pressure': 1010, 'sea_level': 1010, 'grnd_level': 1008, 'humidity': 87, 'temp_kf': 0.53}, 'weather': [{'id': 500, 'main': 'Rain', 'description': '小雨', 'icon': '10n'}], 'clouds': {'all': 75}, 'wind': {'speed': 2.86, 'deg': 182, 'gust': 3.93}, 'visibility': 10000, 'pop': 0.62, 'rain': {'3h': 1.24}, 'sys': {'pod': 'n'}, 'dt_txt': '2023-09-04 12:00:00'}], 'city': {'id': 1857654, 'name': '東京都千代田区丸の内', 'coord': {'lat': 35.6813, 'lon': 139.766}, 'country': 'JP', 'population': 0, 'timezone': 32400, 'sunrise': 1693772087, 'sunset': 1693818368}}

jsonは複雑な構造をしている場合があるので、このなかに「weather」というキーが見えるからといって、それがトップレベルにあるかどうかはわかりません。こういう場合は、構造がわかるように整形して みてみるべきでしょう。
このように整形することを pritty print とも言います。 エディタにも機能が付いていることもありますし、 オンラインの整形ツールもいくつも提供されています。 「json 整形」とか「 json pretty print」とかで検索すればいろいろみつかります。
このようにしてみれば、どのような構造で、どのようにアクセスすれば求める情報を得ることができるかわかるでしょう。

{
	"cod": "200",
	"message": 0,
	"cnt": 1,
	"list": [
		{
			"dt": 1693828800,
			"main": {
				"temp": 28.34,
				"feels_like": 34.25,
				"temp_min": 27.81,
				"temp_max": 28.34,
				"pressure": 1010,
				"sea_level": 1010,
				"grnd_level": 1008,
				"humidity": 87,
				"temp_kf": 0.53
			},
			"weather": [
				{
					"id": 500,
					"main": "Rain",
					"description": "小雨",
					"icon": "10n"
				}
			],
			"clouds": {
				"all": 75
			},
			"wind": {
				"speed": 2.86,
				"deg": 182,
				"gust": 3.93
			},
			"visibility": 10000,
			"pop": 0.62,
			"rain": {
				"3h": 1.24
			},
			"sys": {
				"pod": "n"
			},
			"dt_txt": "2023-09-04 12:00:00"
		}
	],
	"city": {
		"id": 1857654,
		"name": "東京都千代田区丸の内",
		"coord": {
			"lat": 35.6813,
			"lon": 139.766
		},
		"country": "JP",
		"population": 0,
		"timezone": 32400,
		"sunrise": 1693772087,
		"sunset": 1693818368
	}
}

Comments

[kokou]

回答ありがとうございます！
responseの中身は確認していたのですが，weatherは存在しているため，mainやtemp_maxなどのほかのキーは存在するのか確認するため，コメントアウトをしました．その旨を記載しておらず，申し訳ありません．responseの中身を追記したため，よろしければご確認いただき，改善策を教えていただけると幸いです．

[kokou]

追記ありがとうございます！
pritty printは知りませんでした．確かに見にくいなとは感じており，DataFrameにできないかなど試行錯誤しましたが，エラー表示が出てきて，諦めていました．
大変，勉強になりました．教えていただき，ありがとうございます！

[TakaiY]

お役にたててなにより。
vscodeなどの高機能なエディタのjson表示の機能を使うと、一部を折畳んだりできるので、より見やすくなりますよ。

> DataFrameにできないか
DataFrameというのは、CSVのような、表形式のデータを効率良く処理するための仕組みです。jsonのような複雑な構造を扱うようにはできていないので、不適切ですね。