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 물정보 상류 관측소 조회 — 댐 유입에 영향을 주는 상류 수위관측소 + 댐 유역의 우량관측소 목록 (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.

K-water 물정보 전국 댐·보 순위·목록·제원(정적 정보) — 저수용량·높이·길이·유역면적·준공년도. 이럴 때 사용: "가장 큰 댐", "댐 순위", "○○댐 몇 위", "○○댐 제원", "세종보 제원", "금강 보 목록"(basin="금강"). 사용하지 말 것: 실시간 저수율(list_dam_storage 또는 hdaps_get_timeseries). 이 도구는 제원만 제공한다. 범위: K-water 관할 주요 댐(다목적·용수·홍수조절)과 보 22곳 — 발전전용댐(한수원)·농업용 저수지 미포함이므로 답변에 이 범위를 함께 안내할 것. 각 행의 kind로 댐(dam)과 보(weir)를 구분한다. 보는 하천 횡단 구조물이라 저수용량 순위(rankings)에서는 제외되고 목록·제원 조회에만 나온다. 부분명(예: "소양")은 부분일치하는 첫 댐으로 해석되며, 응답의 dam.site_name·match_type이 실제 해석 결과다. (EN) Dam rankings, specs and lists; English dam/basin names accepted.