오픈API 상세

XML JSON

기상청_지상(종관, ASOS)기상관측자료 조회서비스

종관기상관측장비가 운영되는 지점별정시관측, 지점별일극값, 전국실황, 누적강수량, 시간강수량, 적설, 신적설 정보를 조회하는 서비스입니다. (결빙, 서리, 눈 등 일부 목측이 필요한 기상요소는 유인기관에서만 표출) (참고)ASOS와 AWS 차이 구분 - (ASOS),종관기상관측, 주로 주요 도시에 설치, 기상청에서 운영, 종관기상 전요소(정규 관측), 예보·기후 통계, 국제공유가 목적 - (AWS) 산간·도서 등 촘촘한 지역망 운영, 기상청·지자체 등 혼합 운영, 일부 기상요소(강수, 온도 등), 국지성 재해 감시, 보조 관측이 목적
다른 사용자들이 활용한 데이터
기상청_지상(종관, ASOS)기상관측자료 조회서비스로 오픈 API 정보 표로 분류체계, 제공기관 등 정보를 나타냄
분류체계 과학기술 - 과학기술연구 제공기관 기상청
관리부서명 국가기후데이터센터 관리부서 전화번호
API 유형 REST 데이터포맷 JSON+XML
활용신청 304 키워드 날씨,기상관측,강수량,일기현상,기온
등록일 2019-12-26 수정일 2025-09-17
비용부과유무 무료 신청가능 트래픽 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
심의유형 개발단계 : 심의승인 / 운영단계 : 심의승인
공간범위 전국 시간범위 실시간
이용허락범위
참고문서 기상청03_지상(종관 ASOS)기상관측자료_조회서비스_오픈API활용가이드.docx

상세기능

지점코드, 시간 조건을 이용하여 년,월,일,시 시간당 적설(cm) 정보를 조회하는 기능

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

요청변수(Request Parameter)

요청변수(Request Parameter)

항목명(국문) 항목명(영문) 항목크기 항목구분 샘플데이터 항목설명
서비스키 ServiceKey 4 필수 - 공공데이터포털에서 받은 인증키
페이지 번호 pageNo 4 필수 1 페이지번호
한 페이지 결과 수 numOfRows 4 필수 10 한 페이지 결과 수
응답자료형식 dataType 4 옵션 XML 요청자료형식(XML/JSON)Default: XML
지점코드 stnId 3 옵션 108 지점코드(활용가이드 하단 첨부 참조)
시간 time 12 옵션 20120311 관측시간(YYYYMMDD) (최근 2일까지 조회)

출력결과(Response Element)

출력결과(Response Element)

항목명(국문) 항목명(영문) 항목크기 항목구분 샘플데이터 항목설명
결과코드 resultCode 2 필수 00 결과코드
결과메시지 resultMsg 50 필수 OK 결과메시지
한 페이지 결과 수 numOfRows 4 필수 10 한 페이지 결과 수
페이지 번호 pageNo 4 필수 1 3
전체 결과 수 totalCount 4 필수 3 전체 결과 수
데이터 타입 dataType 4 옵션 XML 응답자료형식 (XML/JSON)
year 4 옵션 2012
month 2 옵션 3
day 2 옵션 11
hour 2 옵션 3
적설(cm) snowcover 5 옵션 0 입력된 년월일 시간당 적설(cm)
지점코드 stnId 3 옵션 108 지점코드

샘플코드

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

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