# 기상청_단기예보 조회서비스

초단기실황, 초단기예보, 단기((구)동네)예보, 예보버전 정보를 조회하는 서비스입니다. 초단기실황정보는 예보 구역에 대한 대표 AWS 관측값을, 초단기예보는 예보시점부터 6시간까지의 예보를, 단기예보는 예보기간을 글피까지 확장 및 예보단위를 상세화(3시간→1시간)하여 시공간적으로 세분화한 예보를 제공합니다. 단기예보는 예보기간과 구역을 시·공간적으로 세분화하여 발표하는 예보입니다. 지역별 시간별 차이로 인한 수요자의 불편을 최소화하기 위해 전국을 5km*5km 간격의 격자로 나누어 읍, 면, 동 단위의 행정구역 중심으로 상세한 날씨를 제공합니다.

## 기본 정보

- 데이터 유형: 오픈API
- 식별자: 15084084
- 제공기관: 기상청
- 담당부서: 국가기후데이터센터
- 연락처: +82-42-481-7480
- 키워드: 단기예보, 초단기실황, 초단기예보, 동네예보, 읍면동
- 이용허락범위: [제3자 권리 포함 : 저작권 표시, 공공저작물 : 출처표시 (제 1유형)](<https://www.kogl.or.kr/info/licenseType1.do>)
- 비용: 무료
- 등록일: 2021-06-28
- 수정일: 2026-10-19
- 공간범위: 전국
- 시간범위: 현재
- 데이터 형식: JSON+XML
- 분류체계: 과학기술 - 과학기술연구
- 제공형태: REST
- 업데이트 주기: 실시간
- 상세 페이지: https://www.data.go.kr/data/15084084/openapi.do

## 내려받기·호출 주소

- [JSON+XML](<https://apis.data.go.kr/1360000/VilageFcstInfoService_2.0>)

## 상세기능

### 1. 초단기실황조회

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

#### 요청변수

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 서비스키 | 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 좌표값 |

#### 출력결과

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 결과코드 | 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 실수로 제공 |

### 2. 초단기예보조회

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

#### 요청변수

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 서비스키 | 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 | 필수 | 0630 | 06시30분 발표(30분 단위) |
| 예보지점 X 좌표 | nx | 2 | 필수 | 55 | 예보지점 X 좌표값 |
| 예보지점 Y 좌표 | ny | 2 | 필수 | 127 | 예보지점 Y 좌표값 |

#### 출력결과

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 결과코드 | 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 | 4 | 필수 | 1200 | 12시00분 발표 |
| 예보지점 X 좌표 | nx | 2 | 필수 | 55 | 입력한 예보지점 X 좌표 |
| 예보지점 Y 좌표 | ny | 2 | 필수 | 127 | 입력한 예보지점 Y 좌표 |
| 자료구분코드 | category | 3 | 필수 | LGT | 자료구분코드 |
| 예측일자 | fcstDate | 8 | 필수 | 20210628 | 예측일자(YYYYMMDD) |
| 예측시간 | fcstTime | 4 | 필수 | 1200 | 예측시간(HH24MI) |
| 예보 값 | fcstValue | 2 | 필수 | 0 | 예보 값 |

### 3. 단기예보조회

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

#### 요청변수

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 서비스키 | 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 | 필수 | 0500 | 05시 발표 |
| 예보지점 X 좌표 | nx | 2 | 필수 | 55 | 예보지점의 X 좌표값 |
| 예보지점 Y 좌표 | ny | 2 | 필수 | 127 | 예보지점의 Y 좌표값 |

#### 출력결과

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 결과코드 | resultCode | 2 | 필수 | 00 | 결과코드 |
| 결과메시지 | resultMsg | 50 | 필수 | OK | 결과메시지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 50 | 한 페이지 결과 수 |
| 페이지 번호 | pageNo | 4 | 필수 | 1 | 페이지번호 |
| 전체 결과 수 | totalCount | 4 | 필수 | 3 | 전체 결과 수 |
| 데이터 타입 | dataType | 4 | 필수 | XML | 응답자료형식 (XML/JSON) |
| 발표일자 | baseDate | 8 | 필수 | 20210628 | ‘21년 6월 28일 발표 |
| 발표시각 | baseTime | 6 | 필수 | 0500 | 05시 발표 |
| 예보일자 | fcstDate | 8 | 필수 | 20210628 | ‘21년 6월 28일 예보 |
| 예보시각 | fcstTime | 4 | 필수 | 0600 | 6시 예보 |
| 자료구분문자 | category | 3 | 필수 | TMP | 자료구분코드 |
| 예보 값 | fcstValue | 2 | 필수 | 21 | * 하단 코드값 정보 참조 |
| 예보지점 X 좌표 | nx | 2 | 필수 | 55 | 입력한 예보지점 X 좌표 |
| 예보지점 Y 좌표 | ny | 2 | 필수 | 127 | 입력한 예보지점 Y 좌표 |

### 4. 예보버전조회

단기예보정보조회서비스 각각의 오퍼레이션(초단기실황, 초단기예보, 단기예보)들의 수정된 예보 버전을 파악하기 위해 예보버전을 조회하는 기능

#### 요청변수

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 서비스키 | ServiceKey | 4 | 필수 | - | 공공데이터포털에서 받은 인증키 |
| 페이지 번호 | pageNo | 4 | 필수 | 1 | 페이지번호 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 1000 | 한 페이지 결과 수 |
| 응답자료형식 | dataType | 4 | 옵션 | XML | 요청자료형식(XML/JSON) Default: XML |
| 파일구분 | ftype | 5 | 필수 | ODAM | 파일구분 -ODAM: 동네예보실황 -VSRT: 동네예보초단기 -SHRT: 동네예보단기 |
| 발표일시분 | basedatetime | 10 | 필수 | 202106280800 | 각각의 base_time 로 검색 |

#### 출력결과

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 결과코드 | resultCode | 2 | 필수 | 00 | 결과코드 |
| 결과메시지 | resultMsg | 50 | 필수 | OK | 결과메시지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 페이지 번호 | pageNo | 4 | 필수 | 1 | 페이지번호 |
| 전체 결과 수 | totalCount | 4 | 필수 | 3 | 전체 결과 수 |
| 데이터 타입 | dataType | 4 | 필수 | XML | 응답자료형식 (XML/JSON) |
| 파일버전 | version | 4 | 필수 | 20210628092217 | 파일버전 정보 - 파일 생성 시간 |
| 파일구분 | filetype | 5 | 필수 | ODAM | 파일구분 -ODAM: 초단기실황 -VSRT: 초단기예보 -SHRT: 단기예보 |

---

출처: 공공데이터포털 (https://www.data.go.kr) · 원문: https://www.data.go.kr/data/15084084/openapi.do
