홈

오픈API 상세

페이스북
XML JSON

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

종관기상관측 장비로 관측한 시간 기상자료를 조회하는 서비스 지상기상관측(ASOS)이란 지면 부근 및 지상에서의 기상요소와 기상현상에 대한 관측으로 기온, 강수량, 기압, 습도, 일사, 일조 등을 관측합니다. 생산주기: 시간, 일 보유기간: 1904년 4월(지점별 상이함) ~ (참고)ASOS와 AWS 차이 구분 - (ASOS),종관기상관측, 주로 주요 도시에 설치, 기상청에서 운영, 종관기상 전요소(정규 관측), 예보·기후 통계, 국제공유가 목적 - (AWS) 산간·도서 등 촘촘한 지역망 운영, 기상청·지자체 등 혼합 운영, 일부 기상요소(강수, 온도 등), 국지성 재해 감시, 보조 관측이 목적
활용신청
다른 사용자들이 활용한 데이터

OpenAPI 정보

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

상세기능

조회조건(지점 번호, 시간)으로 종관기상관측 시간자료 데이터(지점 번호, 지점 명, 온도, 지면상태, 운형, 운량 등)를 조회하는 기능

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

요청변수(Request Parameter)

요청변수(Request Parameter)

항목명(국문) 항목명(영문) 항목크기 항목구분 샘플데이터 항목설명
서비스키 ServiceKey 4 필수 - 공공데이터포털에서 받은 인증키
페이지 번호 pageNo 4 옵션 1 페이지번호 Default : 10
한 페이지 결과 수 numOfRows 4 옵션 10 한 페이지 결과 수 Default : 1
응답자료형식 dataType 4 옵션 XML 요청자료형식(XML/JSON) Default : XML
자료 코드 dataCd 4 필수 ASOS 자료 분류 코드(ASOS)
날짜 코드 dateCd 3 필수 HR 날짜 분류 코드(HR)
시작일 startDt 8 필수 20100101 조회 기간 시작일(YYYYMMDD)
시작시 startHh 2 필수 01 조회 기간 시작시(HH)
종료일 endDt 8 필수 20100601 조회 기간 종료일(YYYYMMDD) (전일(D-1) 까지 제공)
종료시 endHh 2 필수 01 조회 기간 종료시(HH)
지점 번호 stnIds 3 필수 108 종관기상관측 지점 번호 (활용가이드 하단 첨부 참조)

출력결과(Response Element)

출력결과(Response Element)

항목명(국문) 항목명(영문) 항목크기 항목구분 샘플데이터 항목설명
결과코드 resultCode 2 필수 00 결과코드
결과메시지 resultMsg 50 필수 NORMAL_SERVICE 결과메시지
한 페이지 결과 수 numOfRows 4 필수 10 한 페이지 결과 수
페이지 번호 pageNo 4 필수 1 페이지번호
전체 결과 수 totalCount 4 필수 3 전체 결과 수
데이터 타입 dataType 4 필수 XML 응답자료형식 (XML/JSON)
지점 번호 stnId 3 필수 108 종관기상관측 지점 번호
시간 tm 10 필수 2010-01-01 10 일시
지점명 stnNm 3 필수 서울 종관기상관측 지점명
목록 순서 rnum 5 필수 1 목록 순서
30cm 지중온도 m03Te 6 옵션 0.4 30cm 지중온도
20cm 지중온도 m02Te 6 옵션 -1 20cm 지중온도
10cm 지중온도 m01Te 6 옵션 -2.4 10cm 지중온도
5cm 지중온도 m005Te 6 옵션 -4.9 5cm 지중온도
지면온도 ts 6 옵션 -3.4 지면온도
현상번호 dmstMtphNo 4 옵션 1904 현상번호
지면상태 gndSttCd 2 옵션 17 지면상태
시정 vs 4 옵션 2300 시정
최저운고 lcsCh 2 옵션 8 최저운고
운형 clfmAbbrCd 4 옵션 scas 운형
중하층운량 dc10LmcsCa 6 옵션 0 중하층운량
전운량 dc10Tca 6 옵션 0 전운량
3시간신적설 hr3Fhsc 6 옵션 0.2 3시간신적설
적설 dsnw 6 옵션 2.2 적설
일사 icsr 6 옵션 0.73 일사
일조 ss 6 옵션 1 일조
일조 품질검사 ssQcflag 1 옵션 0 관측값의 정상여부 판별 정보
해면기압 ps 6 옵션 1023.6 해면기압
해면기압 품질검사 플래그 psQcflag 1 옵션 0 관측값의 정상여부 판별 정보
현지기압 pa 6 옵션 1012.4 현지기압
현지기압 품질검사 플래그 paQcflag 1 옵션 0 관측값의 정상여부 판별 정보
이슬점온도 td 6 옵션 -21.4 이슬점온도
증기압 pv 6 옵션 1.1 증기압
습도 hm 6 옵션 36 습도
습도 품질검사 플래그 hmQcflag 1 옵션 0 관측값의 정상여부 판별 정보
풍향 wd 3 옵션 110 풍향
풍향 품질검사 플래그 wdQcflag 1 옵션 0 관측값의 정상여부 판별 정보
풍속 ws 6 옵션 1 풍속
풍속 품질검사 플래그 wsQcflag 1 옵션 0 관측값의 정상여부 판별 정보
강수량 rn 6 옵션 10.5 강수량
강수량 품질검사 플래그 rnQcflag 1 옵션 0 관측값의 정상여부 판별 정보
기온 ta 6 옵션 23.8 기온
기온 품질검사 플래그 taQcflag 1 옵션 0 관측값의 정상여부 판별 정보
지면온도 품질검사 플래그 tsQcflg 1 옵션 0 관측값의 정상여부 판별 정보

샘플코드

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

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