융합기상

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

api 상세
개요

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

요소

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

지점

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

보유기간

- 1997. 1. 1. ~
※ 고해상도 격자자료 적설(적설, 일신적설, 3시간신적설, 24시간신적설) 2020. 1. 1 ~

생산주기

매정시 기준 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월) 적설자료 미생산

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

요청인자

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

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

요청인자

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

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

lat

위도

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

요청인자

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

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

요청인자

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

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

요청인자

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

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

격자자료 경도

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

요청인자

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

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

요청인자

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

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

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

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

요청인자

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

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

요청인자

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

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

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

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

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

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

요청인자

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

var

변수

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

tm

연도

조회할 연(YYYY)

admcode

행정구역코드(8자리)

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

lat1

위도(degree)

한 지점의 위도

lon1

경도(degree)

한 지점의 경도

lat2

위도(degree)

다른 한 지점의 위도

lon2

경도(degree)

다른 한 지점의 경도