수치모델

통합모델(UM)과 한국형수치예보모델(KIM)로 생산한 전구·지역·국지예보모델 예측데이터를 영상자료와 데이터파일로 제공합니다.

api 상세
개요

(전구) 전지구 예보모델(GDAPS, Global Data Assimilation and Prediction System)은 전지구 날씨 예측, 동네예보, 중기예보 등을 목적으로 영국 통합모델(UM)을 기반 구축된 수치예보시스템입니다.
6시간 주기 순환예측에 필요한 각종 배경장을 생산하기 위한 일 4회의 15시간 예측을 수행하며, 일 1회 06UTC에는 해수면온도, 해빙자료 및 동서평균 오존량을 갱신하기 위한 배경장 갱신과정을 별도로 수행합니다. 현재 기상청에서는 GDAPS 예측자료를 GRIB2형식과 이미지형태로 생산, 제공하고 있습니다.

(지역) GDAPS 예측자료에서 동아시아 영역의 자료만 추출하여 GRIB2형식과 이미지형태로 생산, 제공하고 있습니다.

(국지) 국지예보모델(LDAPS, Local Data Assimilation and Prediction System)은 3시간 간격으로 전지구 예보모델로부터 경계장을 제공받아 1일 4회 예측을 수행하는 수치예보 시스템입니다.
3차원 변분자료 동화 기법을 이용하여 각각의 자체 분석-예측 순환 체계로 운영되고 있으며, 주로 한반도 날씨 예측에 활용됩니다. 현재 기상청에서는 LDAPS 예측자료를 GRIB2형식과 이미지형태로 생산, 제공하고 있습니다.
요 소

(전구, 지역) 등압면, 단일면 요소
(국지) 등압면, 단일면, 모델면
해상도

기간에 따라 해상도가 상이함(20xx.xx.xx. 기준)

(전구)
ㆍ (공간) 수평분해능 : 10km/ 연직층수 : 70층
ㆍ (시간) 288시간 예측(00, 12UTC)/ 87시간 예측(06, 18UTC)

(지역)
ㆍ (공간) 수평분해능 : 12km/ 연직층수 : 70층
ㆍ (시간) 87시간 예측(00, 06, 12, 18UTC)

(국지)
ㆍ (공간) 수평분해능 : 1.5km/ 연직층수 : 70층
ㆍ (시간) 36시간 예측(00, 06, 12, 18UTC)
보유기간

(전구) 2011년 5월 ~ 현재
(지역) 2010년 3월 ~ 현재
(국지) 2012년 5월 ~ 현재
생산주기

일 4회(00, 06, 12, 18UTC)

1. 수치모델 경량화 다운로드(예측시간+변수+고도별)

수치모델 GRIB 변수 코드 등 참고자료

호출URL정보

UM모델 다운로드

https://apihub.kma.go.kr/api/typ06/url/nwp_vars_down.php?nwp=g128&sub=pres&vars=tmpr&pres=850&tmfc=202108101200&ef=24&dataType=TEXT&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

nwp

UM모델

g128(UM전구), g768(UM전구), g512(UM전구),
g120(UM지역,20190401~), r120(UM지역,~20190331), l015(UM국지)

sub

파일구분

"pres(등압면), unis(단일면) ... UM모델만
isen(등온위면) ... UM모델만
없으면 해당모델 전체"

tmfc

기준시각

년월일, 년월일시(UTC)

ef

예측시각

기준시각에서부터의 예측시간(0~)

dataType

저장포맷

GRIB, BIN(이진), TEXT(csv)

authKey

인증키

발급된 API 인증키

2. 통합모델(UM) 자료 조회

통합모델 참고자료

앙상블통합모델 참고자료

호출URL정보

해당 고도의 2차원 자료

https://apihub.kma.go.kr/api/typ06/cgi-bin/url/nph-um_grib_xy_txt1?group=UMGL&nwp=N512&data=P&varn=3005&level=850&tmfc=2016102800&hf=24&disp=A&authKey=FyIoXmJzSiWiKF5icxolng

일부 격자영역만

https://apihub.kma.go.kr/api/typ06/cgi-bin/url/nph-um_grib_xy_txt1?group=UMGL&nwp=N512&data=P&varn=3005&level=850&map=S&sub=300,300,600,500&sm=9&tmfc=2016102800&hf=24&disp=A&authKey=FyIoXmJzSiWiKF5icxolng

UMRG영역의 층후

https://apihub.kma.go.kr/api/typ06/cgi-bin/url/nph-um_grib_xy_txt1?group=UMGL&nwp=N512&data=P&varn=3012&level=1000,700&map=R&sm=9&tmfc=2016102800&hf=24&disp=A&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

group

모델 구분

UMGL(전지구모델:30km), UMRG(아시아모델:12km), UMKR(한반도모델:1.5km)

nwp

모델기반
종류

N128(UMGL만) : 2018.06.09~
N768(UMGL만) : 2016.06.29~
N512 : 2011.05.15~
N320 : 2010.03.16~2012.01.31

data

자료 종류

P(등압면), U(단일면)

varn

변수종류

D*100000 + C*1000 + P
- D : GRIB.sec0.discipline : 자료의 종류
- C : GRIB.sec4.parameter category : 변수 그룹
- P : GRIB.sec4.parameter number : 변수 번호

level

고도

등압면자료의 경우, 등압면고도(hPa), 0.01hPa까지 인식 / 예) 0.04 등
단일면의 경우도 토양면처럼 층이 있는 경우는 값이 있어야 됨
격자점 자료 조회의 경우에 level값이 있으면 해당 고도값만 표출, 없으면 각 고도의 값을 모두 표출
층후는 1000,700 과 같이 2개 층을 표시

map

사용 영역

F: 자료 전체 영역
S: 일부 격자 영역만 추출
R: UMRG영역에 대하여 LCC 변환하여 12km 간격으로 제공 (전지구모델인 경우만 적용)

sub

격자영역

map=S 인 경우, 추출할 격자 영역을 표시
표시방법은 sub=x_min,y_min,x_max,ymax 왼쪽아래 격자점 [x_min, y_min]에서 오른쪽 위 격자점 [x_max, y_max] 까지를 의미
최소 격자점은 [1,1] 임

tmfc

분석시간

년월일시(UTC)

hf

예측시간

시간(hour) (예: 24 = +24H)

ef

예측시간

예측시작,예측종료,예측시간간격
(예: 0,72,3 은 +0H에서 +72H까지 3H간격으로)
없으면 전체 자료

X

X축-격자점위치

1부터 시작

Y

Y축-격자점위치

1부터 시작

lon

경도

가장 가까운 격자점 값을 사용

lat

위도

가장 가까운 격자점 값을 사용

disp

제공형태

A(ASCII) - 없으면 A, 격자점수 표출후 자료 출력
B(Binary) - 격자점수(ni*nj)를 4byte 정수로 출력후, 자료를 실수로 출력
G(GrDAS Binary) - 자료만 출력

mode

설정

정보표출에서 0(요약), 1(헤더정보 포함)

help

도움말

1(도움말 정보 표시)

authKey

인증키

발급된 API 인증키

출력결과

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

TMFC

기준시각 년월일시 (UTC)

TMEF

예측시각 년월일시 (UTC)

VARN

변수번호

LEVEL

고도 (Pa)

VALUS

값

호출URL정보

단면도

https://apihub.kma.go.kr/api/typ06/cgi-bin/url/nph-um_grib_xz_txt1?group=UMGL&nwp=N512&data=P&varn=3005&lvl_lst=&map=F&tmfc=2016102800&hf=24&lon1=100.5&lat1=10.6&lon2=140.8&lat2=60.3&disp=A&authKey=FyIoXmJzSiWiKF5icxolng

특정 고도의 단면값

https://apihub.kma.go.kr/api/typ06/cgi-bin/url/nph-um_grib_xz_txt1?group=UMGL&nwp=N512&data=P&varn=3005&lvl_lst=1000,500&map=F&tmfc=2016102800&hf=24&lon1=100.5&lat1=10.6&lon2=140.8&lat2=60.3&disp=A&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

group

모델 구분

UMGL(전지구모델:30km), UMRG(아시아모델:12km), UMKR(한반도모델:1.5km)

nwp

모델기반
종류

N128(UMGL만) : 2018.06.09~
N768(UMGL만) : 2016.06.29~
N512 : 2011.05.15~
N320 : 2010.03.16~2012.01.31

data

자료 종류

P(등압면), U(단일면)

varn

변수종류

D*100000 + C*1000 + P
- D : GRIB.sec0.discipline : 자료의 종류
- C : GRIB.sec4.parameter category : 변수 그룹
- P : GRIB.sec4.parameter number : 변수 번호

level

고도

등압면자료의 경우, 등압면고도(hPa), 0.01hPa까지 인식 / 예) 0.04 등
단일면의 경우도 토양면처럼 층이 있는 경우는 값이 있어야 됨
격자점 자료 조회의 경우에 level값이 있으면 해당 고도값만 표출, 없으면 각 고도의 값을 모두 표출
층후는 1000,700 과 같이 2개 층을 표시

map

사용 영역

F: 자료 전체 영역
S: 일부 격자 영역만 추출
R: UMRG영역에 대하여 LCC 변환하여 12km 간격으로 제공 (전지구모델인 경우만 적용)

sub

격자영역

map=S 인 경우, 추출할 격자 영역을 표시
표시방법은 sub=x_min,y_min,x_max,ymax 왼쪽아래 격자점 [x_min, y_min]에서 오른쪽 위 격자점 [x_max, y_max] 까지를 의미
최소 격자점은 [1,1] 임

tmfc

분석시간

년월일시(UTC)

hf

예측시간

시간(hour) (예: 24 = +24H)

ef

예측시간

예측시작,예측종료,예측시간간격
(예: 0,72,3 은 +0H에서 +72H까지 3H간격으로)
없으면 전체 자료

X

X축-격자점위치

1부터 시작

Y

Y축-격자점위치

1부터 시작

lon

경도

가장 가까운 격자점 값을 사용

lat

위도

가장 가까운 격자점 값을 사용

disp

제공형태

A(ASCII) - 없으면 A, 격자점수 표출후 자료 출력
B(Binary) - 격자점수(ni*nj)를 4byte 정수로 출력후, 자료를 실수로 출력
G(GrDAS Binary) - 자료만 출력

mode

설정

정보표출에서 0(요약), 1(헤더정보 포함)

help

도움말

1(도움말 정보 표시)

authKey

인증키

발급된 API 인증키

출력결과

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

TMFC

기준시각 년월일시 (UTC)

TMEF

예측시각 년월일시 (UTC)

VARN

변수번호

LEVEL

고도 (Pa)

VALUS

값

호출URL정보

임의 격자점의 자료

https://apihub.kma.go.kr/api/typ06/cgi-bin/url/nph-um_grib_pt_txt1?group=UMGL&nwp=N128&data=P&varn=0,3005&tmfc=2021102800&hf=24&X=400&Y=500&disp=A&help=1&authKey=FyIoXmJzSiWiKF5icxolng

임의 고도, 임의 격자점의 자료

https://apihub.kma.go.kr/api/typ06/cgi-bin/url/nph-um_grib_pt_txt1?group=UMGL&nwp=N768&data=P&varn=3005&tmfc=2016102800&hf=24&level=850,700&X=400&Y=500&disp=A&help=1&authKey=FyIoXmJzSiWiKF5icxolng

임의 위경도의 자료

https://apihub.kma.go.kr/api/typ06/cgi-bin/url/nph-um_grib_pt_txt1?group=UMGL&nwp=N512&data=P&varn=0,3005&tmfc=2016102800&hf=24&lon=125.5&lat=37.5&disp=A&help=1&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

group

모델 구분

UMGL(전지구모델:30km), UMRG(아시아모델:12km), UMKR(한반도모델:1.5km)

nwp

모델기반
종류

N128(UMGL만) : 2018.06.09~
N768(UMGL만) : 2016.06.29~
N512 : 2011.05.15~
N320 : 2010.03.16~2012.01.31

data

자료 종류

P(등압면), U(단일면)

varn

변수종류

D*100000 + C*1000 + P
- D : GRIB.sec0.discipline : 자료의 종류
- C : GRIB.sec4.parameter category : 변수 그룹
- P : GRIB.sec4.parameter number : 변수 번호

level

고도

등압면자료의 경우, 등압면고도(hPa), 0.01hPa까지 인식 / 예) 0.04 등
단일면의 경우도 토양면처럼 층이 있는 경우는 값이 있어야 됨
격자점 자료 조회의 경우에 level값이 있으면 해당 고도값만 표출, 없으면 각 고도의 값을 모두 표출
층후는 1000,700 과 같이 2개 층을 표시

map

사용 영역

F: 자료 전체 영역
S: 일부 격자 영역만 추출
R: UMRG영역에 대하여 LCC 변환하여 12km 간격으로 제공 (전지구모델인 경우만 적용)

sub

격자영역

map=S 인 경우, 추출할 격자 영역을 표시
표시방법은 sub=x_min,y_min,x_max,ymax 왼쪽아래 격자점 [x_min, y_min]에서 오른쪽 위 격자점 [x_max, y_max] 까지를 의미
최소 격자점은 [1,1] 임

tmfc

분석시간

년월일시(UTC)

hf

예측시간

시간(hour) (예: 24 = +24H)

ef

예측시간

예측시작,예측종료,예측시간간격
(예: 0,72,3 은 +0H에서 +72H까지 3H간격으로)
없으면 전체 자료

X

X축-격자점위치

1부터 시작

Y

Y축-격자점위치

1부터 시작

lon

경도

가장 가까운 격자점 값을 사용

lat

위도

가장 가까운 격자점 값을 사용

disp

제공형태

A(ASCII) - 없으면 A, 격자점수 표출후 자료 출력
B(Binary) - 격자점수(ni*nj)를 4byte 정수로 출력후, 자료를 실수로 출력
G(GrDAS Binary) - 자료만 출력

mode

설정

정보표출에서 0(요약), 1(헤더정보 포함)

help

도움말

1(도움말 정보 표시)

authKey

인증키

발급된 API 인증키

출력결과

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

TMFC

기준시각 년월일시 (UTC)

TMEF

예측시각 년월일시 (UTC)

VARN

변수번호

LEVEL

고도 (Pa)

VALUS

값

호출URL정보

임의 격자점의 시계열자료(발표시간 기준)

https://apihub.kma.go.kr/api/typ06/url/um_grib_pt_tmfc.php?group=UMGL&nwp=N512&data=P&varn=0&tmfc=2016102800&ef=0,120,3&X=300&Y=200&level=850&help=1&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

group

모델 구분

UMGL(전지구모델:30km), UMRG(아시아모델:12km), UMKR(한반도모델:1.5km)

nwp

모델기반
종류

N128(UMGL만) : 2018.06.09~
N768(UMGL만) : 2016.06.29~
N512 : 2011.05.15~
N320 : 2010.03.16~2012.01.31

data

자료 종류

P(등압면), U(단일면)

varn

변수종류

D*100000 + C*1000 + P
- D : GRIB.sec0.discipline : 자료의 종류
- C : GRIB.sec4.parameter category : 변수 그룹
- P : GRIB.sec4.parameter number : 변수 번호

level

고도

등압면자료의 경우, 등압면고도(hPa), 0.01hPa까지 인식 / 예) 0.04 등
단일면의 경우도 토양면처럼 층이 있는 경우는 값이 있어야 됨
격자점 자료 조회의 경우에 level값이 있으면 해당 고도값만 표출, 없으면 각 고도의 값을 모두 표출
층후는 1000,700 과 같이 2개 층을 표시

map

사용 영역

F: 자료 전체 영역
S: 일부 격자 영역만 추출
R: UMRG영역에 대하여 LCC 변환하여 12km 간격으로 제공 (전지구모델인 경우만 적용)

sub

격자영역

map=S 인 경우, 추출할 격자 영역을 표시
표시방법은 sub=x_min,y_min,x_max,ymax 왼쪽아래 격자점 [x_min, y_min]에서 오른쪽 위 격자점 [x_max, y_max] 까지를 의미
최소 격자점은 [1,1] 임

tmfc

분석시간

년월일시(UTC)

hf

예측시간

시간(hour) (예: 24 = +24H)

ef

예측시간

예측시작,예측종료,예측시간간격
(예: 0,72,3 은 +0H에서 +72H까지 3H간격으로)
없으면 전체 자료

X

X축-격자점위치

1부터 시작

Y

Y축-격자점위치

1부터 시작

lon

경도

가장 가까운 격자점 값을 사용

lat

위도

가장 가까운 격자점 값을 사용

disp

제공형태

A(ASCII) - 없으면 A, 격자점수 표출후 자료 출력
B(Binary) - 격자점수(ni*nj)를 4byte 정수로 출력후, 자료를 실수로 출력
G(GrDAS Binary) - 자료만 출력

mode

설정

정보표출에서 0(요약), 1(헤더정보 포함)

help

도움말

1(도움말 정보 표시)

authKey

인증키

발급된 API 인증키

출력결과

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

TMFC

기준시각 년월일시 (UTC)

TMEF

예측시각 년월일시 (UTC)

VARN

변수번호

LEVEL

고도 (Pa)

VALUS

값

호출URL정보

임의 격자점의 시계열자료(발효시간 기준)

https://apihub.kma.go.kr/api/typ06/url/um_grib_pt_tmef.php?group=UMGL&nwp=N512&data=P&varn=0&tmef=2016102800&lon=125.5&lat=37.5&level=850&help=1&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

group

모델 구분

UMGL(전지구모델:30km), UMRG(아시아모델:12km), UMKR(한반도모델:1.5km)

nwp

모델기반
종류

N128(UMGL만) : 2018.06.09~
N768(UMGL만) : 2016.06.29~
N512 : 2011.05.15~
N320 : 2010.03.16~2012.01.31

data

자료 종류

P(등압면), U(단일면)

varn

변수종류

D*100000 + C*1000 + P
- D : GRIB.sec0.discipline : 자료의 종류
- C : GRIB.sec4.parameter category : 변수 그룹
- P : GRIB.sec4.parameter number : 변수 번호

level

고도

등압면자료의 경우, 등압면고도(hPa), 0.01hPa까지 인식 / 예) 0.04 등
단일면의 경우도 토양면처럼 층이 있는 경우는 값이 있어야 됨
격자점 자료 조회의 경우에 level값이 있으면 해당 고도값만 표출, 없으면 각 고도의 값을 모두 표출
층후는 1000,700 과 같이 2개 층을 표시

map

사용 영역

F: 자료 전체 영역
S: 일부 격자 영역만 추출
R: UMRG영역에 대하여 LCC 변환하여 12km 간격으로 제공 (전지구모델인 경우만 적용)

sub

격자영역

map=S 인 경우, 추출할 격자 영역을 표시
표시방법은 sub=x_min,y_min,x_max,ymax 왼쪽아래 격자점 [x_min, y_min]에서 오른쪽 위 격자점 [x_max, y_max] 까지를 의미
최소 격자점은 [1,1] 임

tmfc

분석시간

년월일시(UTC)

hf

예측시간

시간(hour) (예: 24 = +24H)

ef

예측시간

예측시작,예측종료,예측시간간격
(예: 0,72,3 은 +0H에서 +72H까지 3H간격으로)
없으면 전체 자료

X

X축-격자점위치

1부터 시작

Y

Y축-격자점위치

1부터 시작

lon

경도

가장 가까운 격자점 값을 사용

lat

위도

가장 가까운 격자점 값을 사용

disp

제공형태

A(ASCII) - 없으면 A, 격자점수 표출후 자료 출력
B(Binary) - 격자점수(ni*nj)를 4byte 정수로 출력후, 자료를 실수로 출력
G(GrDAS Binary) - 자료만 출력

mode

설정

정보표출에서 0(요약), 1(헤더정보 포함)

help

도움말

1(도움말 정보 표시)

authKey

인증키

발급된 API 인증키

출력결과

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

TMFC

기준시각 년월일시 (UTC)

TMEF

예측시각 년월일시 (UTC)

VARN

변수번호

LEVEL

고도 (Pa)

VALUS

값

호출URL정보

해당 고도,변수의 GRIB파일 다운로드

https://apihub.kma.go.kr/api/typ06/url/nwp_grib_down.php?group=UMGL&nwp=N512&data=P&varn=3005&level=850&tmfc=2016102800&hf=24&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

group

모델 구분

UMGL(전지구모델:30km), UMRG(아시아모델:12km), UMKR(한반도모델:1.5km)

nwp

모델기반
종류

N128(UMGL만) : 2018.06.09~
N768(UMGL만) : 2016.06.29~
N512 : 2011.05.15~
N320 : 2010.03.16~2012.01.31

data

자료 종류

P(등압면), U(단일면)

varn

변수종류

D*100000 + C*1000 + P
- D : GRIB.sec0.discipline : 자료의 종류
- C : GRIB.sec4.parameter category : 변수 그룹
- P : GRIB.sec4.parameter number : 변수 번호

level

고도

등압면자료의 경우, 등압면고도(hPa), 0.01hPa까지 인식 / 예) 0.04 등
단일면의 경우도 토양면처럼 층이 있는 경우는 값이 있어야 됨
격자점 자료 조회의 경우에 level값이 있으면 해당 고도값만 표출, 없으면 각 고도의 값을 모두 표출
층후는 1000,700 과 같이 2개 층을 표시

map

사용 영역

F: 자료 전체 영역
S: 일부 격자 영역만 추출
R: UMRG영역에 대하여 LCC 변환하여 12km 간격으로 제공 (전지구모델인 경우만 적용)

sub

격자영역

map=S 인 경우, 추출할 격자 영역을 표시
표시방법은 sub=x_min,y_min,x_max,ymax 왼쪽아래 격자점 [x_min, y_min]에서 오른쪽 위 격자점 [x_max, y_max] 까지를 의미
최소 격자점은 [1,1] 임

tmfc

분석시간

년월일시(UTC)

hf

예측시간

시간(hour) (예: 24 = +24H)

ef

예측시간

예측시작,예측종료,예측시간간격
(예: 0,72,3 은 +0H에서 +72H까지 3H간격으로)
없으면 전체 자료

X

X축-격자점위치

1부터 시작

Y

Y축-격자점위치

1부터 시작

lon

경도

가장 가까운 격자점 값을 사용

lat

위도

가장 가까운 격자점 값을 사용

disp

제공형태

A(ASCII) - 없으면 A, 격자점수 표출후 자료 출력
B(Binary) - 격자점수(ni*nj)를 4byte 정수로 출력후, 자료를 실수로 출력
G(GrDAS Binary) - 자료만 출력

mode

설정

정보표출에서 0(요약), 1(헤더정보 포함)

help

도움말

1(도움말 정보 표시)

authKey

인증키

발급된 API 인증키

출력결과

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

TMFC

기준시각 년월일시 (UTC)

TMEF

예측시각 년월일시 (UTC)

VARN

변수번호

LEVEL

고도 (Pa)

VALUS

값

3. 한국형수치예보모델(KIM) 자료 조회

한국형 수치모델(KIM) 변수 참고자료

한국형 수치모델 변수별 설명 참고자료

호출URL정보

전체영역

https://apihub.kma.go.kr/api/typ06/cgi-bin/url/nph-kim_nc_xy_txt1?group=KIMG&nwp=NE36&data=U&name=t2m&map=F&tmfc=2024090100&hf=0&disp=A&help=1&level=0&authKey=FyIoXmJzSiWiKF5icxolng

일부 격자영역

https://apihub.kma.go.kr/api/typ06/cgi-bin/url/nph-kim_nc_xy_txt1?group=KIMG&nwp=NE36&data=P&name=u&map=S&sub=300,300,600,500&sm=0&tmfc=2024090100&hf=0&disp=A&help=1&level=500&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

group

모델 구분

KIMG

nwp

모델기반
종류

NE36

data

자료 종류

P(등압면), U(단일면), A(단일면 강수/해면기압)

name

변수명

테이블 하단 참고 참조(한국형 수치모델(KIM) 변수정보)

level

고도

등압면자료의 경우, 등압면고도(hPa)로 입력
단일면의 경우도 토양면처럼 층이 있는 경우는 값이 있어야 됨
층후는 1000,700 과 같이 2개 층을 표시
격자점 자료 조회의 경우에 level값이 있으면 해당 고도값만 표출, 없으면 각 고도의 값을 모두 표출

map

사용 영역

F: 자료 전체 영역
S: 일부 격자 영역만 추출
R: UMRG영역에 대하여 LCC 변환하여 12km 간격으로 제공

sub

격자영역

map=S 인 경우, 추출할 격자 영역을 표시
표시방법은 sub=x_min,y_min,x_max,ymax 왼쪽아래 격자점 [x_min, y_min]에서 오른쪽 위 격자점 [x_max, y_max] 까지를 의미
최소 격자점은 [1,1] 임

tmfc

분석시간

년월일시(UTC)

hf

예측시각

시간(hour) (예: 24 = +24H)

authKey

인증키

발급된 API 인증키

호출URL정보

임의 격자점의 자료

https://apihub.kma.go.kr/api/typ06/cgi-bin/url/nph-kim_nc_pt_txt1?group=KIMG&nwp=NE36&data=P&name=T,q&tmfc=2024090100&hf=0&disp=A&help=1&X=50&Y=100&authKey=FyIoXmJzSiWiKF5icxolng

임의 위경도의 자료

https://apihub.kma.go.kr/api/typ06/cgi-bin/url/nph-kim_nc_pt_txt1?group=KIMG&nwp=NE36&data=P&name=u,w&tmfc=2024090100&hf=0&disp=A&help=1&lat=38&lon=150&disp=A&help=1&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

group

모델 구분

KIMG

nwp

모델기반
종류

NE36

data

자료 종류

P(등압면), U(단일면), A(단일면 강수/해면기압)

name

변수명

테이블 하단 참고 참조(한국형 수치모델(KIM) 변수정보)

level

고도

등압면자료의 경우, 등압면고도(hPa)로 입력
단일면의 경우도 토양면처럼 층이 있는 경우는 값이 있어야 됨
층후는 1000,700 과 같이 2개 층을 표시
격자점 자료 조회의 경우에 level값이 있으면 해당 고도값만 표출, 없으면 각 고도의 값을 모두 표출

tmfc

분석시간

년월일시(UTC)

hf

예측시각

시간(hour) (예: 24 = +24H)

X

격자번호(동서)

임의 격자점을 추출하는 경우 사용

Y

격자번호(남북)

임의 격자점을 추출하는 경우 사용

lat

위도

임의 위경도를 추출하는 경우

lon

경도

임의 위경도를 추출하는 경우

help

도움말

1 이면 도움말 추가 (0 이거나 없으면 없음)

authKey

인증키

발급된 API 인증키

4. 통합모델(UM) 지역·국지예보모델(한반도·행정구역) 조회

행정구역코드 격자 정보 참고자료

API 활용가이드 참고자료

호출URL정보

국지예보모델단일면한반도조회

https://apihub.kma.go.kr/api/typ02/openApi/NwpModelInfoService/getLdapsUnisAll?pageNo=1&numOfRows=10&dataType=XML&baseTime=202001140300&leadHour=1&dataTypeCd=Temp&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)Default: XML

baseTime

발표시간

발표시간(참고 참조)

leadHour

선행시간

선행시간(참고 참조)

dataTypeCd

데이터 타입

데이터 타입(참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

baseTime

발표시간

fcstTime

예측시간

gridKm

격자크기

xdim

X 좌표 개수

ydim

Y 좌표 개수

x0

X 좌표 기준점

y0

Y 좌표 기준점

unit

단위

value

값

호출URL정보

국지예보모델단일면행정구역조회

https://apihub.kma.go.kr/api/typ02/openApi/NwpModelInfoService/getLdapsUnisArea?pageNo=1&numOfRows=10&dataType=XML&baseTime=201911120300&dongCode=1100000000&dataTypeCd=Temp&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

baseTime

발표시간

발표시간

dongCode

행정구역 코드

행정구역 코드

dataTypeCd

데이터 타입

데이터 타입

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

baseTime

발표시간

fcstTime

예측시간

lon

행정구역 경도

lat

행정구역 위도

unit

단위

value

값

호출URL정보

지역예보모델단일면한반도조회

https://apihub.kma.go.kr/api/typ02/openApi/NwpModelInfoService/getRdapsUnisAll?pageNo=1&numOfRows=10&dataType=XML&baseTime=201911120300&leadHour=0&dataTypeCd=rain&dongCode=1100000000&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

baseTime

발표시간

발표시간

leadHour

선행시간

선행시간

dataTypeCd

데이터 타입

데이터 타입

dongCode

행정구역 코드

행정구역 코드

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

baseTime

발표시간

fcstTime

예측시간

gridKm

격자크기

xdim

X 좌표 개수

ydim

Y 좌표 개수

x0

X 좌표 기준점

y0

Y 좌표 기준점

unit

단위

value

값

호출URL정보

지역예보모델단일면행정구역조회

https://apihub.kma.go.kr/api/typ02/openApi/NwpModelInfoService/getRdapsUnisArea?pageNo=1&numOfRows=10&dataType=XML&baseTime=201911120300&dongCode=1100000000&dataTypeCd=Temp&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

baseTime

발표시간

발표시간

dongCode

행정구역 코드

행정구역 코드

dataTypeCd

데이터 타입

데이터 타입

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

baseTime

발표시간

fcstTime

예측시간

lon

행정구역 경도

lat

행정구역 위도

unit

단위

value

값

5. 해구별 예측데이터 조회

UM 지역파랑모델(RWW3)에서 추출한 소·대 해구별 유의파고, 최대파주기, 파향, 풍향, 풍속 요소에 대한 +75시간까지의 예측데이터를 제공합니다.

연근해 해구도 참고자료

호출URL정보

대해구별 예측데이터 조회(단일 대해구)

https://apihub.kma.go.kr/api/typ06/url/marine_large_zone.php?tma_fc=2025012500&tma_ef=2025012500&Lzone=1&help=1&disp=0&authKey=FyIoXmJzSiWiKF5icxolng

대해구별 예측데이터 조회(다중 대해구)

https://apihub.kma.go.kr/api/typ06/url/marine_large_zone.php?tma_fc=2025012500&tma_ef=2025012500&Lzone=1,2,3&help=1&disp=0&authKey=FyIoXmJzSiWiKF5icxolng

대해구별 예측데이터 조회(전체 대해구)

https://apihub.kma.go.kr/api/typ06/url/marine_large_zone.php?tma_fc=2025012500&tma_ef=2025012500&Lzone=0&help=1&disp=0&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

tma_fc

발표시각

일 2회(00, 12UTC) 발표 / (포맷) yyyymmddhh / (단위) UTC
※ 2017년 12월 29일 00UTC 데이터 부터 호출가능

tma_ef

발효시각

+75시간까지 3시간 간격 예측자료 / (포맷) yyyymmddhh / (단위) UTC

Lzone

대해구번호

대해구번호 입력 / 다중 입력 가능(구분자: 콤마) / 0 입력시 전체 대해구 표출
(대해구: 우리나라 인근 해역을 위？경도 0.5° 간격의 격자로 나누어 번호를 부여한 바다의 주소 체계)

disp

표출방식

0 입력시 빈칸없는 CSV 포맷 / 1 입력시 등간격 포맷

help

도움말

1 입력시 도움말 표출 / 0 또는 미입력시 도움말 미표출

출력결과

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

tma_fc

발표시각(UTC)
※ 일 2회(00, 12UTC) 발표 / (포맷) yyyymmddhh

tma_ef

발효시각(UTC)
※ +75시간까지 3시간 간격 예측자료 / (포맷) yyyymmddhh

Lzone

대해구번호

lat_lb

대해구 좌하단 위도 (degree)

lon_lb

대해구 좌하단 경도 (degree)

lat_lt

대해구 좌상단 위도 (degree)

lon_lt

대해구 좌상단 경도 (degree)

lat_rt

대해구 우상단 위도 (degree)

lon_rt

대해구 우상단 경도 (degree)

lat_rb

대해구 우하단 위도 (degree)

lon_rb

대해구 우하단 경도 (degree)

wh_sig

대해구별 유의파고 (m)
※ 대해구 격자에 해당하는 값이 없을 경우 누락값(-999.0) 표출

wvprd_max

대해구별 최대파주기 (sec)
※ 대해구 격자에 해당하는 값이 없을 경우 누락값(-999.0) 표출

wvdr

대해구별 파향 (degree)
※ 대해구 격자에 해당하는 값이 없을 경우 누락값(-999.0) 표출

ws

대해구별 풍속 (m/s)
※ 대해구 격자에 해당하는 값이 없을 경우 누락값(-999.0) 표출

wd

대해구별 풍향 (degree)
※ 대해구 격자에 해당하는 값이 없을 경우 누락값(-999.0) 표출

호출URL정보

소해구별 예측데이터 조회서비스(단일 대해구, 단일 소해구)

https://apihub.kma.go.kr/api/typ06/url/marine_small_zone.php?tma_fc=2025012500&tma_ef=2025012609&Lzone=1&Szone=1&disp=0&help=1&authKey=FyIoXmJzSiWiKF5icxolng

소해구별 예측데이터 조회서비스(다중 대해구, 다중 소해구)

https://apihub.kma.go.kr/api/typ06/url/marine_small_zone.php?tma_fc=2025012500&tma_ef=2025012609&Lzone=1,3,4,5&Szone=1,2,3,4,5&disp=0&help=1&authKey=FyIoXmJzSiWiKF5icxolng

소해구별 예측데이터 조회서비스(다중 대해구, 전체 소해구)

https://apihub.kma.go.kr/api/typ06/url/marine_small_zone.php?tma_fc=2025012500&tma_ef=2025012609&Lzone=1,3,4,5&Szone=0&disp=0&help=1&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

tma_fc

발표시각

일 2회(00, 12UTC) 발표 / (포맷) yyyymmddhh / (단위) UTC
※ 2024년 8월 29일 00UTC 데이터 부터 호출가능

tma_ef

발효시각

+75시간까지 3시간 간격 예측자료 / (포맷) yyyymmddhh / (단위) UTC

Lzone

대해구 번호

대해구번호 입력 / 최대 40개 입력 가능(구분자: 콤마)
(※ 대해구: 우리나라 인근 해역을 위？경도 0.5° 간격의 격자로 나누어 번호를 부여한 바다의 주소 체계)

Szone

소해구 번호

소해구번호 입력(1~9) / 다중 입력 가능(구분자: 콤마) / 0 입력시 전체 소해구 표출
(※ 소해구: 대해구를 다시 가로와 세로로 3등분(3×3)해 소해구로 구성)

disp

표출방식

0 입력시 빈칸없는 CSV 포맷 / 1 입력시 등간격 포맷

help

도움말

1 입력시 도움말 표출 / 0 또는 미입력시 도움말 미표출

출력결과

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

tma_fc

발표시각(UTC)
※ 일 2회(00, 12UTC) 발표 / (포맷) yyyymmddhh

tma_ef

발효시각(UTC)
※ +75시간까지 3시간 간격 예측자료 / (포맷) yyyymmddhh

Lzone

대해구 번호

Szone

소해구 번호

lat_lb

소해구 좌하단 위도 (degree)

lon_lb

소해구 좌하단 경도 (degree)

lat_lt

소해구 좌상단 위도 (degree)

lon_lt

소해구 좌상단 경도 (degree)

lat_rt

소해구 우상단 위도 (degree)

lon_rt

소해구 우상단 경도 (degree)

lat_rb

소해구 우하단 위도 (degree)

lon_rb

소해구 우하단 경도 (degree)

wh_sig

소해구별 유의파고 (m)
※ 소해구 격자에 해당하는 값이 없을 경우 누락값(-999.0) 표출

wvprd_max

소해구별 최대파주기 (sec)
※ 소해구 격자에 해당하는 값이 없을 경우 누락값(-999.0) 표출

wvdr

소해구별 파향 (degree)
※ 소해구 격자에 해당하는 값이 없을 경우 누락값(-999.0) 표출

ws

소해구별 풍속 (m/s)
※ 소해구 격자에 해당하는 값이 없을 경우 누락값(-999.0) 표출

wd

소해구별 풍향 (degree)
※ 소해구 격자에 해당하는 값이 없을 경우 누락값(-999.0) 표출

6. 수치예보모델 격자데이터 위경도 조회

호출URL정보

수치예보모델 격자데이터 위경도 조회

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-nwp_latlon_api?nwp=k120&latlon=lon&disp=A&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

nwp

수치예보모델 종류

u128(UM 전구), u120(UM 지역), u015(UM 국지)
k128(KIM 전구), k120(KIM 지역(12km)), k030(KIM 지역(3km)

latlon

위도경도 선택

lon(경도), lat(위도)
※ (KIM 전구/ UM 전구) lon 입력시 좌상단에서 우하단으로 이동하며 격자별 경도값 표출
(KIM 전구/ UM 전구) lat 입력시 좌상단에서 우하단으로 이동하며 격자별 위도값 표출
※ (KIM 지역/ UM 지역·국지) lon 입력시 좌하단에서 우상단으로 이동하며 격자별 경도값 표출
(KIM 지역/ UM 지역·국지) lat 입력시 좌하단에서 우상단으로 이동하며 격자별 위도값 표출

disp

표출방식

A(ASCII) - 격자점수 + 자료 출력
B(BINARY) - 격자갯수((short)nx * (short)ny)가 정수로 조회(4byte) + 자료가 실수로 조회
자료 순서는 격자자료가 저장된 순서되로 출력됨

authKey

인증키

발급된 API 인증키

출력결과

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

lat

(KIM 전구/ UM 전구) 좌상단에서 우하단으로 이동하며 격자별 위도값 표출
(KIM 지역/ UM 지역·국지) 좌하단에서 우상단으로 이동하며 격자별 위도값 표출

lon

(KIM 전구/ UM 전구) 좌상단에서 우하단으로 이동하며 격자별 경도값 표출
(KIM 지역/ UM 지역·국지) 좌하단에서 우상단으로 이동하며 격자별 경도값 표출

호출URL정보

수치예보모델 격자데이터 위경도 파일(NetCDF) 다운로드

https://apihub.kma.go.kr/api/typ01/url/nwp_latlon_file_down.php?nwp=k128&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

nwp

수치예보모델 종류

u128(UM 전구) u120(UM 지역) u015(UM 국지)
k128(KIM 전구) k120(KIM 지역(12km)) k030(KIM 지역(3km)

7. 수치모델 GRIB파일 격자 및 변수 참고 정보

호출URL정보

수치모델 GRIB파일 격자 및 변수 참고 정보 조회 서비스

https://apihub.kma.go.kr/api/typ06/cgi-bin/url/nph-nwp_header?model=um&nwp=g128&sub=unis&tmfc=202403010000&ef=3&help=1&authKey=FyIoXmJzSiWiKF5icxolng

요청인자

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

mode

모델종류

kim: kim모델, um: um모델

nwp

자료종류

g128: 전구(kim, um), g512: 전구(um), g120: 지역(kim, um), r030: 지역(kim), l015: 국지(um)

sub

파일구분

pres(등압면), unis(단일면)

tmfc

기준시각

년월일시(UTC)

ef

예측시각

기준시각에서부터의 예측시간(0~)

help

도움말

1(도움말 정보 표시)

출력결과

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

투영법이 regular_ll

메시지번호, 자료시각, 예측시간(시작), 예측시간(마지막), 시각종류, 자료타입, x격자수, y격자수, 기준면타입, level, 투영법, 시작위도, 마지막위도, 시작위도, 마지막경도, 위도간격, 경도간격, discioline, parameterCategory, parameterNumber, 변수(약어), 변수명, 변수단위

투영법이 lambert

메시지번호, 자료시각, 예측시간(시작), 예측시간(마지막), 시각종류, 자료타입, x격자수, y격자수, 기준면타입, level, 투영법, 시작위도, 시작경도, 기준위도, 기준경도, x좌표 해상도(m), y좌표 해상도(m), discioline, parameterCategory, parameterNumber, 변수(약어), 변수명, 변수단위