분류체계 | 과학기술 - 과학기술연구 | 제공기관 | 기상청 |
---|---|---|---|
관리부서명 | 국가기후데이터센터 | 관리부서 전화번호 | |
API 유형 | REST | 데이터포맷 | JSON+XML |
활용신청 | 7342 | 키워드 | 날씨,기상관측,시간자료 |
등록일 | 2019-12-26 | 수정일 | 2021-07-28 |
비용부과유무 | 무료 | 신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 |
심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | ||
이용허락범위 | |||
참고문서 | 기상청01_지상(종관,ASOS)시간자료_조회서비스_오픈API활용가이드.docx |
요청변수(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)
항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
---|---|---|---|---|---|
결과코드 | 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에서 확인해주세요.
분류체계 | 과학기술 - 과학기술연구 | |
---|---|---|
제공기관 | 기상청 | |
관리부서명 | 국가기후데이터센터 | |
관리부서 전화번호 | ||
API 유형 | REST | |
데이터포맷 | JSON+XML | |
활용신청 | 7342 | |
키워드 | 날씨,기상관측,시간자료 | |
등록일 | 2019-12-26 | |
수정일 | 2021-07-28 | |
심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | |
비용부과유무 | 무료 | |
신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 | |
이용허락범위 | ||
참고문서 | 기상청01_지상(종관,ASOS)시간자료_조회서비스_오픈API활용가이드.docx |
요청변수(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)
항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
---|---|---|---|---|---|
결과코드 | 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에서 확인해주세요.