예특보

초단기, 단기, 중기예보의 기온, 바람, 강수량 등 데이터를 제공하며, 폭염, 한파, 호우 등 10종의 기상특보(주의보, 경보) 데이터를 제공합니다.

api 상세
개요

단기예보란 예보기간과 구역을 시 · 공간적으로 세분화하여 발표하는 예보입니다. 지역별, 시간별 차이로 인한 수요자의 불편을 최소화하기 위해 전국을 5km * 5km 간격의 격자(동서 149(745km) × 남북 253(1.265km)), 총 37,697개로 나누어, 3시간 마다 읍, 면, 동 단위의 행정구역 중심으로 상세한 날씨를 제공합니다.

요 소

3시간 기온, 낮 최고기온, 아침 최저기온, 풍향, 풍속, 동서바람성분, 남북바람성분, 하늘상태, 강수형태, 강수확률, 6시간 강수량, 6시간 신적설, 습도, 파고

지 점

동사무소를 중심으로 하는 행정구역

보유기간

2008년 10월 30일 17:00KST(시행일 기준) ~ 현재

생산주기

2시부터 3시간 간격(일 8회)

1. 단기예보자료(2001년 2월 이후) 조회

단기예보 DB테이블 참고자료

호출URL정보

단기 예보구역

https://apihub.kma.go.kr/api/typ01/url/fct_shrt_reg.php?tmfc=0&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

stn

발표관서번호

없으면 전체

reg

예보구역코드

없으면 전체

tmfc

발표시간

예보구역조회에서 사용(기준시각의미, 년월일시(KST))
없으면, 전체 / 0이면, 가장 최근

tmfc1

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmfc2

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmef1

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

tmef2

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

1(도움말 정보 표시)

authKey

인증키

발급된 API 인증키

출력결과

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

REG_ID

예보구역코드

TM_ST

시작시각(년월일시분,KST)

TM_ED

종료시각(년월일시분,KST)

REG_SP

특성

REG_NAME

예보구역명

STN_ID

발표관서

TM_FC

발표시각(KST)

TM_IN

입력시각(KST)

CNT

참조번호

MAN_FC

예보관명

TM_EF

발효시각(년월일시분,KST)

MOD

구간 (A01(24시간),A02(12시간))

NE

발효번호

STN

발표관서

C

발표코드

MAN_ID

예보관ID

W1

풍향1(16방위) (범위 시작값)

T

풍향경향

W2

풍향2(16방위) (범위 종료값)

TA

기온

ST

강수확률(%)

SKY

하늘상태코드 (DB01(맑음),DB02(구름조금),DB03(구름많음),DB04(흐림))

PREP

강수유무코드 (1(비),2(비/눈),4(눈/비),3(눈))

WF

예보

호출URL정보

단기 개황, disp=1(JSON)

https://apihub.kma.go.kr/api/typ01/url/fct_afs_ds.php?stn=&tmfc1=2013121106&tmfc2=2013121118&disp=0&help=1&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

stn

발표관서번호

없으면 전체

reg

예보구역코드

없으면 전체

tmfc

발표시간

예보구역조회에서 사용(기준시각의미, 년월일시(KST))
없으면, 전체 / 0이면, 가장 최근

tmfc1

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmfc2

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmef1

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

tmef2

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

1(도움말 정보 표시)

authKey

인증키

발급된 API 인증키

출력결과

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

REG_ID

예보구역코드

TM_ST

시작시각(년월일시분,KST)

TM_ED

종료시각(년월일시분,KST)

REG_SP

특성

REG_NAME

예보구역명

STN_ID

발표관서

TM_FC

발표시각(KST)

TM_IN

입력시각(KST)

CNT

참조번호

MAN_FC

예보관명

TM_EF

발효시각(년월일시분,KST)

MOD

구간 (A01(24시간),A02(12시간))

NE

발효번호

STN

발표관서

C

발표코드

MAN_ID

예보관ID

W1

풍향1(16방위) (범위 시작값)

T

풍향경향

W2

풍향2(16방위) (범위 종료값)

TA

기온

ST

강수확률(%)

SKY

하늘상태코드 (DB01(맑음),DB02(구름조금),DB03(구름많음),DB04(흐림))

PREP

강수유무코드 (1(비),2(비/눈),4(눈/비),3(눈))

WF

예보

호출URL정보

단기 육상예보

https://apihub.kma.go.kr/api/typ01/url/fct_afs_dl.php?reg=&tmfc1=2013121106&tmfc2=2013121118&disp=0&help=1&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

stn

발표관서번호

없으면 전체

reg

예보구역코드

없으면 전체

tmfc

발표시간

예보구역조회에서 사용(기준시각의미, 년월일시(KST))
없으면, 전체 / 0이면, 가장 최근

tmfc1

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmfc2

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmef1

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

tmef2

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

1(도움말 정보 표시)

authKey

인증키

발급된 API 인증키

출력결과

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

REG_ID

예보구역코드

TM_ST

시작시각(년월일시분,KST)

TM_ED

종료시각(년월일시분,KST)

REG_SP

특성

REG_NAME

예보구역명

STN_ID

발표관서

TM_FC

발표시각(KST)

TM_IN

입력시각(KST)

CNT

참조번호

MAN_FC

예보관명

TM_EF

발효시각(년월일시분,KST)

MOD

구간 (A01(24시간),A02(12시간))

NE

발효번호

STN

발표관서

C

발표코드

MAN_ID

예보관ID

W1

풍향1(16방위) (범위 시작값)

T

풍향경향

W2

풍향2(16방위) (범위 종료값)

TA

기온

ST

강수확률(%)

SKY

하늘상태코드 (DB01(맑음),DB02(구름조금),DB03(구름많음),DB04(흐림))

PREP

강수유무코드 (1(비),2(비/눈),4(눈/비),3(눈))

WF

예보

호출URL정보

https://apihub.kma.go.kr/api/typ01/url/fct_afs_dl2.php?reg=&tmfc1=2020052505&tmfc2=2020052517&disp=0&help=1&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

stn

발표관서번호

없으면 전체

reg

예보구역코드

없으면 전체

tmfc

발표시간

예보구역조회에서 사용(기준시각의미, 년월일시(KST))
없으면, 전체 / 0이면, 가장 최근

tmfc1

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmfc2

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmef1

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

tmef2

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

1(도움말 정보 표시)

authKey

인증키

발급된 API 인증키

출력결과

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

REG_ID

예보구역코드

TM_ST

시작시각(년월일시분,KST)

TM_ED

종료시각(년월일시분,KST)

REG_SP

특성

REG_NAME

예보구역명

STN_ID

발표관서

TM_FC

발표시각(KST)

TM_IN

입력시각(KST)

CNT

참조번호

MAN_FC

예보관명

TM_EF

발효시각(년월일시분,KST)

MOD

구간 (A01(24시간),A02(12시간))

NE

발효번호

STN

발표관서

C

발표코드

MAN_ID

예보관ID

W1

풍향1(16방위) (범위 시작값)

T

풍향경향

W2

풍향2(16방위) (범위 종료값)

TA

기온

ST

강수확률(%)

SKY

하늘상태코드 (DB01(맑음),DB02(구름조금),DB03(구름많음),DB04(흐림))

PREP

강수유무코드 (1(비),2(비/눈),4(눈/비),3(눈))

WF

예보

호출URL정보

단기 해상예보

https://apihub.kma.go.kr/api/typ01/url/fct_afs_do.php?reg=&tmfc1=2013121106&tmfc2=2013121118&disp=0&help=1&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

stn

발표관서번호

없으면 전체

reg

예보구역코드

없으면 전체

tmfc

발표시간

예보구역조회에서 사용(기준시각의미, 년월일시(KST))
없으면, 전체 / 0이면, 가장 최근

tmfc1

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmfc2

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmef1

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

tmef2

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

1(도움말 정보 표시)

authKey

인증키

발급된 API 인증키

출력결과

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

REG_ID

예보구역코드

TM_ST

시작시각(년월일시분,KST)

TM_ED

종료시각(년월일시분,KST)

REG_SP

특성

REG_NAME

예보구역명

STN_ID

발표관서

TM_FC

발표시각(KST)

TM_IN

입력시각(KST)

CNT

참조번호

MAN_FC

예보관명

TM_EF

발효시각(년월일시분,KST)

MOD

구간 (A01(24시간),A02(12시간))

NE

발효번호

STN

발표관서

C

발표코드

MAN_ID

예보관ID

W1

풍향1(16방위) (범위 시작값)

T

풍향경향

W2

풍향2(16방위) (범위 종료값)

TA

기온

ST

강수확률(%)

SKY

하늘상태코드 (DB01(맑음),DB02(구름조금),DB03(구름많음),DB04(흐림))

PREP

강수유무코드 (1(비),2(비/눈),4(눈/비),3(눈))

WF

예보

S1

풍속1 (범위 시작값)

S2

풍속2 (범위 종료값)

WH1

파고1 (범위 시작값)

WH2

파고2 (범위 종료값)

2. 동네예보(단기예보, 초단기예보, 실황) 격자자료

동네예보 격자영역 정보 참고자료

단기예보 예보기간 확대에 따른 변경사항 참고자료

호출URL정보

단기예보

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-dfs_shrt_grd?tmfc=2024022505&tmef=2024022506&vars=TMP&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

tmfc

발표시간

연월일시(KST)
- 3시간 간격 생산(매일 2시, 5시, 8시, 11시, 14시, 17시, 20시, 23시 발표)

tmef

발효시간

년월일시(KST)
- (2024.11.28. 14시 이전) 1시간 간격으로 제공(2, 5, 8, 11, 14시는 모레 자정까지, 17, 20, 23시는 글피 자정까지 제공)
- (2024.11.28. 14시 이후) 1시간 간격으로 제공(2, 5, 8, 11, 14시는 글피 자정까지, 17, 20, 23시는 그글피 자정까지 제공)

vars

예보변수

TMP(기온), TMX(최고기온), TMN(최저기온), UUU(동서바람성분), VVV(남북바람성분), VEC(풍향), WSD(풍속), SKY(하늘상태), PTY(강수형태), POP(강수유무), PCP(1시간 강수량), SNO(1시간 신적설), REH(상대습도), WAV(파고)

authKey

인증키

발급된 API 인증키

호출URL정보

초단기예보

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-dfs_vsrt_grd?tmfc=202403011010&tmef=2024030111&vars=T1H&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

tmfc

발표시간

연월일시분(KST)
- 10분 간격 발표

tmef

발효시간

년월일시(KST)
- 발표시간 기준 6시간 까지 1시간 간격으로 제공

vars

예보변수

T1H(기온), UUU(동서바람성분), VVV(남북바람성분), VEC(풍향), WSD(풍속), SKY(하늘상태), LGT(낙뢰), PTY(강수형태), RN1(1시간 강수량), REH(상대습도)

authKey

인증키

발급된 API 인증키

호출URL정보

실황

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-dfs_odam_grd?tmfc=202403051010&vars=T1H&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

tmfc

발표시간

연월일시분(KST)
- (2024.3.4. 오전 10시 이후) 10분 간격 발표
- (2024.3.4. 오전 10시 이전) 1시간(매 정시) 간격 발표

vars

변수

T1H(기온), UUU(동서바람성분), VVV(남북바람성분), VEC(풍향), WSD(풍속), PTY(강수형태), RN1(1시간 강수량), REH(상대습도)

authKey

인증키

발급된 API 인증키

호출URL정보

동네예보 격자 번호 → 위·경도 변환

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-dfs_xy_lonlat?x=60&y=127&help=1&authKey=2sHsgP01Si2B7ID9Nbot1Q

임의 위·경도 → 인근 동네예보 격자 번호 변환

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-dfs_xy_lonlat?lon=127.5&lat=36.5&help=0&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

x

동네예보 격자 번호(동서방향)

범위: 1 ~ 149

y

동네예보 격자 번호(남북방향)

범위: 1 ~ 253

lon

임의 경도

범위: 123.310165 ~ 132.774963

lat

임의 위도

범위: 31.651814 ~ 43.393490

help

도움말

0(도움말 정보 표시 안됨), 1(도움말 정보 표시)

authKey

인증키

발급된 API 인증키

출력결과

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

lon

격자 경도

lat

격자 위도

x

동네예보 격자 번호(동서방향)

y

동네예보 격자 번호(남북방향)

3. 동네예보 통보문 조회

동네예보 지점목록 참고자료

호출URL정보

기상개황조회

https://apihub.kma.go.kr/api/typ02/openApi/VilageFcstMsgService/getWthrSituation?pageNo=1&numOfRows=10&dataType=XML&stnId=108&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

stnId

발표관서

108 기상청, 109 수도권(서울)..등 별첨 엑셀자료 참조(‘개황’ 구분 값 참고)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stnId

발표관서

tmFc

발표시간

wfSv1

기상개황(종합)

wn

특보사항

wr

예비특보

호출URL정보

육상예보조회

https://apihub.kma.go.kr/api/typ02/openApi/VilageFcstMsgService/getLandFcst?pageNo=1&numOfRows=10&dataType=XML®Id=11A00101&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

regId

예보구역코드

11A00101(백령도), 11B10101 (서울), 11B20201(인천) 등... 별첨 엑셀자료 참조(‘육상’ 구분 값 참고)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

regId

예보구역코드

announceTime

발표시간

numEf

발효번호(발표시간기준)

wd1

풍향(1)

wdTnd

풍향연결코드

wd2

풍향(2)

wsIt

풍속 강도코드

ta

예상기온(℃)

rnSt

강수확률

wf

날씨

wfCd

날씨코드(하늘상태)

rnYn

강수형태

호출URL정보

해상예보조회

https://apihub.kma.go.kr/api/typ02/openApi/VilageFcstMsgService/getSeaFcst?pageNo=1&numOfRows=10&dataType=XML®Id=12A20100&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

regId

예보구역코드

12A20100 (서해중부앞바다), 12B20100(남해동부앞바다) 등... 별첨 엑셀자료 참조(‘해상’ 구분 값 참고)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

regId

예보구역코드

tmFc

발표시간

numEf

발효번호

wd1

풍향1

wdTnd

풍향연결코드

wd2

풍향(2)

ws1

풍속1(m/s)

ws2

풍속2(m/s)

wh1

파고1(m)

wh2

파고2(m)

wf

날씨

wfCd

날씨예보코드

rnYn

강수형태

4. 동네예보(초단기실황·초단기예보·단기예보) 조회

동네예보 지점 좌표(위경도) 참고자료

API 활용가이드 참고자료

호출URL정보

초단기실황조회

https://apihub.kma.go.kr/api/typ02/openApi/VilageFcstInfoService_2.0/getUltraSrtNcst?pageNo=1&numOfRows=1000&dataType=XML&base_date=20210628&base_time=0600&nx=55&ny=127&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

base_date

발표일자

‘21년 6월 28일 발표

base_time

발표시각

06시 발표(정시단위)

nx

예보지점 X 좌표

예보지점의 X 좌표값

ny

예보지점 Y 좌표

예보지점의 Y 좌표값

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

baseDate

발표일자

baseTime

발표시각

nx

예보지점 X 좌표

ny

예보지점 Y 좌표

category

자료구분코드

obsrValue

실황 값

호출URL정보

초단기예보조회

https://apihub.kma.go.kr/api/typ02/openApi/VilageFcstInfoService_2.0/getUltraSrtFcst?pageNo=1&numOfRows=1000&dataType=XML&base_date=20210628&base_time=0630&nx=55&ny=127&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

base_date

발표일자

‘21년 6월 28일 발표

base_time

발표시각

06시30분 발표(30분 단위)

nx

예보지점 X 좌표

예보지점 X 좌표값

ny

예보지점 Y 좌표

예보지점 Y 좌표값

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

baseDate

발표일자

baseTime

발표시각

nx

예보지점 X 좌표

ny

예보지점 Y 좌표

category

자료구분코드

fcstDate

예측일자

fcstTime

예측시간

fcstValue

예보 값

호출URL정보

단기예보조회

https://apihub.kma.go.kr/api/typ02/openApi/VilageFcstInfoService_2.0/getVilageFcst?pageNo=1&numOfRows=1000&dataType=XML&base_date=20210628&base_time=0500&nx=55&ny=127&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

base_date

발표일자

‘21년 6월 28일발표

base_time

발표시각

05시 발표

nx

예보지점 X 좌표

예보지점의 X 좌표값

ny

예보지점 Y 좌표

예보지점의 Y 좌표값

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

baseDate

발표일자

baseTime

발표시각

fcstDate

예보일자

fcstTime

예보시각

category

자료구분문자

fcstValue

예보 값

nx

예보지점 X 좌표

ny

예보지점 Y 좌표

호출URL정보

예보버전조회

https://apihub.kma.go.kr/api/typ02/openApi/VilageFcstInfoService_2.0/getFcstVersion?pageNo=1&numOfRows=1000&dataType=XML&ftype=ODAM&basedatetime=202106280800&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

ftype

파일구분

파일구분 -ODAM: 동네예보실황 -VSRT: 동네예보초단기 -SHRT: 동네예보단기

basedatetime

발표일시분

각각의 base_time 로 검색

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

version

파일버전

filetype

파일구분

5. (그래픽) 동네예보 분포도

호출URL정보

https://apihub.kma.go.kr/api/typ03/cgi/dfs/nph-dfs_shrt_ana_5d_test?data0=GEMD&data1=PTY&tm_ef=202212260000&tm_fc=202212221400&dtm=H0&map=G1&mask=M&color=E&size=600&effect=NTL&overlay=S&zoom_rate=2&zoom_level=0&zoom_x=0000000&zoom_y=0000000&auto_man=m&mode=I&interval=1&rand=1412&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

data0

자료 종류

data1

변수 종류

tm_ef

기준시간2

tm_fc

기준시간1

dtm

시간이동단위 및 이동값

map

지도 종류

mask

이미지 내륙구분

color

이미지 색상표

size

이미지 크기

effect

이미지 효과

overlay

이미지 중첩

zoom_rate

확대율

auto_man

자동(a), 수동(m)

mode

표출양식

html(H), image(I), auto(A), file(F)

interval

1시간 간격 표출

rand

난수: 이미지 재생성 시간간격(분)

authKey

인증키

발급된 API 인증키

6. (그래픽) 초단기예보 분포도

호출URL정보

https://apihub.kma.go.kr/api/typ03/cgi/dfs/nph-dfs_vsrt_ana2?data0=GEMD&tm_fc=202212221420&data1=SKY&tm_ef=202212221500&dtm=H0&map=G1&mask=M&color=E&size=600&effect=GTL&overlay=S&zoom_rate=2&zoom_level=0&zoom_x=0000000&zoom_y=0000000&auto_man=m&mode=I&rand=2937&authKey=2sHsgP01Si2B7ID9Nbot1Q

요청인자

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

tm_fc

기준시간1

data0

자료 종류

data1

변수 종류

tm_ef

기준시간2

dtm

시간이동단위 및 이동값

map

지도 종류

mask

이미지 내륙구분

color

이미지 색상표

size

이미지 크기

effect

이미지 효과

overlay

이미지 중첩

auto_man

자동(a), 수동(m)

mode

표출양식

rand

난수: 이미지 재생성 시간간격(분)

authKey

인증키

발급된 API 인증키