오픈API 상세
기상청_단기예보 ((구)_동네예보) 조회서비스
초단기실황, 초단기예보, 단기((구)동네)예보, 예보버전 정보를 조회하는 서비스입니다. 초단기실황정보는 예보 구역에 대한 대표 AWS 관측값을, 초단기예보는 예보시점부터 6시간까지의 예보를, 단기예보는 예보기간을 글피까지 확장 및 예보단위를 상세화(3시간→1시간)하여 시공간적으로 세분화한 예보를 제공합니다.
단기예보는 예보기간과 구역을 시·공간적으로 세분화하여 발표하는 예보입니다. 지역별 시간별 차이로 인한 수요자의 불편을 최소화하기 위해 전국을 5km*5km 간격의 격자로 나누어 읍, 면, 동 단위의 행정구역 중심으로 상세한 날씨를 제공합니다.
다른 사용자들이 활용한 데이터
로그인하셔서 다른 사용자들이 활용한 데이터를 추천받아 보세요
| 분류체계 | 과학기술 - 과학기술연구 | 제공기관 | 기상청 |
|---|---|---|---|
| 관리부서명 | 국가기후데이터센터 | 관리부서 전화번호 | |
| API 유형 | REST | 데이터포맷 | JSON+XML |
| 활용신청 | 48452 | 키워드 | 단기예보,초단기실황,초단기예보,동네예보,읍면동 |
| 등록일 | 2021-06-28 | 수정일 | 2025-11-19 |
| 비용부과유무 | 무료 | 신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 |
| 심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | ||
| 공간범위 | 전국 | 시간범위 | 현재 |
| 이용허락범위 |
공공저작물_출처표시
|
||
| 참고문서 | 기상청41_단기예보 조회서비스_오픈API활용가이드_2510.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에서 확인해주세요.
다른 사용자들이 활용한 데이터
로그인하셔서 다른 사용자들이 활용한 데이터를 추천받아 보세요
이 데이터와 유사한 데이터