korea-weatherlisted

# korea-weather 韓国の気象庁(기상청, KMA)が公共データポータルで提供する短期予報API(단기예보)を使うスキル。2026-09-09 に2オペレーションの実在を確認済み。 ## キーの取得 公共データポータル(data.go.kr)で「기상청 단기예보」(VilageFcstInfoService)に活用申請し、serviceKey を取得する(無料)。ポータル: https://www.data.go.kr/ 、気象庁: https://www.kma.go.kr/ ## 基本の流れ 1. 場所の格子座標(nx, ny)を決める 2. 発表時刻(base_date, base_time)を決める 3. 予報を取得して項目を読む ### 1. 格子座標 気象庁は予報を5km格子で出す。主な観光地: | 場所 | nx | ny | | --- | --- | --- | | ソウル(鍾路) | 60 | 127 | | 仁川 | 55 | 124 | | 水原 | 60 | 121 | | 大田 | 67 | 100 | | 大邱 | 89 | 90 | | 慶州 | 91 | 77 | | 全州 | 63 | 89 | | 光州 | 58 | 74 | | 釜山 | 98 | 76 | | 江陵 | 92 | 131 | | 済州 | 52 | 38 | | 西帰浦 | 52 | 33 | その他の地点は気象庁が配布する格子座標表で確認する(単位は約5km格子。市区の中心点を採用)。 ### 2・3. 取得と読み方 ```bash BASE_DATE=$(TZ=Asia/Seoul date +%Y%m%d) # 超短期実況(現在に近い値) curl -s "http://apis.data.go.kr/1360000/VilageFcstInfoService_2.0/getUltraSrtNcst?serviceKey={KEY}&pageNo=1&numOfRows=20&dataType=JSON&base_date=${BASE_DATE}&base_time=0800&nx=60&ny=127" # 短期予報(3日先まで) curl -s "http://apis.data.go.kr/1360000/VilageFcstInfoService_2.0/getVilageFcst?serviceKey={KEY}&pageNo=1&numOfRows=100&dataType=JSON&base_date=${BASE_DATE}&base_time=0800&nx=60&ny=127" ``` - `base_time`: 発表時刻。短期予報は 0200, 0500, 0800, 1100, 1400, 1700, 2000, 2300 の1日8回。発表直後はまだデータがなく、**発表時刻の10分後以降**に照会する。直近の発表を使うこと。 - レスポンスの `body.items.item[]`: 各要素は `category`(項目), `fcstDate`/`fcstTime`(予報対象時刻), `fcstValue`(値)。 - 主なcategory: - `TMP`/`T1H`: 気温(℃) - `POP`: 降水確率(%) - `SKY`: 空模様(1=晴れ, 3=曇りがち, 4=曇り) - `PTY`: 降水形態(0=なし, 1=雨, 2=雨/雪, 3=