홈

오픈API 상세

페이스북
XML JSON

기상청_태풍정보 조회서비스

태풍정보, 태풍정보목록, 태풍예상정보를 조회하는 서비스 <태풍의 정의> 태양으로부터 오는 열에너지는 지구의 날씨를 변화시키는 주된 원인으로 작용합니다. 지구는 구형으로 되어 있어 저위도와 고위도 사이에는 열에너지 불균형이 나타납니다. 태양의 고도각이 높아 많은 에너지를 축적한 적도부근의 바다에서는 대류구름들이 만들어지게 됩니다. 때때로 이러한 대류구름들이 모여 거대한 저기압 시스템으로 발달하게 되는데, 이를 태풍이라고 부릅니다. 태풍은 바다로부터 증발한 수증기를 공급받아 강도를 유지하면서 고위도로 이동하게 됩니다. 이러한 과정을 통해 태풍은 지구 남북 간의 에너지 불균형을 해소하는 역할을 합니다.
활용신청
다른 사용자들이 활용한 데이터

OpenAPI 정보

schema.org DCAT
데이터 개선요청 오류신고 및 문의
기상청_태풍정보 조회서비스로 오픈 API 정보 표로 분류체계, 제공기관 등 정보를 나타냄
분류체계 과학기술 - 과학기술연구 제공기관 기상청
관리부서명 국가기후데이터센터 관리부서 전화번호
API 유형 REST 데이터포맷 JSON+XML
활용신청 1683 키워드 태풍,태풍정보,태풍예상정보,열대저압부,여름
등록일 2019-12-27 수정일 2025-09-17
비용부과유무 무료 신청가능 트래픽 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
심의유형 개발단계 : 자동승인 / 운영단계 : 자동승인
공간범위 시간범위
이용허락범위
저작자표시
저작자표시 공공저작물_출처표시
참고문서 기상청22_태풍정보_조회서비스_오픈API활용가이드v2.docx

상세기능

통보문 발표 시각을 이용하여 태풍 경로 이미지, 태풍번호, 통보문 발표 호수, 태풍시각, 위도, 경도, 태풍예상 문구(한글), 진행방향, 진행속도(km/h), 중심기압(hPa),최대풍속(m/s) 등 정보를 조회하는 기능

  • 활용승인 절차 개발단계 : 자동승인 / 운영단계 : 자동승인
  • 신청가능 트래픽 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
  • 요청주소 http://apis.data.go.kr/1360000/TyphoonInfoService/getTyphoonInfo
  • 서비스URL http://apis.data.go.kr/1360000/TyphoonInfoService
활용신청

요청변수(Request Parameter)

요청변수(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)

출력결과(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 필수 예제 참조 비고

샘플코드

샘플코드는 PC에서 확인해주세요.

다른 사용자들이 활용한 데이터
이 데이터와 유사한 데이터
목록