수치모델

통합모델(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=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

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=aIZ7k2xRTX6Ge5NsUZ1-IA

일부 격자영역만

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=aIZ7k2xRTX6Ge5NsUZ1-IA

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=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

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=aIZ7k2xRTX6Ge5NsUZ1-IA

특정 고도의 단면값

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=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

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=aIZ7k2xRTX6Ge5NsUZ1-IA

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

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=aIZ7k2xRTX6Ge5NsUZ1-IA

임의 위경도의 자료

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=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

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=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

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=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

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=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

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=aIZ7k2xRTX6Ge5NsUZ1-IA

일부 격자영역

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=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

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=aIZ7k2xRTX6Ge5NsUZ1-IA

임의 위경도의 자료

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=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

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=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

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=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

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=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

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=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

baseTime

발표시간

발표시간

dongCode

행정구역 코드

행정구역 코드

dataTypeCd

데이터 타입

데이터 타입

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

baseTime

발표시간

fcstTime

예측시간

lon

행정구역 경도

lat

행정구역 위도

unit

단위

value