Products · Data API

현장 강우 데이터 API

요약

동 단위 현장 강우를 1분 간격으로. 품질 정보까지 담아 바로 쓰는 데이터로 제공합니다.

갱신일 작성 우짜(WOOZZA) 콘텐츠팀

KEY POINTS

  • 1 MIN

    1분 단위 현장 강우

    설치 지점마다 1분 간격 강우·풍향·풍속

  • QC

    품질 정보 포함

    원시·보정 여부와 품질 플래그를 함께 제공

  • DENSE

    동 단위 고밀도

    자치구가 아닌 동 단위 관측 지점

  • REST

    표준 REST · JSON

    조회 API와 임계값 웹훅 알림

요청 한 번이면 바로 쓰는 데이터

관측 지점 ID로 최신 값을 조회합니다.

요청
curl "$WOOZZA_API/v1/observations/latest?station=WZ-RG-0002" \
  -H "Authorization: Bearer $WOOZZA_API_KEY"
import os, requests

r = requests.get(
    f"{os.environ['WOOZZA_API']}/v1/observations/latest",
    params={"station": "WZ-RG-0002"},
    headers={"Authorization": f"Bearer {os.environ['WOOZZA_API_KEY']}"},
)
obs = r.json()
print(obs["rain_1h_mm"], obs["quality"]["status"])
const res = await fetch(
  `${process.env.WOOZZA_API}/v1/observations/latest?station=WZ-RG-0002`,
  { headers: { Authorization: `Bearer ${process.env.WOOZZA_API_KEY}` } },
);
const obs = await res.json();
console.log(obs.rain_1h_mm, obs.quality.status);
응답 · 200 OK예시 응답 · 베타
{
  "station_id": "WZ-RG-0002",
  "name": "난곡동 948-1941",
  "location": { "lat": 37.4752, "lon": 126.9201 },
  "observed_at": "2026-10-17T01:25:00+09:00",
  "rain_1min_mm": 1.4,
  "rain_10min_mm": 14.4,
  "rain_1h_mm": 82.5,
  "wind": { "dir_deg": 225, "speed_ms": 4.8 },
  "quality": { "status": "corrected", "flags": [] },
  "risk_level": 4
}

무엇이 다른가

우짜 현장 강우 API일반 공개 기상 자료
관측 밀도동 단위 관측 지점자치구·광역 단위 관측소
갱신 주기1분자료·기관별 상이
품질 정보원시·보정 여부 + 품질 플래그값 위주 제공
조회 기준관측 지점 · 1 km 격자관측소 기준
알림 연동임계값 웹훅별도 구축 필요

엔드포인트

  • GET/v1/stations관측 지점 목록·위치·상태
  • GET/v1/observations/latest지점별 최신 1분 관측값
  • GET/v1/observations기간 조회 (1분·10분·1시간 집계)
  • GET/v1/grid/rainfall1 km 격자 강우
  • POST/v1/webhooks임계값 도달 시 알림 등록

현장 관측값이 API로 나가기까지

2단계 처리 구조

Step 1

현장에서 빠짐없이 수집

  • 설치 지점별 1분 관측
  • 수신 상태·장비 상태 기록
  • 결측 구간 표시

Step 2

바로 쓸 수 있게 정제

  • 풍향·풍속 영향 보정
  • 이상치 탐지·품질 플래그
  • 지점·격자 단위 API로 제공

API 키 요청하기

대상 지역과 용도를 알려주시면 테스트 키를 보내드립니다.

API 키 요청하기

관련 페이지

Read the Rain. Protect What Matters.

문의하기 contact.woozza@gmail.com