융합기상

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

api 상세
개요

(고해상도 격자자료) 기상청 및 공공기관(산림청, 농진청 등) AWS, 해양기상부이, 등표관측자료에 지형효과를 반영한 3차원 객관분석 기법을 적용하여 생산한 분석자료입니다.
※ 해당 자료는 관측자료를 분석하여 생산한 데이터로 실제 관측과는 차이가 있을 수 있으며, 향후 분석기법 및 격자해상도가 변경될 수 있습니다.

(천리안2A호 인공지능 기반 한반도 일사량 자료) 신재생에너지 등 신산업 지원을 위해 천리안2A호 데이터와 인공지능기법인 합성곱 인공신경망(CNN)을 활용하여 산출한 일사량 데이터입니다.

요소

(고해상도 격자자료)
- (3차원 분석)기온, 이슬점온도, 습도, 풍속, 현지기압, 체감온도, 적설, 일신적설, 3시간 신적설, 24시간 신적설
- (2차원 분석)해면기압, 강수유무, 강수량(15분, 60분, 일), 시정

(천리안2A호 인공지능 기반 한반도 일사량 자료) 전천일사량(MJ/㎡)

지점

(고해상도 격자자료) 남한지역 지상+연해(500m 해상도)
※ 해양관측자료의 경우 기준시각 기준 15분 과거자료까지 활용

(천리안2A호 인공지능 기반 한반도 일사량 자료) 한반도(2km 해상도)

보유기간

(고해상도 격자자료) 1997. 1. 1. ~
※ 고해상도 격자자료 적설(적설, 일신적설, 3시간신적설, 24시간신적설) 2020. 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분

(고해상도 격자자료 적설) 매정시 기준 30분 간격
- (2020.1.1 ~ ) 00분, 30분
- 10월 ~ 5월 / 여름철(6월 ~ 9월) 적설자료 미생산

(천리안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=j6VB3Gz5RJmlQdxs-USZOQ

요청인자

데이터 기본 정보
인자명 의미 설명

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(체감온도), sd_tot(적설), sd_day(일신적설), sd_3hr(3시간신적설), sd_24h(24시간신적설)

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=j6VB3Gz5RJmlQdxs-USZOQ

요청인자

데이터 기본 정보
인자명 의미 설명

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(체감온도), sd_tot(적설), sd_day(일신적설), sd_3hr(3시간신적설), sd_24h(24시간신적설)

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=j6VB3Gz5RJmlQdxs-USZOQ

요청인자

데이터 기본 정보
인자명 의미 설명

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(체감온도), sd_tot(적설), sd_day(일신적설), sd_3hr(3시간신적설), sd_24h(24시간신적설)

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=j6VB3Gz5RJmlQdxs-USZOQ

요청인자

데이터 기본 정보
인자명 의미 설명

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(시정), sd_tot(적설), sd_day(일신적설), sd_3hr(3시간신적설), sd_24h(24시간신적설)

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=j6VB3Gz5RJmlQdxs-USZOQ

요청인자

데이터 기본 정보
인자명 의미 설명

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(체감온도), sd_tot(적설), sd_day(일신적설), sd_3hr(3시간신적설), sd_24h(24시간신적설)

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=j6VB3Gz5RJmlQdxs-USZOQ

격자자료 경도

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

요청인자

데이터 기본 정보
인자명 의미 설명

latlon

위경도 선택

lat(위도)

2. 고해상도 격자자료(500m 해상도) 활용 격자통계자료 조회

< 제공기간: 1997.1.1.~ >
* 해당 자료는 관측데이터를 분석하여 생산한 관측격자데이터를 활용하여 산출한 격자통계데이터이므로 실제관측지점의 통계데이터와 차이가 있을 수 있습니다.
* 격자통계데이터의 오차수준을 참고하여 활용하시기 바랍니다. (연평균기온) 0.4~0.6, (연평균이슬점온도) 0.4~3.0, (연평균해면기압) 0.2~11.0, (연평균상대습도) 2.2~5.1

호출URL정보

특정지점(단일 위경도) 연평균 격자통계값 조회

https://apihub.kma.go.kr/api/typ01/url/sfc_obs_nc_sts_pt_api.php?var=ta_avg&tm1=2022&tm2=2023&lat=38.249774&lon=128.5643&disp=0&authKey=j6VB3Gz5RJmlQdxs-USZOQ

요청인자

데이터 기본 정보
인자명 의미 설명

var

변수

ta_avg(평균기온), td_avg(평균이슬점온도), ps_avg(평균해면기압), hm_avg(평균습도)

tm1

연도

조회할 시작 연(YYYY)

tm2

연도

조회할 종료 연(YYYY)

lat

위도(degree)

특정 지점의 위도

lon

경도(degree)

특정 지점의 경도

disp

표출형태

0(ASCII, default)

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

tm

조회 연도

ta_avg

평균기온(℃)

td_avg

평균이슬점온도(℃)

ps_avg

평균해면기압(hPa)

hm_avg

평균상대습도(%)

호출URL정보

행정구역 연평균 격자통계값 조회

https://apihub.kma.go.kr/api/typ01/url/sfc_obs_nc_sts_area_api.php?var=ta_avg&tm1=2022&tm2=2023&admcode=11000000&disp=0&reduce=0&authKey=j6VB3Gz5RJmlQdxs-USZOQ

특정구역 연평균 격자통계값 조회

https://apihub.kma.go.kr/api/typ01/url/sfc_obs_nc_sts_area_api.php?var=ta_avg&tm1=2022&tm2=2023&lat1=38.361&lon1=127.387&lat2=36.842&lon2=127.905&disp=0&reduce=0&authKey=j6VB3Gz5RJmlQdxs-USZOQ

요청인자

데이터 기본 정보
인자명 의미 설명

var

변수

ta_avg(평균기온), td_avg(평균이슬점온도), ps_avg(평균해면기압), hm_avg(평균습도)

tm1

연도

조회할 시작 연(YYYY)

tm2

연도

조회할 종료 연(YYYY)

admcode

행정구역코드(8자리)

행정구역코드 8자리(읍/면/동)

lat1

위도(degree)

한 지점의 위도

lon1

경도(degree)

한 지점의 경도

lat2

위도(degree)

다른 한 지점의 위도

lon2

경도(degree)

다른 한 지점의 경도

disp

표출형태

0(ASCII, default)

reduce

표출형태

0(영역내의 모든 위경도 좌표와 격자값, default), 1(영역내 모든 격자값의 평균값)

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

lat

위도(deg)

lon

경도(deg)

tm

조회 연도

ta_avg

평균기온(℃)

td_avg

평균이슬점온도(℃)

ps_avg

평균해면기압(hPa)

hm_avg

평균상대습도(%)

호출URL정보

전체영역 연평균 격자통계값 파일다운로드(NetCDF4)

https://apihub.kma.go.kr/api/typ01/url/sfc_grid_nc_sts_down.php?var=ta_avg&tm=2023&authKey=j6VB3Gz5RJmlQdxs-USZOQ

요청인자

데이터 기본 정보
인자명 의미 설명

var

변수

ta_avg(평균기온), td_avg(평균이슬점온도), ps_avg(평균해면기압), hm_avg(평균습도)

tm

연도

조회할 연(YYYY)

호출URL정보

행정구역 연평균 격자통계 분포도이미지

https://apihub.kma.go.kr/api/typ01/url/sfc_obs_nc_sts_img.php?var=ta_avg&tm=2023&admcode=11000000&authKey=j6VB3Gz5RJmlQdxs-USZOQ

전체영역 연평균 격자통계 분포도이미지

https://apihub.kma.go.kr/api/typ01/url/sfc_obs_nc_sts_img.php?var=ta_avg&tm=2023&authKey=j6VB3Gz5RJmlQdxs-USZOQ

특정구역 연평균 격자통계 분포도이미지

https://apihub.kma.go.kr/api/typ01/url/sfc_obs_nc_sts_img.php?var=ta_avg&tm=2023&lat1=38.151&lon1=127.942&lat2=38.224&lon2=127.842&authKey=j6VB3Gz5RJmlQdxs-USZOQ

요청인자

데이터 기본 정보
인자명 의미 설명

var

변수

ta_avg(평균기온), td_avg(평균이슬점온도), ps_avg(평균해면기압), hm_avg(평균습도)

tm

연도

조회할 연(YYYY)

admcode

행정구역코드(8자리)

행정구역코드 8자리(읍/면/동)
※ 행정구역코드 인자가 없으면 전체 영역에 대한 분포도 표시

lat1

위도(degree)

한 지점의 위도

lon1

경도(degree)

한 지점의 경도

lat2

위도(degree)

다른 한 지점의 위도

lon2

경도(degree)

다른 한 지점의 경도

3. 천리안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=j6VB3Gz5RJmlQdxs-USZOQ

요청인자

데이터 기본 정보
인자명 의미 설명

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=j6VB3Gz5RJmlQdxs-USZOQ

요청인자

데이터 기본 정보
인자명 의미 설명

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=j6VB3Gz5RJmlQdxs-USZOQ

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

요청인자

데이터 기본 정보
인자명 의미 설명

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