이 누리집은 대한민국 공식 전자정부 누리집입니다.
XML
JSON
기상청_태풍정보 조회서비스
QuickAISummary
오픈 API 정보
데이터 오류·개선 의견이 있으신가요?
기본 정보
-
OpenAPI 명
기상청_태풍정보 조회서비스
-
분류체계
과학기술 - 과학기술연구
- 제공기관
-
관리부서명
국가기후데이터센터
-
관리부서 전화번호
상세 및 제공정보
-
설명
태풍정보, 태풍정보목록, 태풍예상정보를 조회하는 서비스 <태풍의 정의> 태양으로부터 오는 열에너지는 지구의 날씨를 변화시키는 주된 원인으로 작용합니다. 지구는 구형으로 되어 있어 저위도와 고위도 사이에는 열에너지 불균형이 나타납니다. 태양의 고도각이 높아 많은 에너지를 축적한 적도부근의 바다에서는 대류구름들이 만들어지게 됩니다. 때때로 이러한 대류구름들이 모여 거대한 저기압 시스템으로 발달하게 되는데, 이를 태풍이라고 부릅니다. 태풍은 바다로부터 증발한 수증기를 공급받아 강도를 유지하면서 고위도로 이동하게 됩니다. 이러한 과정을 통해 태풍은 지구 남북 간의 에너지 불균형을 해소하는 역할을 합니다.
-
API 유형
REST
-
데이터 포맷
JSON+XML
-
공간범위
-
-
시간범위
-
-
키워드
태풍,태풍정보,태풍예상정보,열대저압부,여름
-
활용신청 수
1953
-
등록일
2019-12-27
-
수정일
2025-09-17
이용 조건 및 라이선스 정보
-
비용부과유무
무료
-
이용허락범위
공공저작물 : 출처표시 (제 1유형)
-
심의유형
개발단계 : 자동승인 / 운영단계 : 자동승인
-
신청 가능 트래픽
개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
참고문서
-
기상청22_태풍정보_조회서비스_오픈API활용가이드v2.docx
표준 메타데이터
활용 정보
API 서비스
통보문 발표 시각을 이용하여 태풍 경로 이미지, 태풍번호, 통보문 발표 호수, 태풍시각, 위도, 경도, 태풍예상 문구(한글), 진행방향, 진행속도(km/h), 중심기압(hPa),최대풍속(m/s) 등 정보를 조회하는 기능
API 기본 정보
-
활용승인 절차
개발단계 : 자동승인 / 운영단계 : 자동승인
-
신청 가능 트래픽
개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
-
요청주소
https://apis.data.go.kr/1360000/TyphoonInfoService/getTyphoonInfo
-
서비스 URL
https://apis.data.go.kr/1360000/TyphoonInfoService
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 서비스키 | ServiceKey | 4 | 필수 | - | 공공데이터포털에서 받은 인증키 |
| 페이지 번호 | pageNo | 4 | 필수 | 1 | 페이지번호 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 응답자료형식 | dataType | 4 | 옵션 | XML | 요청자료형식(XML/JSON)Default: XML |
| 통보문발표시각(From) | fromTmFc | 8 | 필수 | 20120928 | 시간(년월일) |
| 통보문발표시각(To) | toTmFc | 8 | 필수 | 20120928 | 시간(년월일) |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 결과코드 | resultCode | 2 | 필수 | 00 | 결과코드 |
| 결과메시지 | resultMsg | 50 | 필수 | OK | 결과메시지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 페이지 번호 | pageNo | 4 | 필수 | 1 | 페이지번호 |
| 전체 결과 수 | totalCount | 4 | 필수 | 3 | 전체 결과 수 |
| 데이터 타입 | dataType | 4 | 필수 | XML | 응답자료형식 (XML/JSON) |
| 태풍 경로 이미지 | img | 100 | 필수 | 예제 참조 | 태풍 경로 이미지 |
| 통보문 발표 시각 | tmFc | 14 | 필수 | 201709031600 | 통보문 발표 시각 |
| 태풍번호 | typSeq | 3 | 옵션 | 15 | 태풍번호 |
| 통보문 발표 호수 | tmSeq | 3 | 옵션 | 25 | 통보문 발표 호수 |
| 태풍시각 | typTm | 14 | 필수 | 201709031500 | 태풍시각 |
| 위도 | typLat | 7 | 옵션 | 41.8 | 위도 |
| 경도 | typLon | 7 | 옵션 | 152.6 | 경도 |
| 태풍예상문구(한글) | typLoc | 100 | 필수 | 예제 참조 | 태풍예상문구(한글) |
| 진행방향 | typDir | 3 | 필수 | NE | 진행방향 |
| 진행속도(km/h) | typSp | 5 | 옵션 | 70 | 진행속도(km/h) |
| 중심기압(hPa) | typPs | 7 | 옵션 | 975 | 중심기압(hPa) |
| 최대풍속(m/s) | typWs | 5 | 옵션 | 32 | 최대풍속(m/s) |
| 25m/s반경(폭풍반경) | typ25 | 7 | 옵션 | 110 | 25m/s반경(폭풍반경) |
| 15m/s 반경(강풍반경) | typ15 | 7 | 옵션 | 350 | 15m/s 반경(강풍반경) |
| 15m/s 예외방향 | typ15ed | 3 | 옵션 | NW | 15m/s 예외방향 |
| 15m/s 예외반경 | typ15er | 7 | 옵션 | 300 | 15m/s 예외반경 |
| 태풍이름(한글) | typName | 20 | 필수 | 상우 | 태풍이름(한글) |
| 태풍이름(영문) | typEn | 20 | 필수 | SANVU | 태풍이름(영문) |
| 참고사항 | rem | 1000 | 필수 | 예제 참조 | 참고사항 |
| 비고 | other | 100 | 필수 | 예제 참조 | 비고 |