기상청 API허브

융합기상

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

api 상세
개요	(고해상도 격자자료) 기상청 및 공공기관(산림청, 농진청 등) AWS, 해양기상부이, 등표관측자료에 지형효과를 반영한 3차원 객관분석 기법을 적용하여 생산한 분석자료입니다. ※ 해당 자료는 관측자료를 분석하여 생산한 데이터로 실제 관측과는 차이가 있을 수 있으며, 향후 분석기법 및 격자해상도가 변경될 수 있습니다. (천리안2A호 인공지능 기반 한반도 일사량 자료) 신재생에너지 등 신산업 지원을 위해 천리안2A호 데이터와 인공지능기법인 합성곱 인공신경망(CNN)을 활용하여 산출한 일사량 데이터입니다.
요소	(고해상도 격자자료) - (3차원 분석)기온, 이슬점온도, 습도, 풍속, 현지기압, 체감온도 - (2차원 분석)해면기압, 강수유무, 강수량(15분, 60분, 일), 시정 (천리안2A호 인공지능 기반 한반도 일사량 자료) 전천일사량(MJ/㎡)
지점	(고해상도 격자자료) 남한지역 지상+연해(500m 해상도) ※ 해양관측자료의 경우 기준시각 기준 15분 과거자료까지 활용 (천리안2A호 인공지능 기반 한반도 일사량 자료) 한반도(2km 해상도)
보유기간	(고해상도 격자자료) 1997. 1. 1. ~ (천리안2A호 인공지능 기반 한반도 일사량 자료) 2019. 7. 25. 00UTC ~
생산주기	(고해상도 격자자료) 매정시 기준 5분 간격 - (1997. 1. 1. ~ 2022. 12. 31.) 한시간 간격 (매시 00분) - (2023. 1. 1. ~) 0분, 5분, 10분, 15분, 20분, 25분, 30분, 35분, 40분, 45분, 50분, 55분 (천리안2A호 인공지능 기반 한반도 일사량 자료) - 매정시 20분(1시간 간격)/2019. 7. 25. 00UTC ~ 2023. 6. 26. 05UTC - 매정시 20분, 50분(30분 간격)/2023. 6. 26. 06UTC ~

1. 고해상도 격자자료 조회(해상도: 500m)

고해상도 격자자료 위경도 NetCDF파일 참고자료

호출URL정보

전체영역 단일요소

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-sfc_obs_nc_api?obs=ta&tm=202306112300&disp=A&authKey=h_qh_CRpRaK6ofwkaQWirQ

요청인자

데이터 기본 정보
인자명	의미	설명
tm	년월일시분(KST)	조회할 시간 (없으면 현재시간)
obs	요소	ta(기온), hm(상대습도), td(이슬점온도), wd_10m(10분 평균풍향), ws_10m(10분 평균풍속), uu(바람 U 성분), vv(바람 V 성분), pa(현지기압), ps(해면기압), rn_ox(강수유무), rn_15m(15분강수), rn_60m(60분강수), rn_day(일강수), vs(시정), ta_chi(체감온도)
disp	표출형태	A(아스키), B(바이러니) (default) 바이러니(B)인 경우 처음 4byte는 nx(X축 격자점수, 2byte), ny(Y축 격자점수, 2byte)이며 자료는 실수로(4byte)로 출력
authKey	인증키	발급된 API 인증키

호출URL정보

특정지점 단일요소

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-sfc_obs_nc_pt_api?obs=ta&tm1=202306110000&tm2=202306110300&itv=10&lon=126.5329&lat=33.361&authKey=h_qh_CRpRaK6ofwkaQWirQ

요청인자

데이터 기본 정보
인자명	의미	설명
tm1	년월일시분(KST)	조회할 시간 (없으면 현재시간)
tm2	년월일시분(KST)	조회할 시간구간의 종료시간 (없으면 tm1값)
obs	요소	ta(기온), hm(상대습도), td(이슬점온도), wd_10m(10분 평균풍향), ws_10m(10분 평균풍속), uu(바람 U 성분), vv(바람 V 성분), pa(현지기압), ps(해면기압), rn_ox(강수유무), rn_15m(15분강수), rn_60m(60분강수), rn_day(일강수), vs(시정), ta_chi(체감온도)
itv	자료조회간격	분
lon	경도	degree
alt	위도	degree
authKey	인증키	발급된 API 인증키

호출URL정보

특정지점 다중요소

https://apihub.kma.go.kr/api/typ01/url/sfc_nc_var.php?tm1=202306110000&tm2=202306110300&lon=126.96579&obs=ta,td,hm&itv=10&lat=37.57141&help=1&authKey=h_qh_CRpRaK6ofwkaQWirQ

요청인자

데이터 기본 정보
인자명	의미	설명
tm1	년월일시분(KST)	조회할 시간 (없으면 현재시간)
tm2	년월일시분(KST)	조회할 시간구간의 종료시간 (없으면 tm1값) ※ 최대 조회기간 : 60분
obs	요소	ta(기온), hm(상대습도), td(이슬점온도), wd_10m(10분 평균풍향), ws_10m(10분 평균풍속), uu(바람 U 성분), vv(바람 V 성분), pa(현지기압), ps(해면기압), rn_ox(강수유무), rn_15m(15분강수), rn_60m(60분강수), rn_day(일강수), vs(시정), ta_chi(체감온도)
itv	자료조회간격	분
lon	경도	degree
lat	위도	degree
help	도움말추가	도움말(0: 미표출, 1:표출)
authKey	인증키	발급된 API 인증키

호출URL정보

파일 다운로드(NetCDF4)

https://apihub.kma.go.kr/api/typ01/url/sfc_grid_nc_down.php?obs=ta&tm=202306121200&authKey=h_qh_CRpRaK6ofwkaQWirQ

요청인자

데이터 기본 정보
인자명	의미	설명
tm	년월일시분(KST)	조회할 시간 (없으면 현재시간)
obs	요소	ta(기온), hm(상대습도), td(이슬점온도), ws_10m(10분 평균풍속), wind(바람(풍향,풍속,U,V), pa(현지기압), ps(해면기압), rn_ox(강수유무), rn_15m(15분강수), rn_60m(60분강수), rn_day(일강수), vs(시정)
authKey	인증키	발급된 API 인증키

호출URL정보

분포도 이미지

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-sfc_obs_nc_img?obs=ta&tm=202306121200&map=HR&size=800&authKey=h_qh_CRpRaK6ofwkaQWirQ

요청인자

데이터 기본 정보
인자명	의미	설명
tm	년월일시분(KST)	조회할 시간 (없으면 현재시간)
obs	요소	ta(기온), hm(상대습도), td(이슬점온도), ws_10m(10분 평균풍속), wv_10m(10분 평균바람백터), pa(현지기압), ps(해면기압), rn_ox(강수유무), rn_15m(15분강수), rn_60m(60분강수), rn_day(일강수), vs(시정), ta_chi(체감온도)
map	영역	HR(격자자료 전체영역), D3(한반도영역)
size	이미지크기	pixel
authKey	인증키	발급된 API 인증키

호출URL정보

격자자료 위도

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-sfc_obs_latlon_api?latlon=lat&authKey=h_qh_CRpRaK6ofwkaQWirQ

격자자료 경도

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-sfc_obs_latlon_api?latlon=lon&authKey=h_qh_CRpRaK6ofwkaQWirQ

요청인자

데이터 기본 정보
인자명	의미	설명
latlon	위경도 선택	lat(위도)

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

데이터 소개 참고자료

투영법 참고자료

호출URL정보

이미지

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=h_qh_CRpRaK6ofwkaQWirQ

요청인자

데이터 기본 정보
인자명	의미	설명
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

호출URL정보

텍스트

https://apihub.kma.go.kr/api/typ01/cgi-bin/sat/nph-sat_ana_txt?tm=202107100700&obs=si_ai&help=1&authKey=h_qh_CRpRaK6ofwkaQWirQ

요청인자

데이터 기본 정보
인자명	의미	설명
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

호출URL정보

이진 파일 다운로드(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=h_qh_CRpRaK6ofwkaQWirQ

이미지 파일 다운로드(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=h_qh_CRpRaK6ofwkaQWirQ

요청인자

데이터 기본 정보
인자명	의미	설명
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