수치모델

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

api 상세
개요

수치모델에서 생산된 수치자료의 변수들에 대한 등치선, 등치면 등 그래픽을 제공하며 프로그래밍을 통해 함께 제공한 배경지도, 경위도선과 중첩하여 원하는 일기도를 제작할 수 있습니다.
※ 일기도 중첩시 사용하는 배경지도는 '10. (그래픽) 지도, 경위도선, 관측자료 조회'를 사용하는 것을 권장합니다.
요 소

지상(3시간), 지상(6시간), 지상기압변화(3시간), 파랑, 폭풍해일, 보조, 고층, 앙상블 등
생산주기

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

1. (그래픽) 분석일기도 조회

호출URL정보

분석일기도

https://apihub.kma.go.kr/api/typ07/afsiwa/iwa/api/iwaImgUrlApi/retRecreateImgUrl.kfrm?analTime=202305050000&isTyp=false&imageType=png&groupName=925_default&meta=0&authKey=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

analTime

분석 시간(UTC)

분석 시간(UTC)

isTyp

태풍 영역 여부

imageType

이미지 종류

groupName

그룹 명

meta

메타 정보 반환 여부

0(이미지 반환), 1(메타 정보 반환)

authKey

인증키

발급된 API 인증키

2. (그래픽) 지상 해면기압, 누적강수량 예상일기도 조회(UM)

호출URL정보

지상 해면기압, 누적강수량 예상일기도

https://apihub.kma.go.kr/api/typ07/afsiwa/iwa/api/iwaImgUrlApi/retComposite2ImgUrl.kfrm?analTime=202305150000&foreTime=202305150000&authKey=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

analTime

분석 시간(UTC)

분석 시간(UTC)

foreTime

예측 시간(UTC)

예측 시간(UTC)

authKey

인증키

발급된 API 인증키

foreTime

예측 시간(UTC)

예측 시간(UTC)

3. (그래픽) 500hPa 고도, 기온, 상대와도 예상일기도 조회(UM)

호출URL정보

500hPa 고도, 기온, 상대와도 예상일기도

https://apihub.kma.go.kr/api/typ07/afsiwa/iwa/api/iwaImgUrlApi/retComposite1ImgUrl.kfrm?analTime=202305150000&foreTime=202305150000&authKey=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

analTime

분석 시간(UTC)

분석 시간(UTC)

foreTime

예측 시간(UTC)

예측 시간(UTC)

authKey

인증키

발급된 API 인증키

4. (그래픽) 수치예보모델일기도 조회

그래픽 API 활용 예제 참고자료

호출URL정보

수치모델일기도

https://apihub.kma.go.kr/api/typ07/afsiwa/iwa/api/iwaImgUrlApi/retModelImgUrl.kfrm?modl=GDAPS_KIM&varGrp=PRSS_HGT&var=HGT&lev=1000&analTime=202305150000&foreTime=202305150000&PROJ=LCC&mapRange=EASIA&ZOOMLVL=7&stLon=48.19729473179383&stLat=36.05394599513232&edLon=162.3512886531648&edLat=3.3720585707135684&basicSmtLvl=3&basicTotSmtLvl=5&repDispCd=L&symblDispType=&isRasterFillCheck=N&meta=0&symbl=1&authKey=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

modl

모델

varGrp

자료 구분

var

변수

lev

연직층

analTime

분석 시간(UTC)

분석 시간(UTC)

foreTime

예측 시간(UTC)

예측 시간(UTC)

PROJ

투영 정보

투영정보 : LCC (한반도,동아시아 , 태풍영역), STG (북반구), SYL (전구)

mapRange

지도 영역

경위도 파라미터 없이 지도영역만 전달 가능
EASIA, KOR, SKOR

ZOOMLVL

줌 레벨 값

줌 레벨 값이 증가할수록 이미지 크기 증가

stLon

좌상 경도

stLat

좌상 위도

edLon

우하 경도

edLat

우하 위도

basicSmtLvl

분석 해상도

basicTotSmtLvl

평활 횟수

정수로 입력

repDispCd

표출형태

symblDispType

표출형태

isRasterFillCheck

rasterfill

표출형태가 '등치면'일 때만 적용

meta

메타 정보 반환 여부

0(이미지 반환), 1(메타 정보 반환)

authKey

인증키

발급된 API 인증키

호출URL정보

불안정도, 전선 등 조회

https://apihub.kma.go.kr/api/typ07/afsiwa/iwa/api/iwaImgUrlApi/retForeImgUrl.kfrm?varGrp=INSTB_IDX&var=KI&modl=GDAPS&lev=850&analTime=202305180000&foreTime=202305180000&PROJ=LCC&ZOOMLVL=7&stLon=48.19729473179383&stLat=36.05394599513232&edLon=162.3512886531648&edLat=3.3720585707135684&basicSmtLvl=1&basicTotSmtLvl=5&repDispCd=F&symblDispType=&isRasterFillCheck=N&authKey=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

varGrp

자료 그룹

var

변수

modl

지원모델

lev

연직층

analTime

분석 시간(UTC)

분석 시간(UTC)

foreTime

예측 시간(UTC)

예측 시간(UTC)

PROJ

투영 정보

투영정보 : LCC (한반도,동아시아 , 태풍영역), STG (북반구), SYL (전구)

mapRange

지도 영역

경위도 파라미터 없이 지도영역만 전달 가능
EASIA, KOR, SKOR

ZOOMLVL

줌 레벨 값

줌 레벨 값이 증가할수록 이미지 크기 증가

stLon

좌상 경도

stLat

좌상 위도

edLon

우하 경도

edLat

우하 위도

basicSmtLvl

분석 해상도

basicTotSmtLvl

평활 횟수

정수로 입력

repDispCd

표출형태

표출 가능한 파라미터 목록 참조

symblDispType

표출형태

표출 가능한 파라미터 목록 참조

isRasterFillCheck

rasterfill

표출형태가 '등치면'일 때만 적용

meta

메타 정보 반환 여부

0(이미지 반환), 1(메타 정보 반환)

authKey

인증키

발급된 API 인증키

5. (그래픽) 수치예보모델 앙상블일기도 조회

호출URL정보

수치모델 앙상블일기도

https://apihub.kma.go.kr/api/typ07/afsiwa/iwa/api/iwaImgUrlApi/retEnsImgUrl.kfrm?modl=UMGE&ensType=MEMBS&varGrp=PRSS_HGT&var=24HHC&mem=m00&lev=500&analTime=202305150000&foreTime=202305150000&PROJ=LCC&ZOOMLVL=7&stLon=48.19729473179383&stLat=36.05394599513232&edLon=162.3512886531648&edLat=3.3720585707135684&basicTotSmtLvl=5&repDispCd=F&symblDispType=&isRasterFillCheck=N&meta=0&symbl=1&authKey=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

modl

모델

ensType

자료 구분

varGrp

변수 구분

var

변수

mem

멤버

lev

연직층

analTime

분석 시간(UTC)

분석 시간(UTC)

foreTime

예측 시간(UTC)

예측 시간(UTC)

PROJ

투영 정보

투영정보 : LCC (한반도,동아시아 , 태풍영역), STG (북반구), SYL (전구)

mapRange

지도 영역

경위도 파라미터 없이 지도영역만 전달 가능
EASIA, KOR, SKOR

ZOOMLVL

줌 레벨 값

줌 레벨 값이 증가할수록 이미지 크기 증가

stLon

좌상 경도

stLat

좌상 위도

edLon

우하 경도

edLat

우하 위도

basicTotSmtLvl

평활 횟수

정수로 입력

repDispCd

표출형태

symblDispType

표출형태

isRasterFillCheck

rasterfill

표출형태가 '등치면'일 때만 적용

meta

메타 정보 반환 여부

0(이미지 반환), 1(메타 정보 반환)

authKey

인증키

발급된 API 인증키

6. (그래픽) 파랑·폭풍해일모델일기도 조회

호출URL정보

파랑·폭풍해일모델일기도

https://apihub.kma.go.kr/api/typ07/afsiwa/iwa/api/iwaImgUrlApi/retOceanImgUrl.kfrm?modlGrp=GWW&modl=GWW3&var=WSPD_SNW&mem=0000&lev=1000&foreTime=202305150000&PROJ=LCC&ZOOMLVL=7&stLon=48.19729473179383&stLat=36.05394599513232&edLon=162.3512886531648&edLat=3.3720585707135684&basicTotSmtLvl=5&repDispCd=S&symblDispType=W&isRasterFillCheck=N&meta=0&symbl=1&authKey=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

modlGrp

모델

modl

상세 모델 구분

var

변수

mem

멤버

lev

연직층

analTime

분석 시간(UTC)

분석 시간(UTC)

foreTime

예측 시간(UTC)

예측 시간(UTC)

PROJ

투영 정보

투영정보 : LCC (한반도,동아시아 , 태풍영역), STG (북반구), SYL (전구)

mapRange

지도 영역

경위도 파라미터 없이 지도영역만 전달 가능
EASIA, KOR, SKOR

ZOOMLVL

줌 레벨 값

줌 레벨 값이 증가할수록 이미지 크기 증가

stLon

좌상 경도

stLat

좌상 위도

edLon

우하 경도

edLat

우하 위도

basicTotSmtLvl

평활 횟수

정수로 입력

repDispCd

표출형태

표출 가능한 파라미터 목록 참조

symblDispType

표출형태

표출 가능한 파라미터 목록 참조

isRasterFillCheck

rasterfill

표출형태가 '등치면'일 때만 적용

meta

메타 정보 반환 여부

0(이미지 반환), 1(메타 정보 반환)

symbl

심불 간격

authKey

인증키

발급된 API 인증키

7. (그래픽) 연직단면도 조회

호출URL정보

연직단면도

https://apihub.kma.go.kr/api/typ07/afsiwa/iwa/api/iwaImgUrlApi/retCrssSctnImgUrl.kfrm?modelCd=GDAPS&variable=HGT&variable=TMP&variable=DPDK&isFill3=on&analTime=202307090000&foreTime=202307090000&locationLon01=120.66129962381797&locationLat01=36.91146898896052&locationLon02=133.3912129370549&locationLat02=37.51263883713012&minPresAlt=50&maxPresAlt=1000&log=Y&width=1108&height=625&layerInfo=Y&authKey=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

modelCd

모델 코드

variable

변수 선택

variable

변수 선택

다중 선택

variable

변수 선택

다중 선택

analTime

분석 시간(UTC)

분석 시간(UTC)

foreTime

예측 시간(UTC)

예측 시간(UTC)

location

시작 경위도 정보

ex : 142.1599,64.3463

location

종료 경위도 정보

ex : 145.8724,63.1064

minPresAlt

최소 고도

maxPresAlt

최대 고도

log

log

고도에 따른 시계열 간격 표출형태

width

이미지 가로 크기

height

이미지 세로 크기

layerInfo

레이어 정보

하단에 표출되는 레이어 정보

authKey

인증키

발급된 API 인증키

8. (그래픽) 지도, 경위도선, 관측자료 조회

호출URL정보

지도

https://apihub.kma.go.kr/api/typ07/afsiwa/iwa/api/iwaImgUrlApi/retBackMapUrl.kfrm?type=SL&projection=LCC&ZOOMLVL=7&stLon=48.19729473179383&stLat=36.05394599513232&edLon=162.3512886531648&edLat=3.3720585707135684&meta=0&authKey=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

type

주제도 타입

projection

투영 정보

ZOOMLVL

줌 레벨 값

stLon

좌상 경도

stLat

좌상 위도

edLon

우하 경도

edLat

우하 위도

ltX

좌상 GIS X 좌표

ltY

좌상 GIS Y 좌표

rbX

우하 GIS X 좌표

rbY

우하 GIS Y 좌표

meta

메타 정보 반환 여부

authKey

인증키

호출URL정보

경위도

https://apihub.kma.go.kr/api/typ07/afsiwa/iwa/api/iwaImgUrlApi/retBackMapUrl.kfrm?type=SL&projection=LCC&ZOOMLVL=7&stLon=48.19729473179383&stLat=36.05394599513232&edLon=162.3512886531648&edLat=3.3720585707135684&meta=0&authKey=YGHzUcOxRdSh81HDsRXULg)&authKey=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

PROJ

투영 정보

ZOOMLVL

줌 레벨 값

stLon

좌상 경도

stLat

좌상 위도

edLon

우하 경도

edLat

우하 위도

호출URL정보

레이더 합성영상

https://apihub.kma.go.kr/api/typ07/afsiwa/iwa/api/iwaImgUrlApi/retObsImgUrl.kfrm?obs=CPSTRDR&varGrp=RDR_QCD&var=HSR&lev=-999999&analTime=202307071500&PROJ=LCC&ZOOMLVL=7&stLon=48.19729473179383&stLat=36.05394599513232&edLon=162.3512886531648&edLat=3.3720585707135684&basicSmtLvl=3&basicTotSmtLvl=5&repDispCd=&symblDispType=&meta=0&authKey=aIZ7k2xRTX6Ge5NsUZ1-IA

천리안2A호

https://apihub.kma.go.kr/api/typ07/afsiwa/iwa/api/iwaImgUrlApi/retObsImgUrl.kfrm?obs=SAT&varGrp=SAT_GK2A&var=WV_MID&lev=-999999&analTime=202307150000&PROJ=LCC&ZOOMLVL=7&stLon=48.19729473179383&stLat=36.05394599513232&edLon=162.3512886531648&edLat=3.3720585707135684&basicSmtLvl=3&basicTotSmtLvl=5&repDispCd=O&symblDispType=&meta=0&authKey=aIZ7k2xRTX6Ge5NsUZ1-IA

GTS관측

https://apihub.kma.go.kr/api/typ07/afsiwa/iwa/api/iwaImgUrlApi/retObsImgUrl.kfrm?obs=GTS&varGrp=GTS1&var=GTS_PRMSL&lev=-999999&analTime=202307071500&PROJ=LCC&ZOOMLVL=7&stLon=48.19729473179383&stLat=36.05394599513232&edLon=162.3512886531648&edLat=3.3720585707135684&basicSmtLvl=3&basicTotSmtLvl=5&repDispCd=L&symblDispType=&meta=0&authKey=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

obs

관측

varGrp

변수 종류

var

변수

lev

연직층

analTime

분석 시간(UTC)

분석 시간(UTC)

PROJ

투영 정보

투영정보 : LCC (한반도,동아시아 , 태풍영역), STG (북반구), SYL (전구)

mapRange

지도 영역

경위도 파라미터 없이 지도영역만 전달 가능
EASIA, KOR, SKOR

ZOOMLVL

줌 레벨 값

줌 레벨 값이 증가할수록 이미지 크기 증가

stLon

좌상 경도

stLat

좌상 위도

edLon

우하 경도

edLat

우하 위도

basicSmtLvl

분석 해상도

basicTotSmtLvl

평활 횟수

정수로 입력

meta

메타 정보 반환 여부

0(이미지 반환)

authKey

인증키

발급된 API 인증키

호출URL정보

지점 추출

https://apihub.kma.go.kr/api/typ07/afsiwa/iwa/api/iwaImgUrlApi/retMdlSampleDataUrl.kfrm?menuGrpCd=VAR&menu01=PRSS_TMP&menu02=TMP&menu03=GDAPS&varListCd=TMP&vrtcLayrCd=925&analTime=201705050000&foreTime=201705050000&basicSmtLvl=3&location=126.966%2C37.571&project=LCC&meta=1&authKey=aIZ7k2xRTX6Ge5NsUZ1-IA

요청인자

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

menuGrpCd

메뉴 그룹 코드

menu01

메뉴 01

menu02

메뉴 02

menu03

메뉴 03

varListCd

변수 목록 코드

vrtcLayrCd

연직층 코드

analTime

분석 시간(UTC)

foreTime

예측 시간(UTC)

basicSmtLvl

분석 해상도

location

읽어야 할 경위도 정보

ex : 117.07,43.29

meta

메타 정보 반환 여부

0(kajx), 1(kfrm)

authKey

인증키