고층관측

레윈존데, 연직바람관측장비 등으로 관측한 상층고도별 기온, 습도, 풍향, 풍속 등의 데이터를 제공합니다.

api 상세
개요

라디오존데를 기구에 매달아 비양시켜 지상으로부터 30km이상 상공까지 일정한 시간 간격으로 대기상태를 직 · 간접적으로 관측합니다. 관측자료는 무선 송수신장치를 통해 지상으로 전송되고 지상 수신장치에서 처리됩니다.
기상청은 일 2회 정기 고층기상관측(오전 9시, 오후 9시)을 하고 우리나라에 태풍, 집중호우 등과 같은 위험기상 현상이 발생 또는 예측될 때는 정기관측시각 이외에 3시, 15시에 특별기상관측을 합니다.

요 소

기온, 바람, 기압, 고도, 이슬점온도

지 점

10지점(현행 6지점)
보유기간

1957년 4월 1일 ~ 현재(지점별 상이함)
생산주기

시간 자료

1. 국내 고층(TEMP) 자료 조회

호출URL정보

레윈존데관측

https://apihub.kma.go.kr/api/typ01/url/upp_temp.php?tm=201806210000&stn=0&pa=0&help=1&authKey=zxiqblJaSgSYqm5SWioEeA

요청인자

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

tm

년월일시분(UTC)

조회시각 (없으면 현재시각)

stn

지점번호

해당 지점의 정보 표출, 만일 2-3글자이면 그렇게 시작하는 지점목록(0 이거나 없으면 전체지점)

pa

기압면

0 이거나 없으면 전체 고도 표출

help

도움말추가

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

authKey

인증키

발급된 API 인증키

출력결과

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

STN

지점번호

LAT

위도 (degree)

LON

경도 (degree)

PA

현지기압 (hPa)

PA

등압면 (hPa)

GH

높이 (m)

TA

기온 (C)

TD

이슬점온도 (C)

WD

풍향 (degree)

WS

풍속 (m/s)

FLAG

FLAG의 자리별 Y인 경우 의미 (왼쪽부터)1 : 지상2 : 표준등압면3 : 온도유의고도4 : 바람유의고도5 : 권계면6 : 최대풍7 : 616168 : 525259 : TTAA10 : TTBB11 : TTCC12 : TTDD

호출URL정보

기상1호(레윈존데)

https://apihub.kma.go.kr/api/typ01/url/sea_kship_temp.php?tm=202105261200&stn=0&pa=0&help=1&authKey=zxiqblJaSgSYqm5SWioEeA

요청인자

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

tm

년월일시분(UTC)

조회시각 (없으면 현재시각)

stn

지점번호

해당 지점의 정보 표출, 만일 2-3글자이면 그렇게 시작하는 지점목록(0 이거나 없으면 전체지점)

pa

기압면

0 이거나 없으면 전체 고도 표출

help

도움말추가

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

authKey

인증키

발급된 API 인증키

출력결과

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

STN

지점번호

LAT

위도 (degree)

LON

경도 (degree)

PA

현지기압 (hPa)

PA

등압면 (hPa)

GH

높이 (m)

TA

기온 (C)

TD

이슬점온도 (C)

WD

풍향 (degree)

WS

풍속 (m/s)

FLAG

FLAG의 자리별 Y인 경우 의미 (왼쪽부터)1 : 지상2 : 표준등압면3 : 온도유의고도4 : 바람유의고도5 : 권계면6 : 최대풍7 : 616168 : 525259 : TTAA10 : TTBB11 : TTCC12 : TTDD

호출URL정보

이동기상관측(레윈존데)

https://apihub.kma.go.kr/api/typ01/url/upp_mbl_temp.php?tm=201806210000&stn=0&pa=0&help=1&authKey=zxiqblJaSgSYqm5SWioEeA

요청인자

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

tm

년월일시분(UTC)

조회시각 (없으면 현재시각)

stn

지점번호

해당 지점의 정보 표출, 만일 2-3글자이면 그렇게 시작하는 지점목록(0 이거나 없으면 전체지점)

pa

기압면

0 이거나 없으면 전체 고도 표출

help

도움말추가

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

authKey

인증키

발급된 API 인증키

출력결과

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

STN

지점번호

LAT

위도 (degree)

LON

경도 (degree)

PA

현지기압 (hPa)

PA

등압면 (hPa)

GH

높이 (m)

TA

기온 (C)

TD

이슬점온도 (C)

WD

풍향 (degree)

WS

풍속 (m/s)

FLAG

FLAG의 자리별 Y인 경우 의미 (왼쪽부터)1 : 지상2 : 표준등압면3 : 온도유의고도4 : 바람유의고도5 : 권계면6 : 최대풍7 : 616168 : 525259 : TTAA10 : TTBB11 : TTCC12 : TTDD

2. 국내 레윈존데 최대고도 자료 조회

호출URL정보

https://apihub.kma.go.kr/api/typ01/url/upp_raw_max.php?tm1=20170310&tm2=20170312&stn=0&help=1&authKey=zxiqblJaSgSYqm5SWioEeA

요청인자

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

tm1

년월일

기간 (tm1일~tm2일)

tm2

년월일

기간 (tm1일~tm2일)

stn

지점번호

해당 지점의 정보 표출(오산, 광주 제외), 0이면 전체

help

도움말추가

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

authKey

인증키

발급된 API 인증키

출력결과

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

TM

관측시각 (UTC)

STN

지점번호

SEC

최대고도까지 비양시간(sec)

HT

최대고도(m)

DIS

최대고도에서의 출발점과의 수평거리차(m)

LON1

출발점의 경도(deg)

LAT1

출발점의 위도(deg)

LON2

최대고도의 경도(deg)

LAT2

최대고도의 위도(deg)

3. 국내 레윈존데 분석자료(안정도 등) 조회

호출URL정보

https://apihub.kma.go.kr/api/typ01/url/upp_idx.php?tm1=2017052000&tm2=2017052400&stn=0&help=1&authKey=zxiqblJaSgSYqm5SWioEeA

요청인자

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

tm1

년월일시분(UTC)

기간

tm2

년월일시분(UTC)

기간

stn

지점번호

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

help

도움말추가

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

authKey

인증키

발급된 API 인증키

출력결과

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

TM

시간(년월일시분, UTC)

STN

지점번호

TA

기온(C)

HM

습도(%)

WD

풍향(deg)

WS

풍속(KT)

FL

빙결고도(gpm)

EQT850

상당온위(C)

TP

권계면고도(gpm)

LCL

상승응결고도(gpm)

CCL

대류응결고도(gpm)

LFC

자유대류고도(gpm)

HEL

평형고도(gpm)

MW

최대풍 고도(gpm)

SSI8550

SSI 850-500

SSI9250

SSI 925-500

SSI9270

SSI 925-700

KINDEX

K-index

TCKN

층후(1000-700)

CVTT

대류온도

MAXT

예상 최고기온

MINT

예상 최저기온

SREH

폭풍지수

CAPE

CAPE

CIN

대류억제도

TPW

총가강수량(mm)

TT

TT-index

LIAV

상승지수 1000-500

LISF

지상 기온(C)

LI92

상승지수 925-500

UPRESS

상층운 기압(hPa)

UT

상층운 습수

MPRESS

중층운 기압

MT

중층운 습수

LPRESS

하층운 기압

LT

하층운 습수

CLOUD

CLOUD

4. 고층기상월보 조회

호출URL정보

일러두기조회

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

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년도

‘2016년 발표’

month

발표월

‘09월 발표’

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

getNote

일러두기

호출URL정보

고층관측지점일람표조회

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

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년도

‘2016년 발표’

month

발표월

‘16년 09월 발표’

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stn_id

지역코드

stn_ko

지역명(국문)

stn_en

지역명(영문)

lat

위도

Lon

경도

ht

해발고도

rt

라디오존데형식

ge

관측장비

oyyyy

관측개시일

호출URL정보

표준등압면별일/월값조회

https://apihub.kma.go.kr/api/typ02/openApi/UppMtlyInfoService/getStdIsbrsfValue?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&station=47102&authKey=zxiqblJaSgSYqm5SWioEeA

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년도

‘2016년 발표’

month

발표월

‘16년 09월 발표’

station

지점번호

47102지점 #고층지점

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

inx

등압 구분 코드

dd

일자

hh

시간

pa

기압

gh

고도

ta

기온

td

이슬점

wd

풍향

ws

풍속

dcnt

월별 일수

호출URL정보

권계면과최대풍조회

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

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년도

‘2016년 발표’

month

발표월

‘16년 09월 발표’

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stnId

지점번호

Dd

일자

Hh

시간

pa_1

권계면 기압

ta_1

권계면 온도

td_1

권계면 이슬점

wd_1

권계면 풍향

ws_1

권계면 풍속

pa_2

최대풍 기압

wd_2

최대풍 풍향

ws_2

최대풍 풍속

gh_1

고도

dcnt

월별 일수

호출URL정보

기온과습도의유의고도조회

https://apihub.kma.go.kr/api/typ02/openApi/UppMtlyInfoService/getTaHmLevel?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&station=47102&authKey=zxiqblJaSgSYqm5SWioEeA

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년도

‘2016년 발표’

month

발표월

‘16년 09월 발표’

station

지점번호

47102지점 #고층지점

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stnId

지점번호

dd

일자

inx

고도번호

pa_1

00시 기압

ta_1

00시 기온

td_1

00시 이슬점

pa_2

12시 기압

ta_2

12시 기온

td_2

12시 이슬점

호출URL정보

바람유의고도조회

https://apihub.kma.go.kr/api/typ02/openApi/UppMtlyInfoService/getWindLevel?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&station=47102&authKey=zxiqblJaSgSYqm5SWioEeA

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년도

‘2016년 발표’

month

발표월

‘16년 09월 발표’

station

지점번호

47102지점 #고층지점

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dd

일자

inx

고도번호

pa_1

00시 기압

wd_1

00시 풍속

ws_1

00시 풍향