Kwater

K-water 물정보 수자원 데이터 분석 — 추이(trend), 기간 비교(compare, 예: 작년 대비), 상관(correlation), 통계(statistics), 댐-하류 영향(dam_downstream), 호우 시 수문 연쇄(event_chain). 이럴 때 사용: "작년 대비 어때", "추이가 어떻게 변했나", "월별 평균", "방류가 하류에 얼마나 영향 주나", "비 온 뒤 저수율·방류가 어떻게 움직였나". 사용하지 말 것: 단순 현재 수치 조회(hdaps_get_timeseries·get_kdm_data). 미래 예측은 어떤 유형으로도 하지 않는다. (EN) Analyze water data: trend, period comparison, correlation, statistics, dam-downstream impact.

K-water 물정보 유역(대권역) 물 보유량 브리핑 — 총저수량·가중 저수율과 작년·최근 10년 평균 대비 증감을 1회 호출로 계산. 이럴 때 사용: "한강수계 물 사정", "낙동강 저수 상황 작년보다 어때", "전국 유역별 물 보유량" 등 **유역·수계·전국 단위** 질문. 댐을 하나씩 조회해 더하지 말 것. 사용하지 말 것: 특정 댐 1곳(hdaps_get_timeseries) · 댐별 저수율 순위(list_dam_storage). 가중 저수율 = Σ저수량÷Σ총저수용량 (댐별 저수율의 단순평균이 아님). 다목적·생공전용댐만 집계하고 홍수조절 전용댐은 평시 저수율 0~수%가 정상이라 제외한다. 응답의 산식·커버리지 필드를 반드시 함께 안내할 것 — 집계에서 빠진 댐이 있다. (EN) Basin-level water storage briefing with year-ago and 10-year-normal comparison.

K-water 물정보 연결 관측소 조회 — 댐과 연결된 상류·하류 수위관측소를 한 번에 반환 (상류+하류 통합). 이럴 때 사용: 댐 주변 하천 관측망 전체를 한눈에 볼 때. (EN) Upstream and downstream stations connected to a dam, in one call.

K-water 물정보 하류 관측소 조회 — 댐 방류의 영향을 받는 하류 수위관측소 목록. 물흐름 네트워크 기준, 거리·도달시간 포함. 이럴 때 사용: "○○댐 방류하면 어디 수위가 오르나", 하류 영향 범위 확인. 응답에 좌표·거리(dist_km)·방류량별 도달시간 범위가 담기고 흐름 모식도 위젯이 첨부된다. 부분명(예: "소양")은 부분일치 댐으로 해석되며 응답의 dam_name이 실제 해석 결과다. (EN) Downstream stations affected by a dam's discharge.

K-water 물정보 수질·기상·댐 장기 이력 조회 — 수질(BOD·COD·pH·DO·TOC), 기상(기온·습도·풍속), 수년~수십년 이력. 이럴 때 사용: "○○댐 수질 어때", "서울 기온", 댐의 장기 이력·연도별 비교. 사용하지 말 것: 댐·수위·우량의 실시간 수치(hdaps_get_timeseries가 더 빠르고 정확하다). ⚠ 응답의 모든 시각·날짜는 이미 KST — 시간대 변환 금지. site_name만 주면 시설을 자동 검색해 기본 항목을 반환한다. days로 기간, time_key로 단위(h_1·d_1·mt_1)를 조정. "작년·지난 10년 이맘때와 비교"는 include:["comparison"] 1회로 답한다(same_day_by_year) — 해마다 나눠 조회하지 말 것. 분석·모델링용 파일 요청에는 기간을 지정해 조회한 뒤 응답 note의 export URL(CSV·Parquet)을 그대로 안내할 것 — 일별은 수십년도 수초 내 반환. (EN) Water quality, weather, and long-term dam history from KDM; English facility/item names accepted.

K-water 물정보 우리 동네 수돗물 공급 경로 — 행정동의 취수장 → 정수장 → 배수지(최대 3계통), 공급 정수장 수질(탁도·잔류염소·pH), 수도요금·유수율(전국 대비), 근처 다목적댐을 1회 호출로 반환. 이럴 때 사용: "우리 동네 수돗물 어디서 와?", "○○동 정수장·배수지", "○○동 수돗물 수질" 등 **동네 단위 수돗물** 질문. 사용하지 말 것: 하천·호소 수질(get_kdm_data·get_water_quality_trend) · 현재 단수 여부(이 자료에 없다). 행정동·법정동 이름으로 찾는다 — 시군구를 함께 주면 정확하다(예: "대전 대덕구 회덕동"). 여러 곳이 걸리면 고르지 않고 후보를 준다(ambiguous) — 사용자에게 시군구를 물을 것. ⚠ 수질은 판정하지 말고 측정 시점(실시간/월간 법정검사)을 함께 전할 것 — water_quality.notes의 ⚠ 경고(오래된 값·갱신 멈춤)는 수치보다 먼저 전한다. 근처 댐은 원수 댐이 아니다. 계통은 가뭄기초조사 기준(연 1회)이다. (EN) Tap-water supply route (intake → treatment plant → service reservoir) and plant water quality for a Korean administrative dong.

K-water 물정보 상류 관측소 조회 — 댐 유입에 영향을 주는 상류 수위관측소 + 댐 유역의 우량관측소 목록 (K-water 공식 소관 관측망 기준). 이럴 때 사용: 상류 관측망 파악, 유입 영향 분석. "○○댐 유역에 비 얼마나 왔나"는 이 도구로 우량관측소를 찾은 뒤 hdaps_get_timeseries(facility_type=rainfall)로 조회할 것. 부분명(예: "소양")은 부분일치 댐으로 해석되며 응답의 dam_name이 실제 해석 결과다. (EN) Upstream water-level and basin rainfall stations for a dam.

K-water 물정보 수질측정소 장기 추이 해석 — 연간 중앙값·계절성·5년 단위 비교를 1회 호출로 계산. 이럴 때 사용: "○○ 수질 좋아졌나", "최근 10년 수질 추이", "여름에 수질이 나빠지나" 등 **여러 해에 걸친 변화·계절성** 질문. 사용하지 말 것: 최신 수질값 1건(get_kdm_data facility_type=water_quality) · 댐 수위·저수율. 연간 대표값은 중앙값이다(강우·조류 스파이크가 연 대표값을 끌어당기지 않게 평균을 쓰지 않음). 진행 중인 연도는 계절 편향 때문에 5년 비교에서 제외된다. ⚠ 응답의 산식·한계를 반드시 함께 안내할 것 — TOC 관측 개시 시점은 지점마다 다르고, 국내 하천/호소 생활환경기준은 먹는물·WHO 가이드라인과 다른 체계다. (EN) Long-term water quality trend: annual medians, seasonality, 5-year comparison.

K-water 물정보 실시간 시계열 조회 — 댐·수위관측소·우량관측소의 저수율·저수위·유입량·방류량·수위·유량·강우량. 10분~1일 단위 실측. 이럴 때 사용: "○○댐 저수율", "○○ 수위 지금 어때", "최근 24시간 유입량 추이" 등 특정 시설의 현재값·기간 추이. 사용하지 말 것: 예보·전망(이 서버는 실측만 제공) · 여러 댐 저수율 비교(list_dam_storage를 1회 호출) · 수질(get_kdm_data). ⚠ 응답의 모든 시각은 이미 한국표준시(KST) — UTC로 간주하거나 시간대 변환 금지. 기간: 미지정 시 최근 3시간(10분 단위). 단 저수율·저수량 등 완만 항목만 물으면 최근 7일(1시간)로 자동 확장. **"지금 저수율?"처럼 현재값 1건만 필요하면 detail="latest"를 함께 보낼 것** — 자동 확장을 건너뛰어 응답이 작고 빠르다(제보 #17: 단순 최신값 요청에 181건이 오던 문제). **지역명도 그대로 넣을 수 있다** — name="울산"·"전북"·"울산 남구"처럼 시·도나 시·군·구를 주면 그 지역 관측소를 시·군·구가 고루 들어가게 골라 **지점별 값**으로 답한다(지역 평균은 관측소 밀도에 좌우되어 단일 수치로 주지 않는다). "울산 비 왔어?" 같은 질문에 시설명을 되묻지 말고 이렇게 조회할 것. "최근 N시간"에는 recent_hours=N을 쓸 것. 특정 구간은 start_date/end_date(YYYYMMDD) — 사용자에게 "직접 조회해달라"고 되묻지 말고 그 파라미터로 재호출할 것. 7일 초과 구간은 서버가 KDM 일단위로 자동 전환한다. ⚠ interval은 힌트일 뿐 실제 간격은 날짜 범위로 결정된다(1일 이하 10분, 1~7일 1시간). 다만 "일별"·"날짜별" 요청에는 interval="1d"를 지정하면 **K-water 공식 일자료**를 반환한다 — 원천의 하루는 01:00~24:00이다. 공식 일자료가 없는 날·항목만 원자료를 집계하며, 그 사실은 daily_source(official/aggregated/mixed)와 aggregated_days로 알린다. ⚠ "왜 이 시각까지만 있나요?" 류 질문에는 추측(반영 지연 등)하지 말고 이 도구를 즉시 재호출해 as_of를 다시 확인할 것. 항목명은 list_measurements로 확인. 미지정 시 시설 유형별 기본 항목이 반환된다. 분석·모델링용 파일 요청에는 기간을 지정해 조회한 뒤 응답 note의 export URL(CSV·Parquet)을 그대로 안내할 것. (EN) Near-real-time timeseries for Korean dams and gauging stations; English facility/item names accepted.

K-water 물정보 댐 저수율 일괄 조회 — 여러 댐의 최신 저수율을 1회 호출로. 전국 또는 지정 목록. 이럴 때 사용: "전국 댐 저수율", "저수율 낮은/높은 댐", "○○댐과 △△댐 비교" 등 **댐이 2곳 이상**인 질문. 이때 hdaps_get_timeseries를 댐마다 반복 호출하지 말고 반드시 이 도구를 1회 호출할 것. 사용하지 말 것: 특정 댐 1곳의 추이·상세(hdaps_get_timeseries). 요약은 두 값을 함께 준다: 단순평균 저수율(댐별 산술평균 — 댐 크기 미반영)과 물량가중 저수율(Σ저수량÷Σ총저수용량, get_basin_water_status와 같은 산식). 한쪽을 "평균 저수율"로 뭉뚱그리지 말 것. 모든 시각은 KST(~10분 딜레이). 범위: K-water 관할 댐(농업용 저수지·발전 조정지 제외). (EN) Latest storage rate for multiple dams in one call.