오픈API 상세

XML JSON

기상청_단기예보 ((구)_동네예보) 조회서비스

초단기실황, 초단기예보, 단기((구)동네)예보, 예보버전 정보를 조회하는 서비스입니다. 초단기실황정보는 예보 구역에 대한 대표 AWS 관측값을, 초단기예보는 예보시점부터 6시간까지의 예보를, 단기예보는 예보기간을 글피까지 확장 및 예보단위를 상세화(3시간→1시간)하여 시공간적으로 세분화한 예보를 제공합니다.
다른 사용자들이 활용한 데이터
기상청_단기예보 ((구)_동네예보) 조회서비스로 오픈 API 정보 표로 분류체계, 제공기관 등 정보를 나타냄
분류체계 과학기술 - 과학기술연구 제공기관 기상청
관리부서명 국가기후데이터센터 관리부서 전화번호
API 유형 REST 데이터포맷 JSON+XML
활용신청 27626 키워드 단기예보,초단기실황,초단기예보
등록일 2021-06-28 수정일 2024-03-15
비용부과유무 무료 신청가능 트래픽 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
심의유형 개발단계 : 자동승인 / 운영단계 : 자동승인
이용허락범위
참고문서 기상청41_단기예보 조회서비스_오픈API활용가이드_최종.zip

상세기능

실황정보를 조회하기 위해 발표일자, 발표시각, 예보지점 X 좌표, 예보지점 Y 좌표의 조회 조건으로 자료구분코드, 실황값, 발표일자, 발표시각, 예보지점 X 좌표, 예보지점 Y 좌표의 정보를 조회하는 기능

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

요청변수(Request Parameter)

요청변수(Request Parameter)

항목명(국문) 항목명(영문) 항목크기 항목구분 샘플데이터 항목설명
서비스키 ServiceKey 4 필수 - 공공데이터포털에서 받은 인증키
페이지 번호 pageNo 4 필수 1 페이지번호
한 페이지 결과 수 numOfRows 4 필수 1000 한 페이지 결과 수
응답자료형식 dataType 4 옵션 XML 요청자료형식(XML/JSON) Default: XML
발표일자 base_date 8 필수 20210628 ‘21년 6월 28일 발표
발표시각 base_time 4 필수 0600 06시 발표(정시단위)
예보지점 X 좌표 nx 2 필수 55 예보지점의 X 좌표값
예보지점 Y 좌표 ny 2 필수 127 예보지점의 Y 좌표값

출력결과(Response Element)

출력결과(Response Element)

항목명(국문) 항목명(영문) 항목크기 항목구분 샘플데이터 항목설명
결과코드 resultCode 2 필수 00 결과코드
결과메시지 resultMsg 50 필수 OK 결과메시지
한 페이지 결과 수 numOfRows 4 필수 10 한 페이지 결과 수
페이지 번호 pageNo 4 필수 1 페이지번호
전체 결과 수 totalCount 4 필수 3 전체 결과 수
데이터 타입 dataType 4 필수 XML 응답자료형식 (XML/JSON)
발표일자 baseDate 8 필수 20210628 ‘21년 6월 28일 발표
발표시각 baseTime 6 필수 0600 06시 발표(매 정시)
예보지점 X 좌표 nx 2 필수 55 입력한 예보지점 X 좌표
예보지점 Y 좌표 ny 2 필수 127 입력한 예보지점 Y 좌표
자료구분코드 category 3 필수 RN1 자료구분코드
실황 값 obsrValue 2 필수 0 RN1, T1H, UUU, VVV, WSD 실수로 제공

샘플코드

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

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