오픈API 상세
기상청_예보구역정보 조회서비스
기상청에서 운영하는 관측지점, 기상예보구역, 기상특보구역 등에 대한 정보를 제공합니다.
예보구역은 우리나라에서 날씨예보를 제공하기 위해 설정한 지리적 구획 단위입니다.
기상청은 예보의 효율성과 정확도를 높이기 위해 행정구역과 자연지리적 특성을 고려하여 전국을 여러 예보기반 구역으로 나누어 관리하고 있습니다.
특보구역은 기상청에서 발표하는 육상 및 해상의 기상특보구역코드 정보입니다.
한파, 건조, 안개, 폭염, 지진해일, 폭풍해일, 호우, 대설, 태풍, 풍랑, 강풍 12개 기상현상에 대해 중대한 재해발생이 예상될 때 해당 지역에 대하여 기상특보의 발표 기준에 따라 주의보 및 경보로 구분하여 178개 시 · 군 단위와 44개 해역으로 세분화하여 발표합니다.
다른 사용자들이 활용한 데이터
로그인하셔서 다른 사용자들이 활용한 데이터를 추천받아 보세요
| 분류체계 | 과학기술 - 과학기술연구 | 제공기관 | 기상청 |
|---|---|---|---|
| 관리부서명 | 국가기후데이터센터 | 관리부서 전화번호 | |
| API 유형 | REST | 데이터포맷 | JSON+XML |
| 활용신청 | 790 | 키워드 | 관측지점,예보구역,특보구역,예비특보,단기예보 |
| 등록일 | 2020-01-02 | 수정일 | 2025-09-17 |
| 비용부과유무 | 무료 | 신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 |
| 심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | ||
| 공간범위 | 시간범위 | ||
| 이용허락범위 |
공공저작물_출처표시
|
||
| 참고문서 | 기상청31_예보구역정보 조회서비스_오픈API활용가이드_240715.zip | ||
상세기능
예보구역코드 정보를 지상코드, 시간 조건을 이용하여 예보구역코드, 종료시각, 시작시각, 예보구역명(한글), 예보구역명(영문), 지역특성, 위도(deg.), 경도(deg.), 해발고도(m), 상위구역코드, 특보발표관서, 3시간예보관서, 단기예보관서, 주간예보관서, 순번 정보를 조회하는 기능
- 활용승인 절차 개발단계 : 자동승인 / 운영단계 : 자동승인
- 신청가능 트래픽 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
- 요청주소 http://apis.data.go.kr/1360000/FcstZoneInfoService/getFcstZoneCd
- 서비스URL http://apis.data.go.kr/1360000/FcstZoneInfoService
요청변수(Request Parameter)
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 서비스키 | ServiceKey | 4 | 필수 | - | 공공데이터포털에서 받은 인증키 |
| 페이지 번호 | pageNo | 4 | 필수 | 1 | 페이지번호 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 응답자료형식 | dataType | 4 | 옵션 | XML | 요청자료형식(XML/JSON)Default: XML |
| 예보구역코드 | regId | 8 | 옵션 | 11A00101 | 예보구역코드 |
출력결과(Response Element)
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 결과코드 | resultCode | 2 | 필수 | 00 | 결과코드 |
| 결과메시지 | resultMsg | 50 | 필수 | OK | 결과메시지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 페이지 번호 | pageNo | 4 | 필수 | 1 | 페이지번호 |
| 전체 결과 수 | totalCount | 4 | 필수 | 3 | 전체 결과 수 |
| 응답자료형식 | dataType | 4 | 필수 | XML | 응답자료형식 (XML/JSON) |
| 예보구역코드 | regId | 8 | 필수 | 11A00101 | 예보구역코드 |
| 종료시각 | tmEd | 24 | 필수 | 210012310900 | 종료시각 |
| 시작시각 | tmSt | 24 | 필수 | 201004300900 | 시작시각 |
| 예보구역명(한글) | regName | 40 | 필수 | 백령도 | 예보구역명(한글) |
| 예보구역명(영문) | regEn | 40 | 필수 | Baengnyeongdo | 예보구역명(영문) |
| 지역특성 | regSp | 8 | 필수 | C | A% : 육상광역, B% : 육상국지, C% : 도시, D% : 산악, E% : 고속도로, H% : 해상광역, I% : 해상국지, J% : 연안바다, K% : 해수욕장, L% : 연안항로, M% : 먼항로 |
| 위도(deg.) | lat | 12 | 옵션 | 37.966099 | 위도(deg.) |
| 경도(deg.) | lon | 12 | 옵션 | 124.630447 | 경도(deg.) |
| 해발고도(m) | ht | 10 | 옵션 | 37.66720278 | 해발고도(m) |
| 상위구역코드 | regUp | 8 | 필수 | 11A00100 | 상위구역코드 |
| 특보발표관서 | stnWn | 3 | 옵션 | 없음 | 특보발표관서 |
| 3시간예보관서 | stnF3 | 3 | 옵션 | 102 | 3시간예보관서 |
| 단기예보관서 | stnFd | 3 | 옵션 | 없음 | 단기예보관서 |
| 주간예보관서 | stnFw | 3 | 옵션 | 없음 | 주간예보관서 |
| 순번 | seq | 4 | 필수 | 1 | 순번 |
샘플코드
샘플코드는 PC에서 확인해주세요.
다른 사용자들이 활용한 데이터
로그인하셔서 다른 사용자들이 활용한 데이터를 추천받아 보세요
이 데이터와 유사한 데이터