지상관측

목측과 자동기상관측장비, 황사관측장비 등으로 관측한 일기현상, 기온, 강수, 바람, 황사, 자외선 등의 데이터를 제공합니다.

api 상세
개요

종관기상관측이란 정해진 시각의 대기 상태를 파악하기 위해 모든 관측소에서 같은 시각에 실시하는 지상관측을 말합니다. 시정, 구름, 증발량, 일기현상 등 일부 목측 요소를 제외하고 종관기상관측장비(ASOS, Automated Synoptic Observing System)를 이용해 자동으로 관측합니다.

요 소

기온, 강수, 기압, 습도, 풍향, 풍속, 일사, 일조, 적설, 구름, 시정, 지면 · 초상온도 등

지 점

96지점 (2020. 4. 1. 기준)

보유기간

1904년 4월 ~ 현재(지점별 상이함)

생산주기

분, 시간, 일, 월, 연 자료

1. 지상 관측자료 조회

국제기상전보식(2012) 참고자료

호출URL정보

시간자료

https://apihub.kma.go.kr/api/typ01/url/kma_sfctm2.php?tm=202211300900&stn=0&help=1&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

tm

년월일시분(KST)년월일(KST)

해당 시간 (없으면 현재시간)

stn

지점번호

해당 지점들(:로 구분)의 정보 표출 (0 이거나 없으면 전체지점)

help

도움말추가

1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)

authKey

인증키

발급된 API 인증키

출력결과

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

TM

관측시각 (KST)

STN

국내 지점번호

WD

풍향 (16방위)

WS

풍속 (m/s)

GST_WD

돌풍향 (16방위)

GST_WS

돌풍속 (m/s)

GST_TM

돌풍속이 관측된 시각 (시분)

PA

현지기압 (hPa)

PS

해면기압 (hPa)

PT

기압변화경향 (Code 0200)

PR

기압변화량 (hPa)

TA

기온 (C)

TD

이슬점온도 (C)

HM

상대습도 (%)

PV

수증기압 (hPa)

RN

강수량 (mm)

RN_DAY

위 관측시간까지의 일강수량 (mm)

RN_INT

강수강도 (mm/h)

SD_HR3

3시간 신적설 (cm)

SD_DAY

일 신적설 (cm)

SD_TOT

적설 (cm)

WC

GTS 현재일기 (Code 4677)

WP

GTS 과거일기 (Code 4561)

WW

국내식 일기코드 (문자열 22개)

CA_TOT

전운량 (1/10)

CA_MID

중하층운량 (1/10)

CH_MIN

최저운고 (100m)

CT

운형 (문자열 8개)

CT_TOP

GTS 상층운형 (Code 0509)

CT_MID

GTS 중층운형 (Code 0515)

CT_LOW

GTS 하층운형 (Code 0513)

VS

시정 (10m)

SS

일조 (hr)

SI

일사 (MJ/m2)

ST_GD

지면상태 코드 (코드는 기상자원과 문의)

TS

지면온도 (C)

TE_005

5cm 지중온도 (C)

TE_01

10cm 지중온도 (C)

TE_02

20cm 지중온도 (C)

TE_03

30cm 지중온도 (C)

ST_SEA

해면상태 코드 (코드는 기상자원과 문의)

WH

파고 (m)

BF

Beaufart 최대풍력(GTS코드)

IR

강수자료

IX

유인관측/무인관측

RN_JUN

일강수량(mm)

호출URL정보

시간자료(기간 조회)

https://apihub.kma.go.kr/api/typ01/url/kma_sfctm3.php?tm1=201512110100&tm2=201512140000&stn=108&help=1&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

tm1

년월일시분(KST)년월일(KST)

기간: 시작시간 또는 시작일 (없으면 현재시간)

tm2

년월일시분(KST)년월일(KST)

기간: 종료시간 또는 종료일 (없으면 현재시간)

stn

지점번호

해당 지점들(:로 구분)의 정보 표출 (0 이거나 없으면 전체지점)

help

도움말추가

1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)

authKey

인증키

발급된 API 인증키

출력결과

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

TM

관측시각 (KST)

STN

국내 지점번호

WD

풍향 (16방위)

WS

풍속 (m/s)

GST_WD

돌풍향 (16방위)

GST_WS

돌풍속 (m/s)

GST_TM

돌풍속이 관측된 시각 (시분)

PA

현지기압 (hPa)

PS

해면기압 (hPa)

PT

기압변화경향 (Code 0200)

PR

기압변화량 (hPa)

TA

기온 (C)

TD

이슬점온도 (C)

HM

상대습도 (%)

PV

수증기압 (hPa)

RN

강수량 (mm)

RN_DAY

위 관측시간까지의 일강수량 (mm)

RN_INT

강수강도 (mm/h)

SD_HR3

3시간 신적설 (cm)

SD_DAY

일 신적설 (cm)

SD_TOT

적설 (cm)

WC

GTS 현재일기 (Code 4677)

WP

GTS 과거일기 (Code 4561)

WW

국내식 일기코드 (문자열 22개)

CA_TOT

전운량 (1/10)

CA_MID

중하층운량 (1/10)

CH_MIN

최저운고 (100m)

CT

운형 (문자열 8개)

CT_TOP

GTS 상층운형 (Code 0509)

CT_MID

GTS 중층운형 (Code 0515)

CT_LOW

GTS 하층운형 (Code 0513)

VS

시정 (10m)

SS

일조 (hr)

SI

일사 (MJ/m2)

ST_GD

지면상태 코드 (코드는 기상자원과 문의)

TS

지면온도 (C)

TE_005

5cm 지중온도 (C)

TE_01

10cm 지중온도 (C)

TE_02

20cm 지중온도 (C)

TE_03

30cm 지중온도 (C)

ST_SEA

해면상태 코드 (코드는 기상자원과 문의)

WH

파고 (m)

BF

Beaufart 최대풍력(GTS코드)

IR

강수자료

IX

유인관측/무인관측

RN_JUN

일강수량 (mm)

호출URL정보

일자료

https://apihub.kma.go.kr/api/typ01/url/kma_sfcdd.php?tm=20150715&stn=0&help=1&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

tm

년월일시분(KST)년월일(KST)

해당 시간 (없으면 현재시간)

stn

지점번호

해당 지점들(:로 구분)의 정보 표출 (0 이거나 없으면 전체지점)

disp

표출

0(빈칸없는 CSV파일), 1(일정 간격)

help

도움말추가

1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)

authKey

인증키

발급된 API 인증키

출력결과

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

TM

관측시각 (KST)

STN

국내 지점번호

RN_DAY

위 관측시간까지의 일강수량 (mm)

CA_TOT

전운량 (1/10)

WS_AVG

일 평균 풍속 (m/s)

WR_DAY

일 풍정 (m)

WD_MAX

최대풍향

WS_MAX

최대풍속 (m/s)

WS_MAX_TM

최대풍속 시각 (시분)

WD_INS

최대순간풍향

WS_INS

최대순간풍속 (m/s)

WS_INS_TM

최대순간풍속 시각 (시분)

TA_AVG

일 평균기온 (C)

TA_MAX

최고기온 (C)

TA_MAX_TM

최고기온 시가 (시분)

TA_MIN

최저기온 (C)

TA_MIN_TM

최저기온 시각 (시분)

TD_AVG

일 평균 이슬점온도 (C)

TS_AVG

일 평균 지면온도 (C)

TG_MIN

일 최저 초상온도 (C)

HM_AVG

일 평균 상대습도 (%)

HM_MIN

최저습도 (%)

HM_MIN_TM

최저습도 시각 (시분)

PV_AVG

일 평균 수증기압 (hPa)

EV_S

소형 증발량 (mm)

EV_L

대형 증발량 (mm)

FG_DUR

안개계속시간 (hr)

PA_AVG

일 평균 현지기압 (hPa)

PS_AVG

일 평균 해면기압 (hPa)

PS_MAX

최고 해면기압 (hPa)

PS_MAX_TM

최고 해면기압 시각 (시분)

PS_MIN

최저 해면기압 (hPa)

PS_MIN_TM

최저 해면기압 시각 (시분)

SS_DAY

일조합 (hr)

SS_DUR

가조시간 (hr)

SS_CMB

캄벨 일조 (hr)

SI_DAY

일사합 (MJ/m2)

RN_D99

9-9 강수량 (mm)

RN_DUR

강수계속시간 (hr)

SD_NEW

최심 신적설 (cm)

SD_NEW_TM

최심 신적설 시각 (시분)

SD_MAX

최심 적설 (cm)

SD_MAX_TM

최심 적설 시각 (시분)

TE_05

0.5m 지중온도 (C)

TE_10

1.0m 지중온도 (C)

TE_15

1.5m 지중온도 (C)

TE_30

3.0m 지중온도 (C)

TE_50

5.0m 지중온도 (C)

SI_60M_MAX

최대 1시간일사 (MJ/m2)

SI_60M_MAX_TM

최대 1시간일사 시각

RN_60M_MAX

1시간 최다강수량 (mm)

RN_60M_MAX_TM

1시간 최다강수량 시각

RN_10M_MAX

10분간 최다강수량 (mm)

RN_10M_MAX_TM

10분간 최다강수량 시각 (시분)

RN_POW_MAX

최대 강우강도 (mm/h)

RN_POW_MAX_TM

최대 강우강도 시각 (시분)

호출URL정보

일자료(기간 조회)

https://apihub.kma.go.kr/api/typ01/url/kma_sfcdd3.php?tm1=20151211&tm2=20151214&stn=108&help=1&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

tm

년월일시분(KST)년월일(KST)

해당 시간 (없으면 현재시간)

tm1

년월일시분(KST)년월일(KST)

기간: 시작시간 또는 시작일 (없으면 현재시간)

tm2

년월일시분(KST)년월일(KST)

기간: 종료시간 또는 종료일 (없으면 현재시간)

obs

관측종류

TA(기온), TD(이슬점온도), HM(습도), PV(증기압), PA(현지기압), PS(해면기압), CA_TOT(전운량), CA_MID(중하층운량), CH_MIN(최저온고(100m)),CT(운형(통계표)), VS(시정(10m)), TS(지면온도)

stn

지점번호

해당 지점들(:로 구분)의 정보 표출 (0 이거나 없으면 전체지점)

help

도움말추가

1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)

mode

기타

0:해독결과만 표출, 1:기사도 표출, 2:기사만 표출

authKey

인증키

발급된 API 인증키

출력결과

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

TM

관측시각 (KST)

STN

국내 지점번호

WD

풍향 (16방위)

WS

풍속 (m/s)

GST_WD

돌풍향 (16방위)

GST_WS

돌풍속 (m/s)

GST_TM

돌풍속이 관측된 시각 (시분)

PA

현지기압 (hPa)

PS

해면기압 (hPa)

PT

기압변화경향 (Code 0200)

PR

기압변화량 (hPa)

TA

기온 (C)

TD

이슬점온도 (C)

HM

상대습도 (%)

PV

수증기압 (hPa)

RN

강수량 (mm)

RN_DAY

위 관측시간까지의 일강수량 (mm)

RN_INT

강수강도 (mm/h)

SD_HR3

3시간 신적설 (cm)

SD_DAY

일 신적설 (cm)

SD_TOT

적설 (cm)

WC

GTS 현재일기 (Code 4677)

WP

GTS 과거일기 (Code 4561)

WW

국내식 일기코드 (문자열 22개)

CA_TOT

전운량 (1/10)

CA_MID

중하층운량 (1/10)

CH_MIN

최저운고 (100m)

CT

운형 (문자열 8개)

CT_TOP

GTS 상층운형 (Code 0509)

CT_MID

GTS 중층운형 (Code 0515)

CT_LOW

GTS 하층운형 (Code 0513)

VS

시정 (10m)

SS

일조 (hr)

SI

일사 (MJ/m2)

ST_GD

지면상태 코드 (코드는 기상자원과 문의)

TS

지면온도 (C)

TE_005

5cm 지중온도 (C)

TE_01

10cm 지중온도 (C)

TE_02

20cm 지중온도 (C)

TE_03

30cm 지중온도 (C)

ST_SEA

해면상태 코드 (코드는 기상자원과 문의)

WH

파고 (m)

BF

Beaufart 최대풍력(GTS코드)

IR

강수자료

IX

유인관측/무인관측

RN_JUN

일강수량 (mm)

WS_AVG

일 평균 풍속 (m/s)

WR_DAY

일 풍정 (m)

WD_MAX

최대풍향

WS_MAX

최대풍속 (m/s)

WS_MAX_TM

최대풍속 시각 (시분)

WD_INS

최대순간풍향

WS_INS

최대순간풍속 (m/s)

WS_INS_TM

최대순간풍속 시각 (시분)

TA_AVG

일 평균기온 (C)

TA_MAX

최고기온 (C)

TA_MAX_TM

최고기온 시가 (시분)

TA_MIN

최저기온 (C)

TA_MIN_TM

최저기온 시각 (시분)

TD_AVG

일 평균 이슬점온도 (C)

TS_AVG

일 평균 지면온도 (C)

TG_MIN

일 최저 초상온도 (C)

HM_AVG

일 평균 상대습도 (%)

HM_MIN

최저습도 (%)

HM_MIN_TM

최저습도 시각 (시분)

PV_AVG

일 평균 수증기압 (hPa)

EV_S

소형 증발량 (mm)

EV_L

대형 증발량 (mm)

FG_DUR

안개계속시간 (hr)

PA_AVG

일 평균 현지기압 (hPa)

PS_AVG

일 평균 해면기압 (hPa)

PS_MAX

최고 해면기압 (hPa)

PS_MAX_TM

최고 해면기압 시각 (시분)

PS_MIN

최저 해면기압 (hPa)

PS_MIN_TM

최저 해면기압 시각 (시분)

SS_DAY

일조합 (hr)

SS_DUR

가조시간 (hr)

SS_CMB

캄벨 일조 (hr)

SI_DAY

일사합 (MJ/m2)

RN_D99

9-9 강수량 (mm)

RN_DUR

강수계속시간 (hr)

SD_NEW

최심 신적설 (cm)

SD_NEW_TM

최심 신적설 시각 (시분)

SD_MAX

최심 적설 (cm)

SD_MAX_TM

최심 적설 시각 (시분)

TE_05

0.5m 지중온도 (C)

TE_10

1.0m 지중온도 (C)

TE_15

1.5m 지중온도 (C)

TE_30

3.0m 지중온도 (C)

TE_50

5.0m 지중온도 (C)

S

1(기사), 0(해독결과)

TMST

시작시각(시분,KST)

TMED

종료시각(시분,KST)

DTM

종료시각-시작시각(분)

ST

강도

DIR

방향, 직경 등

LON

경도 (deg)

LAT

위도 (deg)

HT

노장 해발고도 (m)

VAL

조회된 값

호출URL정보

요소별 조회

https://apihub.kma.go.kr/api/typ01/url/kma_sfctm5.php?tm2=201504060900&obs=TA&stn=0&disp=0&help=1&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

tm1

년월일시분(KST)년월일(KST)

기간: 시작시간 또는 시작일 (없으면 현재시간)

tm2

년월일시분(KST)년월일(KST)

기간: 종료시간 또는 종료일 (없으면 현재시간)

obs

관측종류

TA(기온), TD(이슬점온도), HM(습도), PV(증기압), PA(현지기압), PS(해면기압), CA_TOT(전운량), CA_MID(중하층운량), CH_MIN(최저온고(100m)),CT(운형(통계표)), VS(시정(10m)), TS(지면온도)

stn

지점번호

해당 지점들(:로 구분)의 정보 표출 (0 이거나 없으면 전체지점)

help

도움말추가

1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)

authKey

인증키

발급된 API 인증키

출력결과

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

TM

관측시각 (KST)

STN

국내 지점번호

LON

경도 (deg)

LAT

위도 (deg)

HT

노장 해발고도 (m)

VAL

조회된 값

2. 지상 평년값 조회

호출URL정보

https://apihub.kma.go.kr/api/typ01/url/sfc_norm1.php?norm=D&tmst=2021&stn=0&MM1=5&DD1=1&MM2=5&DD2=2&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

norm

평년종류

D(일), S(순), M(월), Y(연)

tmst

평년기간

1991(1961~1990년), 2001(1971~2000년), 2011(1981~2010년), 2021(1991~2020년)

stn

지점번호

지점번호, 0이면 전체지점

MM1

시작 월

기간 : MM1월 DD1일 ~ MM2월 DD2일

DD1

시작 일

순별 평년값인 경우, 100(상순), 200(중순), 300(하순)

authKey

인증키

발급된 API 인증키

출력결과

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

ST

1991(1961~1990년), 2001(1971~2000년), 2011(1981~2010년), 2021(1991~2020년)

STN

지점번호

MM

DD

일 (순별 평년값인 경우, 100(상순) 200(중순) 300(하순)

TA

기온(C)

TA_MAX

최고기온(C)

TA_MIN

최저기온(C)

RN

깅수량(mm)

RN_DUR

강수계속시간(hr)

EV

소형증발량(mm)

WS

풍속(m/s)

HM

상대습도(%)

PV

수증기압(hPa)

SS

일조시간(hr)

SI

일사합(MJ/m2)

FG_DUR

안개계속시간(hr)

CA_TOT

전운량(1/10)

PA

현지기압(hPa)

PS

해면기압(hPa)

TG_MIN

초상최저기온(hPa)

TS

지면온도(C)

TE_005

0.05m 지중온도(C)

TE_01

0.1m 지중온도(C)

TE_02

0.2m 지중온도(C)

TE_03

0.3m 지중온도(C)

TE_05

0.5m 지중온도(C)

TE_10

1.0m 지중온도(C)

TE_15

1.5m 지중온도(C)

TE_30

3.0m 지중온도(C)

TE_50

5.0m 지중온도(C)

RD_01

0.1mm이상 강수일수

RD_10

1.0mm이상 강수일수

WD_DN

폭풍일수

NS_DN

부조일수(일조=0)

3. 지상기상연보 조회

호출URL정보

연요약자료조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcYearlyInfoService/getYearSumry?pageNo=1&numOfRows=10&dataType=XML&year=2016&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년

2016년 발표

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

Stn_id

지점번호

Stn_ko

지점명

Va_lst_01

평균해면기압

Va_lst_02

평년차

Va_lst_03

평균기온

Va_lst_04

기온 평년차

Va_lst_05

최고평균기온

Va_lst_06

최고기온

Va_lst_07

나타난날

Va_lst_08

최저평균기온

Va_lst_09

최저최저기온

Va_lst_10

나타난날

Va_lst_11

강수량 총량

Va_lst_12

강수량 평년차

Va_lst_13

1일 최다 강수량

Va_lst_14

나타난 날

Va_lst_15

6시간 최다강수량

Va_lst_16

나타난 날

Va_lst_17

일수

Va_lst_18

일수

호출URL정보

연요약자료(2)조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcYearlyInfoService/getYearSumry2?pageNo=1&numOfRows=10&dataType=XML&year=2016&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년

2016년 발표

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

Stn_id

지점번호

Stn_ko

지점명

Va_lst_01

평균상대습도

Va_lst_02

총증발량

Va_lst_03

일조 총시간

Va_lst_04

일조 평년차

Va_lst_05

일조율

Va_lst_06

일조 계급일수

Va_lst_07

일조 계급일수

Va_lst_08

일조 계급일수

Va_lst_09

바람 평균풍속

Va_lst_10

바람 평년차

Va_lst_11

바람 폭풍일수

Va_lst_12

바람 최다풍향

Va_lst_13

현상일수(운량)

Va_lst_14

현상일수(운량)

Va_lst_15

현상일수(뇌전)

Va_lst_16

현상일수(안개)

Va_lst_17

현상일수(서리)

Va_lst_18

현상일수(결빙)

Va_lst_19

현상일수(적설)

호출URL정보

평균기온평년차조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcYearlyInfoService/getAvgTaAnamaly?pageNo=1&numOfRows=10&dataType=XML&year=2016&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년

2016년 발표

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

Stn_id

지점번호

Stn_ko

지점명

Va_mon_{해당월}

평년차

호출URL정보

강수량평년차

https://apihub.kma.go.kr/api/typ02/openApi/SfcYearlyInfoService/getRnAnamaly?pageNo=1&numOfRows=10&dataType=XML&year=2016&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년

2016년 발표

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

Stn_id

지점번호

Stn_ko

지점명

va_mon_{해당월}

강수량 평년차

호출URL정보

지점별현상데이터조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcYearlyInfoService/getStnPhnmnData?pageNo=1&numOfRows=10&dataType=XML&year=2016&station=140&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년

2016년 발표

station

지점번호

지점번호

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

Stn_id

지점번호

Stn_ko

지점명

Stn_En

지점(영문)

Str

이하 자료 내용 설명

Va_mon_{월}

Str에 명시되어 있는 데이터

호출URL정보

지점별현상데이터(2)조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcYearlyInfoService/getStnPhnmnData2?pageNo=1&numOfRows=10&dataType=XML&year=2016&station=140&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년

2016년 발표

station

지점번호

지점번호

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

Stn_id

지점번호

Stn_ko

지점명

Stn_En

지점(영문)

Str

이하 자료 내용 설명

Va_mon_{월}

Str에 명시되어 있는 데이터

호출URL정보

지점별현상데이터(3)조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcYearlyInfoService/getStnPhnmnData3?pageNo=1&numOfRows=10&dataType=XML&year=2016&station=140&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년

2016년 발표

station

지점번호

지점번호

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

Stn_id

지점번호

Stn_ko

지점명

Stn_En

지점(영문)

Str

이하 자료 내용 설명

Va_mon_{월}

Str에 명시되어 있는 데이터

4. 지상기상월보 조회

호출URL정보

일러두기조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcMtlyInfoService/getNote?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

year

발표년도

2016년 발표

month

발표월

09월 발표

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

응답자료형식

note

일러두기

호출URL정보

지상관측지점일람표조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcMtlyInfoService/getSfcStnLstTbl?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

year

발표년도

2016년 발표

month

발표월

09월 발표

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stn_id

지점번호

stn_ko

지역명(국문)

stn_en

지역명(영문)

lat

북위

lon

동경

ht

노장의 해발높이

ht_pa

기업계의 해발높이

ht_ta

온도계의 높이

ht_wd

풍속계의 지상높이

ht_rn

우량계의 지상높이

호출URL정보

월요약자료조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcMtlyInfoService/getMmSumry?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

year

발표년도

2016년 발표

month

발표월

09월 발표

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stnid

지역번호

stnko

지역명(국문)

pa

기압-평균현지

ps

기압-평균해면

avgtamax

기온-최고-평균

avgtamin

기온-최저-평균

taavg

기온-평균

tamax

기온-최고-최고

avgtgmin

평균최저초상온도

ta

기온-평년차

tmmax

기온-최고-나타난 날

tmmin

기온-최저-나타난 날

maxcnt

기온-계급일수-최고

mincnt

기온-계급일수-최저

avghm

평균상대습도

avgcatot

평균운량

sumssday

일조-총시간

avgte05

평균지중온도

daydur

일조-일조율

tamin

기온-최저-최저

호출URL정보

월요약자료(2)조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcMtlyInfoService/getMmSumry2?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

year

발표년도

2016년 발표

month

발표월

09월 발표

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stnid

지역번호

stnko

지역명(국문)

rn_day

강수량 총량(mm)

rn

강수량 평년차(mm)

max_rn_day

1일 최다 강수량(mm)

tm_rn_day

1일 최다 강수량이 나타난 날

rn_day_cnt1

강수량 계급일수(>=0.1mm)

rn_day_cnt2

강수량 계급일수(>=1.0mm)

rn_day_cnt3

강수량 계급일수(>=10.0mm)

rn_day_cnt4

강수량 계급일수(>=30.0mm)

ev_s

총증발량(mm)

ws

평균풍속(m/s)

ws_max

최대풍속(m/s)

wd_max

최대풍향(16방위)

tm_max

최대 풍속이 나타난 날

cnt1

현상일수(운량,<2.5)

cnt2

현상일수(운량,>=7.5)

cnt3

현상일수(부조)

cnt4

현상일수(안개)

cnt5

현상일수(폭풍)

cnt6

현상일수(낙뢰)

cnt7

현상일수(눈)

cnt8

현상일수(서리)

cnt9

현상일수(결빙)

호출URL정보

해당월의일별기상자료조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcMtlyInfoService/getDailyWthrData?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&station=90&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

year

발표년도

2016년 발표

month

발표월

09월 발표

station

지점번호

90번 지점

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

Stn_id

지역번호

Stn_ko

지역명(국문)

Stn_en

지역명(영문)

tm

날짜

ps

평균해면기압

ta

기온-평균

ta_max

기온-최고

ta_min

기온-최저

td

평균이슬점온도

tg_min

최저초상온도

hm

상대습도-평균

hm_min

상대습도-최소

ev_s

증발량

ws

바람-평균풍속

ws_max

바람-최대 풍속

wd_max

바람-최대 풍속

ca_tot

평균 운량

ss_day

일조시간

si_day

수평명일사량

rn_day

강수량

sd_new

최심신적설

sd_max

최심적설

5. (그래픽) 지상기상현상(관서) 조회

호출URL정보

현상(관서)

https://apihub.kma.go.kr/api/typ03/php/alw/sfc/sfc_ww_pnt.php?obs=ww_sfc&tm=202212221120&val=1&stn=1&obj=mq&map=HR&grid=2&legend=1&size=600&itv=5&zoom_level=0&zoom_x=0000000&zoom_y=0000000&gov=&authKey=pUXotX9hRMyF6LV_YQTMnA

요청인자

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

obs

관측자료 종류

tm

조회할 자료시각

YYYYMMDDHHM

stn

지점정보 포함

0 : 최대최소값만
1 : 영역내 지점값 포함
2 : 지점값만

map

지도코드

D2 : 남한
D3 : 남한
R : 레이더
B : 한반도
H1 : 한반도

legend

범례 표시 여부

0 : 표시하지 않음
1 : 표시

size

이미지 크기

(가로, 세로 pixel)

itv

시간간격

(분)

val

authKey

인증키

발급된 API 인증키