기상청 API허브

위성

적외, 가시, 수증기 등 16개 채널로 관측한 기본 관측데이터와 지표면온도, 산불탐지 등 46종의 기상산출물데이터를 영상자료와 데이터파일로 제공합니다.

천리안 2A호
천리안 1호

api 상세
개요	히마와리 위성은 일본의 정지궤도 기상위성으로 기상관측임무를 수행하고 있습니다.
요 소	전구, 동아시아, 한반도
지 점	(기본관측) 가시, 근적외, 단파, 수증기, 적외 (기상산출물)RGB 자연색, RGB 기단, RGB 황사, RGB 천연색, RGB 자연색, RGB 기단, RGB 황사
보유기간	2017년 3월 ～ 현재
생산주기	매시 00, 10, 20, 30, 40, 50분

1. 히마와리 지점별 채널값자료

1.1 1개 위치

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-hima_pnt?tm1=202302190900&tm2=202302191300&obs=ch12&lon=127.52&lat=38.34&help=1&authKey={인증키입력}

요청인자

데이터 기본 정보
인자명	의미	설명
tm1	년월일시분(KST)	시작 시각
tm2	년월일시분(KST)	종료 시각
obs	채널변수	< 천리안 > ir1, ir2, ir3, wvp, vis, cld(구름유무), ca(운량), cth(운고), ct(운형), fog(안개), ai(황사지수), lst(지면온도), sst(해수면온도), s01(1일평균 해수면온도), s05(5일평균 해 수면온도), s10(10일평균 해수면온도), ins(일사량) < 히마와리 > ch?? (01~16)
lon	경도	degree
lat	위도	degree
stn	지점번호	여러 지점인 경우, 콤마(,)로 구분하여 기술 99999(AWS전체지점), 99998(기상관서전체), 99997(북한지점전체)
help	도움말	1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
TM	천리안 위상 관측시각 (KST)	IR1	IR1 체널의 온도값 (C)
IR2	IR2 체널의 온도값 (C)	IR3	SW 체널의 온도값 (C)
WVP	WV 체널의 온도값 (C)	VIS	VIS 체널의 알베도값 (%)
STN	지점번호	CH??	?? 채널의 온도값(C) 또는 알베도값(%)

1.2 여러 지점

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-hima_stns?tm1=202302190900&tm2=202302191300&obs=ch12&stn=108,133&help=1&authKey={인증키입력}

요청인자

데이터 기본 정보
인자명	의미	설명
tm1	년월일시분(KST)	시작 시각
tm2	년월일시분(KST)	종료 시각
obs	채널변수	< 천리안 > ir1, ir2, ir3, wvp, vis, cld(구름유무), ca(운량), cth(운고), ct(운형), fog(안개), ai(황사지수), lst(지면온도), sst(해수면온도), s01(1일평균 해수면온도), s05(5일평균 해 수면온도), s10(10일평균 해수면온도), ins(일사량) < 히마와리 > ch?? (01~16)
lon	경도	degree
lat	위도	degree
stn	지점번호	여러 지점인 경우, 콤마(,)로 구분하여 기술 99999(AWS전체지점), 99998(기상관서전체), 99997(북한지점전체)
help	도움말	1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
TM	천리안 위상 관측시각 (KST)	IR1	IR1 체널의 온도값 (C)
IR2	IR2 체널의 온도값 (C)	IR3	SW 체널의 온도값 (C)
WVP	WV 체널의 온도값 (C)	VIS	VIS 체널의 알베도값 (%)
STN	지점번호	CH??	?? 채널의 온도값(C) 또는 알베도값(%)

1.3 여러 지점

https://apihub.kma.go.kr/api/typ01/url/hima_stns_vars.php?tm1=202302190900&tm2=202302191300&stn=108,95&help=1&authKey={인증키입력}

요청인자

데이터 기본 정보
인자명	의미	설명
tm1	년월일시분(KST)	시작 시각
tm2	년월일시분(KST)	종료 시각
obs	채널변수	< 천리안 > ir1, ir2, ir3, wvp, vis, cld(구름유무), ca(운량), cth(운고), ct(운형), fog(안개), ai(황사지수), lst(지면온도), sst(해수면온도), s01(1일평균 해수면온도), s05(5일평균 해 수면온도), s10(10일평균 해수면온도), ins(일사량) < 히마와리 > ch?? (01~16)
lon	경도	degree
lat	위도	degree
stn	지점번호	여러 지점인 경우, 콤마(,)로 구분하여 기술 99999(AWS전체지점), 99998(기상관서전체), 99997(북한지점전체)
help	도움말	1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
TM	천리안 위상 관측시각 (KST)	IR1	IR1 체널의 온도값 (C)
IR2	IR2 체널의 온도값 (C)	IR3	SW 체널의 온도값 (C)
WVP	WV 체널의 온도값 (C)	VIS	VIS 체널의 알베도값 (%)
STN	지점번호	CH??	?? 채널의 온도값(C) 또는 알베도값(%)