기상청 API허브

융합기상

기상기후데이터와 에너지, 생활, 교통, 산업 등 타분야 데이터를 융합하거나, 융합에 특화된 데이터를 제공합니다.

api 상세
개요	(천리안 일사량 자료) 신재생에너지 등 신산업 지원을 위해 천리안2A호 데이터와 인공지능기법인 합성곱 인공신경망(CNN)을 활용하여 산출한 일사량 데이터입니다. (에너지 기상) 한국형수치예보모델(KIM) 기반 한반도 인근영역을 대상으로 에너지 기상 예측변수만 추출하여 생산한 데이터입니다. (재현바람장) 기상청의 수치예보모델(KIM-meso)과 AI 기법(AI-변분자료동화)을 활용하여 남한지역에서 최근 5년(`21.6.∼`26.5.)에 대한 고해상도(1km×1km)의 바람을 재현한 자료입니다.
요소	- (천리안 일사량 자료) 천리안2A호 인공지능 기반 한반도 전천일사량(MJ/㎡) - (에너지 기상) 기온, 습도, 풍속, 풍향, 일사량, 운량 - (재현바람장) 고도별(10m, 80m, 140m, 220m) 바람
지점	- (천리안 일사량 자료) 천리안2A호 인공지능 기반 한반도(2km 해상도) - (에너지 기상) 한반도 영역 - (재현바람장) 남한지역
보유기간	- (천리안 일사량 자료) 2019. 7. 25. 00UTC ~ - (에너지 기상) 2026.2. ~ - (재현바람장) 2021.6.1.09:00~2026.6.1.08:50(5년, 10분간격) / KST기준
생산주기	- (천리안 일사량 자료) 매정시 기준 1시간 간격/2019. 7. 25. 00UTC ~ 2023. 6. 26. 05UTC, 매정시 기준 30분 간격/2023. 6. 26. 06UTC ~ 2026.7.14.05UTC, 매정시 기준 10분 간격 2026.7.14. 06 UTC ~ 현재 - (에너지 기상) 일 2회(09, 21KST)

1. 천리안2A호 인공지능 기반 한반도 일사량 자료 조회

데이터 소개 참고자료

투영법 참고자료

1.1 이미지

https://apihub.kma.go.kr/api/typ01/cgi-bin/sat/nph-sat_ana_img?obs=si_ai&tm=202107100700&size=600&sat=G&map=H1&xp=-9999&yp=-9999&zoom=1.3&scn=ko&authKey={인증키입력}

요청인자

데이터 기본 정보
인자명	의미	설명
size	이미지크기	기본:600px(이미지크기 설정)
tm	기준시간	nph-sat_ana_txt, nph-sat_ana_img - yyyymmddhhmm(년월일시분(KST) 1시간 간격 자료(누적값))sat_file_down2.php - yyyymmddhhmm(년월일시분(UTC) 1시간 간격 자료(누적값))
obs	자료	si_ai(인공지능 기반 일사자료/고정)
help	자료도움말	0: 도움말 없음, 1: 자료 도움말 표출
typ	종류	bin(nc파일), img(png이미지파일)
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
설명자료	#으로 시작하는 줄은 설명자료 표출이니 처리하지 않음	값	일사량(아래에서 위로, 왼쪽에서 오른쪽 순서로 값을 표출)
기준점	기준 위경도: 기준경도 126.0E, 기준위도 38.0N기준 위경도 대응 격자점: 남북방향 450, 동서방향 450좌상단 경도 -899000m/113.996418E, 위도 899000m/45.728965N우상단 경도 899000m/138.003582E, 위도 899000m/45.728965N좌하단 경도 -899000m/116.753260E, 위도 -899000m/29.312252N우하단 경도 899000m/135.246740E, 위도 -899000m/29.312252N

1.2 텍스트

https://apihub.kma.go.kr/api/typ01/cgi-bin/sat/nph-sat_ana_txt?tm=202107100700&obs=si_ai&help=1&authKey={인증키입력}

요청인자

데이터 기본 정보
인자명	의미	설명
size	이미지크기	기본:600px(이미지크기 설정)
tm	기준시간	nph-sat_ana_txt, nph-sat_ana_img - yyyymmddhhmm(년월일시분(KST) 1시간 간격 자료(누적값))sat_file_down2.php - yyyymmddhhmm(년월일시분(UTC) 1시간 간격 자료(누적값))
obs	자료	si_ai(인공지능 기반 일사자료/고정)
help	자료도움말	0: 도움말 없음, 1: 자료 도움말 표출
typ	종류	bin(nc파일), img(png이미지파일)
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
설명자료	#으로 시작하는 줄은 설명자료 표출이니 처리하지 않음	값	일사량(위에서 아래로, 왼쪽에서 오른쪽 순서로 값을 표출)
기준점	기준 위경도: 기준경도 126.0E, 기준위도 38.0N기준 위경도 대응 격자점: 남북방향 450, 동서방향 450좌상단 경도 -899000m/113.996418E, 위도 899000m/45.728965N우상단 경도 899000m/138.003582E, 위도 899000m/45.728965N좌하단 경도 -899000m/116.753260E, 위도 -899000m/29.312252N우하단 경도 899000m/135.246740E, 위도 -899000m/29.312252N

1.3.1 이진 파일 다운로드(NetCDF4)

https://apihub.kma.go.kr/api/typ01/url/sat_file_down2.php?lvl=l2&dat=ai-dsr&are=ko&tm=202203151000&typ=bin&authKey={인증키입력}

1.3.2 이미지 파일 다운로드(png)

https://apihub.kma.go.kr/api/typ01/url/sat_file_down2.php?lvl=l2&dat=ai-dsr&are=ko&tm=202107100700&typ=img&authKey={인증키입력}

요청인자

데이터 기본 정보
인자명	의미	설명
size	이미지크기	기본:600px(이미지크기 설정)
tm	기준시간	nph-sat_ana_txt, nph-sat_ana_img - yyyymmddhhmm(년월일시분(KST) 1시간 간격 자료(누적값))sat_file_down2.php - yyyymmddhhmm(년월일시분(UTC) 1시간 간격 자료(누적값))
obs	자료	si_ai(인공지능 기반 일사자료/고정)
help	자료도움말	0: 도움말 없음, 1: 자료 도움말 표출
typ	종류	bin(nc파일), img(png이미지파일)
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
설명자료	#으로 시작하는 줄은 설명자료 표출이니 처리하지 않음	값	일사량(아래에서 위로, 왼쪽에서 오른쪽 순서로 값을 표출)
기준점	기준 위경도: 기준경도 126.0E, 기준위도 38.0N기준 위경도 대응 격자점: 남북방향 450, 동서방향 450좌상단 경도 -899000m/113.996418E, 위도 899000m/45.728965N우상단 경도 899000m/138.003582E, 위도 899000m/45.728965N좌하단 경도 -899000m/116.753260E, 위도 -899000m/29.312252N우하단 경도 899000m/135.246740E, 위도 -899000m/29.312252N

2. 에너지기상 자료 조회

에너지기상 단기예측 조회서비스 API 명세서 참고자료

에너지기상 위경도 자료 참고자료

2.1.1 에너지기상 단기예측 조회서비스

https://apihub.kma.go.kr/api/typ01/url/nph_tiresias_nc.php?tmfc=2026022509&nwp=KIMR&var=t2m&hf=0&disp=A&help=1&authKey={인증키입력}

2.1.2 격자 영역 자료 조회서비스

https://apihub.kma.go.kr/api/typ01/url/nph_tiresias_nc.php?tmfc=2026071509&nwp=KIMR&var=lcld&hf=24&map=S&sub=1,1,50,50&disp=A&help=1&authKey={인증키입력}

2.1.3 격자지점 조회

https://apihub.kma.go.kr/api/typ01/url/nph_tiresias_nc.php?tmfc=2026071509&nwp=KIMR&var=acswdnb&hf=24&map=S&X=60&Y=60&disp=A&help=1&authKey={인증키입력}

2.1.4 위·경도 추출 조회

https://apihub.kma.go.kr/api/typ01/url/nph_tiresias_nc.php?tmfc=2026062509&nwp=KIML&var=ws80m&hf=4&map=S&lon=150&lat=38&disp=A&help=1&authKey={인증키입력}

요청인자

데이터 기본 정보
인자명	의미	설명
nwp	원자료 모델명	KIMR(KIM지역), KIML(KIM국지) ※ 해당 모델에서 한반도 인근영역을 대상으로 에너지기상 예측변수 추출하여 생산
var	변수	t2m(지상기온), rh2m(상대습도), lcld(하층운량), mcld(중층운량), hcld(상층운량), dssw(수평면일사량), nssw(법선면일사량), ws10m(10m 풍속), ws80m(80m 풍속), ws140m(140m 풍속), ws220m(220m 풍속), wd10m(10m 풍향), wd80m(80m 풍향), wd140m(140m 풍향), wd220m(220m 풍향), acswdnb(1시간 누적일사량, ‘26.4.28. 09KST부터 산출))
tmfc	분석시각	연월일시(KST) / 시각은 09, 21 (예: 2026022509 = 2026년 2월 25일 09KST)
hf	예측선행시간	시간(hour) (예: 24 = +24H)
disp	제공형태	N(NetCDF 다운로드), A(ASCII)
help	도움말	0(미표출), 1(표출)
map	사용 영역	· F : 자료 영역 전체 · S : 일부 격자 영역만 추출(sub 인자료 영역 정의 필요)
sub	격자 영역	· map=S인 경우, 추출할 격자 영역을 표시 · 표시 방법은 sub=x_min, y_min, x_max, y_max · 왼쪽 아래 격자점 [x_min, y_min]에서 오른쪽 위 격자점 [x_max, y_max] 까지를 의미
x, y	동서, 남북 방향 좌표	임의 격자점을 추출하는 경우 사용
lon, lat	위도, 경도	임의 위경도 지점을 추출하는 경우 사용

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
NetCDF	nc파일 다운로드	ASCII	문숫자 표출

3. 재현바람장 조회

3.1 재현바람장 남한영역 전체 격자조회

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-rawm_data_api?tm=202409020900&obs=wd80m&disp=A&authKey={인증키입력}

요청인자

데이터 기본 정보
인자명	의미	설명
tm	재현바람장 자료시각	YYYYMMDDHH00(KST) / 조회 가능 기간(202106010900 ~ 202606010800)
obs	변수	wd10(10m 풍향), ws10(10m 풍속), wd80(80m 풍향), ws80(80m 풍속), wd140(140m 풍향), ws140(140m 풍속), wd220(220m 풍향), ws220(220m 풍속)
disp	출력방법	A: CSV, B:바이너리

3.2 재현바람장 위·경도 추출 조회

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-rawm_latlon_api?tm1=202409020900&tm2=202409022350&ht=80&lat=35.0&lon=128.5&itv=10&authKey={인증키입력}

요청인자

데이터 기본 정보
인자명	의미	설명
tm1	재현바람장 자료 시작 시각	YYYYMMDDHH00(KST) / 조회 가능 기간(202106010900 ~ 202606010800)
tm2	재현바람장 자료 종료 시각	YYYYMMDDHH00(KST)
ht	고도	바람고도 (10, 80, 140, 220)
lat	위도	위도
lon	경도	경도
itv	자료 간격	(10: 10분간격 조회, 30: 30분간격 조회) 서버 과부하 방지를 위해 자료간격에 따라 1회 조회 가능 시간 조정(최대 144개 파일, 파일은 10분 간격) - 10분간격 조회시 최대 1일 자료 조회 가능 / 20:2일, 30:3일, 40:4일