초단기, 단기, 중기예보의 기온, 바람, 강수량 등 데이터를 제공하며, 폭염, 한파, 호우 등 10종의 기상특보(주의보, 경보) 데이터를 제공합니다.
개요 | 단기예보란 예보기간과 구역을 시 · 공간적으로 세분화하여 발표하는 예보입니다. 지역별, 시간별 차이로 인한 수요자의 불편을 최소화하기 위해 전국을 5km * 5km 간격의 격자(동서 149(745km) × 남북 253(1.265km)), 총 37,697개로 나누어, 3시간 마다 읍, 면, 동 단위의 행정구역 중심으로 상세한 날씨를 제공합니다. |
---|---|
요 소 | 3시간 기온, 낮 최고기온, 아침 최저기온, 풍향, 풍속, 동서바람성분, 남북바람성분, 하늘상태, 강수형태, 강수확률, 6시간 강수량, 6시간 신적설, 습도, 파고 |
지 점 | 동사무소를 중심으로 하는 행정구역 |
보유기간 | 2008년 10월 30일 17:00KST(시행일 기준) ~ 현재 |
생산주기 | 2시부터 3시간 간격(일 8회) |
단기예보 DB테이블 참고자료
https://apihub.kma.go.kr/api/typ01/url/fct_shrt_reg.php?tmfc=0&authKey=2sHsgP01Si2B7ID9Nbot1Q
인자명 | 의미 | 설명 |
---|---|---|
stn |
발표관서번호 |
없으면 전체 |
reg |
예보구역코드 |
없으면 전체 |
tmfc |
발표시간 |
예보구역조회에서 사용(기준시각의미, 년월일시(KST))
|
tmfc1 |
발표시간
|
기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
|
tmfc2 |
발표시간
|
기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
|
tmef1 |
발효시간
|
기간: [tmef1 ~ tmef2] : 년월일시(KST)
|
tmef2 |
발효시간
|
기간: [tmef1 ~ tmef2] : 년월일시(KST)
|
disp |
표출형태 |
0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
|
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 |
예보 |
인자명 | 의미 | 설명 |
---|---|---|
stn |
발표관서번호 |
없으면 전체 |
reg |
예보구역코드 |
없으면 전체 |
tmfc |
발표시간 |
예보구역조회에서 사용(기준시각의미, 년월일시(KST))
|
tmfc1 |
발표시간
|
기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
|
tmfc2 |
발표시간
|
기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
|
tmef1 |
발효시간
|
기간: [tmef1 ~ tmef2] : 년월일시(KST)
|
tmef2 |
발효시간
|
기간: [tmef1 ~ tmef2] : 년월일시(KST)
|
disp |
표출형태 |
0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
|
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 |
예보 |
인자명 | 의미 | 설명 |
---|---|---|
stn |
발표관서번호 |
없으면 전체 |
reg |
예보구역코드 |
없으면 전체 |
tmfc |
발표시간 |
예보구역조회에서 사용(기준시각의미, 년월일시(KST))
|
tmfc1 |
발표시간
|
기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
|
tmfc2 |
발표시간
|
기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
|
tmef1 |
발효시간
|
기간: [tmef1 ~ tmef2] : 년월일시(KST)
|
tmef2 |
발효시간
|
기간: [tmef1 ~ tmef2] : 년월일시(KST)
|
disp |
표출형태 |
0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
|
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 |
예보 |
인자명 | 의미 | 설명 |
---|---|---|
stn |
발표관서번호 |
없으면 전체 |
reg |
예보구역코드 |
없으면 전체 |
tmfc |
발표시간 |
예보구역조회에서 사용(기준시각의미, 년월일시(KST))
|
tmfc1 |
발표시간
|
기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
|
tmfc2 |
발표시간
|
기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
|
tmef1 |
발효시간
|
기간: [tmef1 ~ tmef2] : 년월일시(KST)
|
tmef2 |
발효시간
|
기간: [tmef1 ~ tmef2] : 년월일시(KST)
|
disp |
표출형태 |
0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
|
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 |
예보 |
인자명 | 의미 | 설명 |
---|---|---|
stn |
발표관서번호 |
없으면 전체 |
reg |
예보구역코드 |
없으면 전체 |
tmfc |
발표시간 |
예보구역조회에서 사용(기준시각의미, 년월일시(KST))
|
tmfc1 |
발표시간
|
기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
|
tmfc2 |
발표시간
|
기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
|
tmef1 |
발효시간
|
기간: [tmef1 ~ tmef2] : 년월일시(KST)
|
tmef2 |
발효시간
|
기간: [tmef1 ~ tmef2] : 년월일시(KST)
|
disp |
표출형태 |
0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
|
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 (범위 종료값) |
동네예보 격자영역 정보 참고자료
단기예보 예보기간 확대에 따른 변경사항 참고자료
인자명 | 의미 | 설명 |
---|---|---|
tmfc |
발표시간 |
연월일시(KST)
|
tmef |
발효시간 |
년월일시(KST)
|
vars |
예보변수 |
TMP(기온), TMX(최고기온), TMN(최저기온), UUU(동서바람성분), VVV(남북바람성분), VEC(풍향), WSD(풍속), SKY(하늘상태), PTY(강수형태), POP(강수유무), PCP(1시간 강수량), SNO(1시간 신적설), REH(상대습도), WAV(파고) |
authKey |
인증키 |
발급된 API 인증키 |
인자명 | 의미 | 설명 |
---|---|---|
tmfc |
발표시간 |
연월일시분(KST)
|
tmef |
발효시간 |
년월일시(KST)
|
vars |
예보변수 |
T1H(기온), UUU(동서바람성분), VVV(남북바람성분), VEC(풍향), WSD(풍속), SKY(하늘상태), LGT(낙뢰), PTY(강수형태), RN1(1시간 강수량), REH(상대습도) |
authKey |
인증키 |
발급된 API 인증키 |
인자명 | 의미 | 설명 |
---|---|---|
tmfc |
발표시간 |
연월일시분(KST)
|
vars |
변수 |
T1H(기온), UUU(동서바람성분), VVV(남북바람성분), VEC(풍향), WSD(풍속), PTY(강수형태), RN1(1시간 강수량), REH(상대습도) |
authKey |
인증키 |
발급된 API 인증키 |
인자명 | 의미 | 설명 |
---|---|---|
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 |
동네예보 격자 번호(남북방향) |
동네예보 지점목록 참고자료
인자명 | 의미 | 설명 |
---|---|---|
pageNo |
페이지 번호 |
페이지번호 |
numOfRows |
한 페이지 결과 수 |
한 페이지 결과 수 |
dataType |
응답자료형식 |
요청자료형식(XML/JSON)Default: XML |
stnId |
발표관서 |
108 기상청, 109 수도권(서울)..등 별첨 엑셀자료 참조(‘개황’ 구분 값 참고) |
authKey |
인증키 |
발급된 API 인증키 |
변수명 | 의미(단위) | 변수명 | 의미(단위) |
---|---|---|---|
resultCode |
결과코드 |
resultMsg |
결과메시지 |
numOfRows |
한 페이지 결과 수 |
pageNo |
페이지 번호 |
totalCount |
전체 결과 수 |
dataType |
데이터 타입 |
stnId |
발표관서 |
tmFc |
발표시간 |
wfSv1 |
기상개황(종합) |
wn |
특보사항 |
wr |
예비특보 |
인자명 | 의미 | 설명 |
---|---|---|
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 |
강수형태 |
인자명 | 의미 | 설명 |
---|---|---|
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 |
강수형태 |
동네예보 지점 좌표(위경도) 참고자료
API 활용가이드 참고자료
인자명 | 의미 | 설명 |
---|---|---|
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 |
실황 값 |
인자명 | 의미 | 설명 |
---|---|---|
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 |
예보 값 |
인자명 | 의미 | 설명 |
---|---|---|
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 좌표 |
인자명 | 의미 | 설명 |
---|---|---|
pageNo |
페이지 번호 |
페이지번호 |
numOfRows |
한 페이지 결과 수 |
한 페이지 결과 수 |
dataType |
응답자료형식 |
요청자료형식(XML/JSON) Default: XML |
ftype |
파일구분 |
파일구분 -ODAM: 동네예보실황 -VSRT: 동네예보초단기 -SHRT: 동네예보단기 |
basedatetime |
발표일시분 |
각각의 base_time 로 검색 |
authKey |
인증키 |
발급된 API 인증키 |
변수명 | 의미(단위) | 변수명 | 의미(단위) |
---|---|---|---|
resultCode |
결과코드 |
resultMsg |
결과메시지 |
numOfRows |
한 페이지 결과 수 |
pageNo |
페이지 번호 |
totalCount |
전체 결과 수 |
dataType |
데이터 타입 |
version |
파일버전 |
filetype |
파일구분 |
인자명 | 의미 | 설명 |
---|---|---|
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 인증키 |
인자명 | 의미 | 설명 |
---|---|---|
tm_fc |
기준시간1 |
|
data0 |
자료 종류 |
|
data1 |
변수 종류 |
|
tm_ef |
기준시간2 |
|
dtm |
시간이동단위 및 이동값 |
|
map |
지도 종류 |
|
mask |
이미지 내륙구분 |
|
color |
이미지 색상표 |
|
size |
이미지 크기 |
|
effect |
이미지 효과 |
|
overlay |
이미지 중첩 |
|
auto_man |
자동(a), 수동(m) |
|
mode |
표출양식 |
|
rand |
난수: 이미지 재생성 시간간격(분) |
|
authKey |
인증키 |
발급된 API 인증키 |