태풍

북서태평양에서 발생한 태풍 및 열대저압부의 위치, 발생·소멸일, 중심기압, 진행방향·속도 등의 데이터를 제공합니다.

api 상세
개요

태풍 예상정보는 현재 태풍(Tropical Cyclone)의 중심위치, 중심기압, 중심부근 최대풍속, 강풍반경, 폭풍반경, 진행방향, 이동속도를 제공합니다.

요 소

태풍중심위치, 중심기압, 최대풍속, 강풍반경, 강도, 크기, 진행방향, 이동속도 등

지 점

북서태평양지역

보유기간

현재 진행 중인 태풍에 한하여 제공

생산주기

4, 10, 16, 22시 및 필요 시 수시 발표

1. 태풍정보(기상청 발표) 조회

호출URL정보

태풍목록

https://apihub.kma.go.kr/api/typ01/url/typ_lst.php?YY=2012&disp=0&help=1&authKey=Ns9jp8v2RkSPY6fL9gZEeg

요청인자

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

YY

년도

태풍발생 년도 (없으면 올해)

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

0 : 시작과 종료표시 + 변수명 (default)
1 : 0 + 변수에 대한 설명
2 : 전혀 표시않음 (값만 표시)

typ

태풍번호

해당 년도의 태풍번호 (없으면 그해의 가장 마지막 번호)

seq

발표번호

이 발표 전에 발표된 자료까지만 표출 (없으면 마지막 발표번호)

mode

표출범위

0 : 분석정보만
1 : 과거 분석정보 + 가장 최근의 예측정보
2 : 가장 최근의 분석정보와 예측정보
3 : 과거 분석정보 + 과거 모든 예측정보
*) 모두 위 seq(발표번호) 기준으로 과거 자료만 처리

tm

기준시간
(UTC)

이 시각 기준으로 과거 12시간 내에서 발표된 태풍에 대하여 표출

authKey

인증키

발급된 API 인증키

출력결과

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

YY

년도 (없으면 올해)

SEQ

태풍번호

NOW

진행여부

EFF

한반도영향

TM_ST

태풍시각시각 (UTC)

TM_ED

태풍종료시각 (UTC)

TYP_NAME

태풍이름

TYP_EN

태풍이름(영문)

REM

비고 (태풍이름 설명)

FT

0(분석), 1(예측)

YY

년도

TYP

태풍번호

SEQ

발표번호

TMD

예측시각-분석시각 (시간)

TYP_TM

태풍 분석시각 (UTC)

FT_TM

태풍 예측시각 (UTC)

LAT

위도 (deg.)

LON

경도 (deg.)

DIR

태풍진행방향 (16방위기호)

SP

태풍진향속도 (km/h)

PS

태풍중심기압 (hpa)

WS

태풍최대풍속 (m/s)

RAD15

15m/s 반경 (km)

RAD25

25m/s 반경 (km)

RAD

70%이상 예상확률반경 (km)

ED15

풍속 15km 영역에서 예외방향 (16방위)

ER15

풍속 15km 영역에서 예외반경 (km)

LOC

위치

ED25

풍속 25km 영역에서 예외방향 (16방위)

ER25R

풍속 25km 영역에서 예외반경 (km)

호출URL정보

태풍정보+예측

https://apihub.kma.go.kr/api/typ01/url/typ_data.php?YY=2011&typ=9&seq=8&mode=1&disp=0&help=1&authKey=Ns9jp8v2RkSPY6fL9gZEeg

요청인자

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

YY

년도

태풍발생 년도 (없으면 올해)

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

0 : 시작과 종료표시 + 변수명 (default)
1 : 0 + 변수에 대한 설명
2 : 전혀 표시않음 (값만 표시)

typ

태풍번호

해당 년도의 태풍번호 (없으면 그해의 가장 마지막 번호)

seq

발표번호

이 발표 전에 발표된 자료까지만 표출 (없으면 마지막 발표번호)

mode

표출범위

0 : 분석정보만
1 : 과거 분석정보 + 가장 최근의 예측정보
2 : 가장 최근의 분석정보와 예측정보
3 : 과거 분석정보 + 과거 모든 예측정보
*) 모두 위 seq(발표번호) 기준으로 과거 자료만 처리

tm

기준시간
(UTC)

이 시각 기준으로 과거 12시간 내에서 발표된 태풍에 대하여 표출

authKey

인증키

발급된 API 인증키

출력결과

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

YY

년도 (없으면 올해)

SEQ

태풍번호

NOW

진행여부

EFF

한반도영향

TM_ST

태풍시각시각 (UTC)

TM_ED

태풍종료시각 (UTC)

TYP_NAME

태풍이름

TYP_EN

태풍이름(영문)

REM

비고 (태풍이름 설명)

FT

0(분석), 1(예측)

YY

년도

TYP

태풍번호

SEQ

발표번호

TMD

예측시각-분석시각 (시간)

TYP_TM

태풍 분석시각 (UTC)

FT_TM

태풍 예측시각 (UTC)

LAT

위도 (deg.)

LON

경도 (deg.)

DIR

태풍진행방향 (16방위기호)

SP

태풍진향속도 (km/h)

PS

태풍중심기압 (hpa)

WS

태풍최대풍속 (m/s)

RAD15

15m/s 반경 (km)

RAD25

25m/s 반경 (km)

RAD

70%이상 예상확률반경 (km)

ED15

풍속 15km 영역에서 예외방향 (16방위)

ER15

풍속 15km 영역에서 예외반경 (km)

LOC

위치

ED25

풍속 25km 영역에서 예외방향 (16방위)

ER25R

풍속 25km 영역에서 예외반경 (km)

호출URL정보

태풍정보+예측(시점기준)

https://apihub.kma.go.kr/api/typ01/url/typ_now.php?tm=201108070100&mode=1&disp=0&help=1&authKey=Ns9jp8v2RkSPY6fL9gZEeg

요청인자

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

YY

년도

태풍발생 년도 (없으면 올해)

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

0 : 시작과 종료표시 + 변수명 (default)
1 : 0 + 변수에 대한 설명
2 : 전혀 표시않음 (값만 표시)

typ

태풍번호

해당 년도의 태풍번호 (없으면 그해의 가장 마지막 번호)

seq

발표번호

이 발표 전에 발표된 자료까지만 표출 (없으면 마지막 발표번호)

mode

표출범위

0 : 분석정보만
1 : 과거 분석정보 + 가장 최근의 예측정보
2 : 가장 최근의 분석정보와 예측정보
3 : 과거 분석정보 + 과거 모든 예측정보
*) 모두 위 seq(발표번호) 기준으로 과거 자료만 처리

tm

기준시간
(UTC)

이 시각 기준으로 과거 12시간 내에서 발표된 태풍에 대하여 표출

authKey

인증키

발급된 API 인증키

출력결과

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

YY

년도 (없으면 올해)

SEQ

태풍번호

NOW

진행여부

EFF

한반도영향

TM_ST

태풍시각시각 (UTC)

TM_ED

태풍종료시각 (UTC)

TYP_NAME

태풍이름

TYP_EN

태풍이름(영문)

REM

비고 (태풍이름 설명)

FT

0(분석), 1(예측)

YY

년도

TYP

태풍번호

SEQ

발표번호

TMD

예측시각-분석시각 (시간)

TYP_TM

태풍 분석시각 (UTC)

FT_TM

태풍 예측시각 (UTC)

LAT

위도 (deg.)

LON

경도 (deg.)

DIR

태풍진행방향 (16방위기호)

SP

태풍진향속도 (km/h)

PS

태풍중심기압 (hpa)

WS

태풍최대풍속 (m/s)

RAD15

15m/s 반경 (km)

RAD25

25m/s 반경 (km)

RAD

70%이상 예상확률반경 (km)

ED15

풍속 15km 영역에서 예외방향 (16방위)

ER15

풍속 15km 영역에서 예외반경 (km)

LOC

위치

ED25

풍속 25km 영역에서 예외방향 (16방위)

ER25R

풍속 25km 영역에서 예외반경 (km)

2. 우리나라에 영향을 미친 태풍 조회

호출URL정보

우리나라에 영향을 미친 태풍조회

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

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년

2016년 발표

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

typ_seq

태풍번호

typ_en

태풍명칭

tm_st

태풍 발생일

tm_ed

태풍 소멸일

typ_ps

중심 최저기압

typ_ws

최대 풍속

typ_name

태풍 한글명칭

eff

eff