예특보

초단기, 단기, 중기예보의 기온, 바람, 강수량 등 데이터를 제공하며, 폭염, 한파, 호우 등 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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

tmfc

발표시간

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

tmef

발효시간

년월일시(KST)
- 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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

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=7-5qPg-0Q7Suaj4PtBO09Q

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

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

요청인자

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

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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

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=7-5qPg-0Q7Suaj4PtBO09Q

요청인자

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

tm_fc

기준시간1

data0

자료 종류

data1

변수 종류

tm_ef

기준시간2

dtm

시간이동단위 및 이동값

map

지도 종류

mask

이미지 내륙구분

color

이미지 색상표

size

이미지 크기

effect

이미지 효과

overlay

이미지 중첩

auto_man

자동(a), 수동(m)

mode

표출양식

rand

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

authKey

인증키

발급된 API 인증키