1. 격자별 정보제공

기상청에서 제공하는 초단기실황, 초단기예보, 단기예보는 한반도를 5km x 5km 격자로 나누어 격자별로 제공하고 있습니다.

각 격자는 대표 위경도를 가지고 있으며, 이중 행정동을 대표하는 위경도에 격자를 매칭하여 기상자료개방포털의 행정동 지점별 동네예보를 제공하고 있습니다.

1-1. 격자정보의 확인

격자정보는 기상자료개방포털과 기상청API허브(https://apihub.kma.go.kr)에서 확인 가능합니다.

• - 기상자료개방포털 > 소통과 참여 > 자료실 > [기상예보] 동네예보 지점 좌표(위도, 경도) 정보
• - 기상청API허브 > 예특보 > 단기예보 > 4. 동네예보(단기예보, 초단기예보, 실황) 격자자료 > 동네예보 격자 번호 → 위‧경도 변환/임의 위‧경도 → 인근 동네예보 격자 번호 변환

2. 초단기실황

초단기실황은 격자별로 대표 방재기상관측(AWS)지점을 매칭하여 제공하고 있습니다. 10분 간격으로 수집된 AWS지점의 관측자료를 격자별로 정리하여 제공되고 있으며, 행정동 격자 또는 위경도에서 가까운 격자의 실황값 조회가 가능합니다.

제공하는 요소는 강수형태, 습도, 강수, 하늘상태, 기온, 뇌전, 풍향, 풍속입니다. 이중 강수형태, 하늘상태( 2018년 10월까지 제공 ), 뇌전 (2018년 10월까지 제공)은 코드로 제공되고 있으며, 풍향은 360도로 바람이 불어오는 방향을 나타냅니다.

• - 강수형태: 0(없음), 1(비), 2(비/눈), 3(눈)
• - 하늘상태: 1(맑음), 2(구름조금), 3(구름많음), 4(흐림)

2-1. 기상자료개방포털

기상자료개방포털에서는 2010년 6월부터 조회일 기준으로 전월까지의 자료를 제공합니다. 또한, 2018년 7월 11일 이전에는 현재와 같이 대표 AWS지점을 매칭하여 제공된 값이 아닌 분석값을 제공하였으므로 이점을 참고하여 사용하여야 합니다. 자료 조회기간은 1년이며, 파일셋 형태로 각 요소별로 파일이 생성되어 압축파일이 통합하여 제공합니다.

자료를 열어보면 다음과 같이 값이 나타납니다.

구분자는 쉼표(,)이며, 첫 행은 항목명이고 두 번째 행부터 값을 나타냅니다. 첫 행에서 location은 격자정보로 X값고 Y값을 나타내며, Start는 관측일을 나타냅니다. 1열은 일(日)을 나타내고 2열은 시(時), 3열은 조회한 요소값을 나타냅니다. 이중 시(時)는 협정세계시(UTC)를 나타내므로 한국표준시(KST)로 확인하려면 9시간을 더하여야 합니다.

위의 예시를 해석해보면, 청운효자동은 60, 127의 격자에 해당하며, 2023년 1월1일 한국표준시로 9시의 풍속은 2.7m/s이며, 10시는 4.0m/s임을 알수 있습니다.

2-2. API허브

base_date는 최근 1일까지만 가능하며, nx, ny의 격자좌표를 입력하여 실황을 확인할 수 있습니다.

3. 초단기예보

초단기예보는 발표시점부터 6시간 이내에 대하여 행하는 예보를 말합니다. 짧은 시간에 발생‧소명하는 위험기상에 대처하고 이음새 없는 예보시스템 구축을 위해 행정동 단위로 매시 30분, 1시간 간격으로 발표하고 있습니다. 제공하는 요소는 강수형태, 습도, 강수, 하늘상태, 기온, 뇌전, 풍향, 풍속, 동서바람성분(UUU), 남북바람성분(VVV)가 있으며, 강수형태, 하늘상태는 코드로 제공됩니다.

• - 강수형태: 0(없음), 1(비), 2(비/눈), 3(눈), 5(빗방울), 빗방울/눈날림(6), 눈날림(7)
• - 하늘상태: 1(맑음), 2(구름조금), 3(구름많음), 4(흐림) / 2019.6.4. 이후 2(구름조금)은 맑음에 포함

3-1. 기상자료개방포털

기상자료개방포털에서는 2010년 6월부터 조회일 기준으로 전일까지의 자료를 제공합니다. 또한, 2016년 4월 27일 이전에는 기온, 습도, 바람요소가 미제공되었습니다.

자료는 파일셋 형태로 각 요소별로 파일이 생성되어 압축파일로 통합하여 제공합니다.

자료를 열어보면 다음과 같이 값이 나타납니다.

구분자는 쉼표(,)이며, 첫 행은 항목명이고 두 번째 행부터 값을 나타냅니다. 첫 행에서 location은 격자정보로 X값과 Y값을 나타내며, Start는 예보발표일을 나타냅니다. 1열은 일(日)을 나타내고 2열은 발표시각, 3열은 발표시각을 기준으로 예보하는 시각, 4열은 조회한 요소값을 나타냅니다. 이중 발표시각은 협정세계시(UTC)를 나타내므로 한국표준시(KST)로 확인하려면 9시간을 더하여야 합니다. 또한, 예보기준시각은 시간을 더하면서 30분은 제외하여야 합니다.

위의 예시를 해석해보면, 청운효자동은 60, 127의 격자에 해당하며, 2025년 6월3일 한국표준시로 9시30분 발표한 초단기의 기온예보는 10시(+1)에 23도, 11시(+2)에 24도, 12시(+3)에 24도를 나타냅니다.

3-2. API허브

base_date는 최근 3일까지만 가능하며, nx, ny의 격자좌표를 입력하여 예보자료를 확인할 수 있습니다.

4. 단기예보

단기예보는 초단기예보 이후부터 최대 5일까지의 예보를 말합니다.
제공하는 요소는 1시간기온(TMP), 일최고기온(TMX), 일최저기온(TMN), 하늘상태(SKY), 강수형태(PTY), 강수확률(POP), 동서바람성분(UUU), 남북바람성분(VVV), 1시간강수량(PCP), 1시간적설(SNO), 습도(REH), 파고(WAV)가 있으며, 강수형태, 하늘상태는 코드로 제공됩니다.

• - 강수형태: 0(없음), 1(비), 2(비/눈), 3(눈), 4(소나기)
• - 하늘상태: 1(맑음), 2(구름조금), 3(구름많음), 4(흐림) / 2019.6.4. 이후 2(구름조금)은 맑음에 포함

4-1. 기상자료개방포털

기상자료개방포털에서는 2010년 6월부터 조회일 기준으로 전일까지의 자료를 제공합니다.
2021년 6월 29일부터 단기예보 생산체계 개선에 따라, 예보 시간 상세화(기존 3시간 간격 → 1시간 간격, 강수량‧신적설 포함) 및 예보 기간 확장(글피 추가)된 자료를 제공하면서 이전 자료는 (구)단기예보를 통해 제공합니다.

2024년 11월 28일 14시부터 단기예보 예보기간 확장에 따라, 02‧05‧08‧11‧14시 발표기준 글피 예보, 17‧20‧23시 발표기준 그글피 예보를 제공하고 있습니다.

※ 발표시간은 한국시간을 기준으로 작성되었습니다.

연장기간인 (02·05·08·11·14시 발표)글피, (17·20·23시 발표)그글피 예보는 3시간 간격의 자료를 제공하며, 강수량(PCP), 강설(SNO), 풍속(WSD) 요소는 정성정보(코드값)를 제공합니다. 자료를 열어보면 다음과 같이 값이 나타납니다.

- 정성정보 구간범위 및 코드값

자료는 파일셋 형태로 각 요소별로 파일이 생성되어 압축파일로 통합하여 제공합니다.

자료를 열어보면 다음과 같이 값이 나타납니다.

구분자는 쉼표(,)이며, 첫 행은 항목명이고 두 번째 행부터 값을 나타냅니다. 첫 행에서 location은 격자정보로 X값과 Y값을 나타내며, Start는 예보발표일을 나타냅니다. 1열은 일(日)을 나타내고 2열은 발표시각, 3열은 발표시각을 기준으로 예보하는 시각, 4열은 조회한 요소값을 나타냅니다. 이중 발표시각은 협정세계시(UTC)를 나타내므로 한국표준시(KST)로 확인하려면 9시간을 더하여야 합니다.

위의 예시를 해석해보면, 남원읍은 56, 33의 격자에 해당하며, 2025년 5월 6일 한국표준시로 11시00분 발표한 단기의 1시간 강수예보는 17시(+6)에 0mm(강수없음), 18시(+7)에 0mm(강수없음)을 나타냅니다. 그리고 11시의 글피예보에 해당하는 5월 9일 3시(+67)에는 강수없음, 6시(+70)에는 강수강도가 보통비를 나타냅니다.

4-2. API허브

base_date는 최근 3일까지만 가능하며, nx, ny의 격자좌표를 입력하여 예보자료를 확인할 수 있습니다.