지상관측

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

api 상세
개요

적설이란 고체상의 강수(눈, 싸락눈 등)가 지면에 내려 쌓여 있는 수직 깊이를 말합니다. 눈이 관측장소 또는 관측장소 주위의 지면에 반 이상을 덮었을 때를 적설이 있는 것으로 판단합니다. 목측관측을 비롯하여 레이저식, 초음파식, 영상식 등 적설계로 적설을 측정합니다.

요 소

적설, 신적설

생산주기

일, 3시간, 6시간, 24시간(관측방법에 따라 상이함)

1. 적설관측자료 조회

1.1 적설관측지점

https://apihub.kma.go.kr/api/typ01/url/stn_snow.php?stn=&tm=201601051200&mode=0&help=1&authKey={인증키입력}

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

sd

종류

tot(적설), day(일신적설), 3hr(3시간 신적설), 24h(24시간 신적설)

tm

년월일시분(KST)

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

tm_st

시작
년월일시분(KST)

기간의 경우, 시작시간

snow

표출지점범위

0:적설이 있는 지점만, 1:0+기상대, 2:모든 지점

help

도움말

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

authKey

인증키

발급된 API 인증키

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

STN_ID

지점번호

LON

경도(degree) / LAT

STN_SP

지점 특성코드 (3자리수)

HT

노장 해발고도 (m)

STN_KO

지점명(한글)

STN_AD

관리관서번호

FCT_ID

예보구역코드

LAW_ID

법정동코드

1.2.1 적설

https://apihub.kma.go.kr/api/typ01/url/kma_snow1.php?sd=tot&tm=201412051800&help=1&authKey={인증키입력}

1.2.2 일신적설

https://apihub.kma.go.kr/api/typ01/url/kma_snow1.php?sd=day&tm=201412051800&help=1&authKey={인증키입력}

1.2.3 3시간 신적설

https://apihub.kma.go.kr/api/typ01/url/kma_snow1.php?sd=3hr&tm=201412051800&help=1&authKey={인증키입력}

1.2.4 24시간 신적설

https://apihub.kma.go.kr/api/typ01/url/kma_snow1.php?sd=24h&tm=201412051800&help=1&authKey={인증키입력}

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

sd

종류

tot(적설), day(일신적설), 3hr(3시간 신적설), 24h(24시간 신적설)

tm

년월일시분(KST)

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

tm_st

시작
년월일시분(KST)

기간의 경우, 시작시간

snow

표출지점범위

0:적설이 있는 지점만, 1:0+기상대, 2:모든 지점

help

도움말

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

authKey

인증키

발급된 API 인증키

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

TM

관측시각 (KST)

STN ID

국내 지점번호

STN KO

지점명

LON

경도(degree) / LAT

LAT

위도 (degree)

STN SP

지점특성

SD

적설값 (cm)

SD_TOT

적설값 (cm)

SD_DAY

일신적설값 (cm)

SD_HR3

3HR 신적설값 (cm)

SD_D01

적설에서 계산한 일신적설값 (cm)

SD_H03

적설에서 계산한 3시간 신적설값 (cm)

SD_H24

적설에서 계산한 24시간 신적설값 (cm)

SD_H01

적설에서 계산한 1시간 신적설값 (cm)

1.3 기간

https://apihub.kma.go.kr/api/typ01/url/kma_snow2.php?tm=201412051800&tm_st=201412040100&snow=0&help=1&authKey={인증키입력}

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

sd

종류

tot(적설), day(일신적설), 3hr(3시간 신적설), 24h(24시간 신적설)

tm

년월일시분(KST)

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

tm_st

시작
년월일시분(KST)

기간의 경우, 시작시간

snow

표출지점범위

0:적설이 있는 지점만, 1:0+기상대, 2:모든 지점

help

도움말

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

authKey

인증키

발급된 API 인증키

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

STN_ID

지점번호

LON

경도(degree) / LAT

STN_SP

지점 특성코드 (3자리수)

HT

노장 해발고도 (m)

STN_CD

지점코드

STN_KO

지점명(한글)

STN_AD

관리관서번호

FCT_ID

예보구역코드

LAW_ID

법정동코드

TM

관측시각 (KST)

STN ID

국내 지점번호

STN KO

지점명

LAT

위도 (degree)

STN SP

지점특성

SD

적설값 (cm)

SD_TOT

적설값 (cm)

SD_DAY

일신적설값 (cm)

SD_HR3

3HR 신적설값 (cm)

SD_D01

적설에서 계산한 일신적설값 (cm)

SD_H03

적설에서 계산한 3시간 신적설값 (cm)

SD_H24

적설에서 계산한 24시간 신적설값 (cm)

SD_H01

적설에서 계산한 1시간 신적설값 (cm)

HH:MI

최심값이 처음 나타난 시분 (KST)

1.4.1 최심적설,최심신적설

https://apihub.kma.go.kr/api/typ01/url/kma_snow_day.php?sd=tot&tm=20150131&tm_st=20150125&stn=0&snow=0&help=1&authKey={인증키입력}

1.4.2 최심적설

https://apihub.kma.go.kr/api/typ01/url/kma_snow_day.php?sd=tot&tm=20150131&tm_st=20150125&help=1&authKey={인증키입력}

1.4.3 최심신적설

https://apihub.kma.go.kr/api/typ01/url/kma_snow_day.php?sd=day&tm=20150131&tm_st=20150125&help=1&authKey={인증키입력}

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

sd

종류

tot(적설), day(일신적설), 3hr(3시간 신적설), 24h(24시간 신적설)

tm

년월일시분(KST)

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

tm_st

시작
년월일시분(KST)

기간의 경우, 시작시간

snow

표출지점범위

0:적설이 있는 지점만, 1:0+기상대, 2:모든 지점

help

도움말

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

authKey

인증키

발급된 API 인증키

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

HT

노장 해발고도 (m)

STN_ID

지점번호

LON

경도(degree) / LAT

LAT

위도 (degree)

STN_SP

지점 특성코드 (3자리수)

STN_CD

지점코드

STN_KO

지점명(한글)

STN_AD

관리관서번호

FCT_ID

예보구역코드

LAW_ID

법정동코드

TM

관측시각 (KST)

STN ID

국내 지점번호

STN KO

지점명

STN SP

지점특성

SD

적설값 (cm)

SD_TOT

적설값 (cm)

SD_DAY

일신적설값 (cm)

SD_HR3

3HR 신적설값 (cm)

SD_D01

적설에서 계산한 일신적설값 (cm)

SD_H03

적설에서 계산한 3시간 신적설값 (cm)

SD_H24

적설에서 계산한 24시간 신적설값 (cm)

SD_H01

적설에서 계산한 1시간 신적설값 (cm)

HH:MI

최심값이 처음 나타난 시분 (KST)