📊 API 데이터 수집 규약 (v1.0)

클라우드 2팀 환경 데이터 수집 및 제공 시스템 전체 데이터 명세서입니다.

1. 전체 데이터 도메인 개요 (S3 저장데이터)

도메인 API 명 설명 데이터 성격
weatheruv_index자외선 지수예측
weatherair_diffusion대기 확산지수예측
air_statsctprvn_avg시도별 평균 대기오염통계
air_statssigungu_avg시군구별 평균 대기오염통계
forecastultra_short_forecast초단기 예보 (1~6시간)예측
forecastshort_forecast단기 예보 (3일)예측
air_infoweekly_air_forecast주간 미세먼지 예보예측

2. weather 도메인

2.1 자외선 지수 (uv_index)

컬럼명설명예시
areaNo행정구역코드2826051500
areaNm지역명인천광역시 중구 신포동
code분류코드A07_2
date기준 시간2026041112
h0 ~ h75시간별 자외선 지수0~11

2.2 대기 확산지수 (air_diffusion)

컬럼명설명예시
areaNo행정구역코드2826051500
areaNm지역명인천광역시 중구 신포동
code분류코드A09
date기준 시간2026041112
h0 ~ h78시간별 확산지수0~100 (낮음:100, 매우높음:25)

3. air_stats 도메인 (에어코리아 통계)

3.1 시도별 실시간 평균 (ctprvn_avg)

컬럼명설명예시
itemCode오염물질 코드 (SO2, CO, O3, NO2, PM10, PM2.5)O3
dataTime측정 날짜2026-04-11
seoul서울지역 평균0.035
sejong세종지역 평균0.048

3.2 시군구 평균 (sigungu_avg) & 현재 대기 상태

컬럼명설명예시
dataTime측정 시간2026-04-11 13:00
sidoName시도명인천
pm10Value / pm10Grade미세먼지 농도 / 지수40 / 보통
pm25Value / pm25Grade초미세먼지 농도 / 지수29 / 보통
o3Value / o3Grade오존 농도 / 지수0.061 / 보통
* SO2, CO, NO2, khai(통합대기환경) 수치 및 Grade 포함

4. forecast 도메인 (기상청 동네예보)

4.1 초단기 예보 / 4.2 단기 예보 (ultra_short / short) 통합 구조

Category (코드) 항목명 단위 및 범주
T1H / TMP기온 / 1시간 기온
TMN / TMX일 최저기온 / 최고기온 (단기)
RN1 / PCP1시간 강수량범주(1mm) 1:약한비, 2:보통비, 3:강한비
PTY강수형태코드값
POP강수확률 (단기)%
REH습도%
SKY하늘상태코드값
WSD풍속m/s 1:약한, 2:약간강한, 3:강한
SNO1시간 신적설 (단기)범주(1cm)
* 공통 컬럼: region_code, region_name, baseDate, baseTime, fcstDate, fcstTime, fcstValue, nx, ny
* +900 이상, -900 이하 값은 관측장비 결측을 의미 (Missing 값 처리)

5. air_info 도메인

5.1 초미세먼지 주간 예보 (weekly_air_forecast)

컬럼명설명예시 (텍스트 형식)
frcstOneDt ~ frcstSevenDt1일차 ~ 7일차 날짜2026-04-11
frcstOneCn ~ frcstSevenCn1일차 ~ 7일차 예보 내용서울: 낮음, 인천: 낮음, 경기북부: 낮음, 경기남부: 낮음, 강원영서: 낮음... 신뢰도: 높음
PresnatnDt발표 시각2026-04-09
문서 포털로 돌아가기
문서 포털로 돌아가기