여울목 3단계 · 관측 데이터 수집과 DB

목표

원주 대상 계곡을 정하고, 계곡별로 쓸 강수·수위 관측소를 찾아 API로 데이터를 받을 수 있는지 확인한다. 이후 서버가 주기적으로 수집해 DB에 쌓는다.

A. 데이터 API 호출 확인

• 쓰는 데이터 API 전체

• 기상청 확인한 것 (10/29)
  • 키 하나로 활용신청한 API 전부 사용 (관측-통계 묶음형, 수치모델, 일통계)
  • 관측은 약 4분 지연 → 수집은 '현재−5분' 기준
  • 결측값 -99.9 → 0이 아니라 판정 불가로 처리
  • 수치모델 tm·tmef는 UTC, 6시간 간격
  • 원주 관측소 stn=114
• 한강홍수통제소 관측소 제원에 4단계 기준 수위가 있음: attwl(관심) / wrnwl(주의) / almwl(경보) / srswl(심각). 위경도는 도-분-초 문자열
• 보류: 기상청 레이더 추정강수(신청 페이지 없음), 산림청 산악기상(계곡 정한 뒤 필요하면)
• VM yeoulmok에서 한강홍수통제소 API를 직접 호출해 강수량·수위 데이터가 오는지 확인
  • 키 불러오기: set -a; source ~/secrets/yeoulmok.env; set +a
• 강수량 관측소 목록 (같은 HRFCO_KEY로 열림 → 강수량 API도 사용 가능 확인)

curl -s "http://api.hrfco.go.kr/$HRFCO_KEY/rainfall/info.json" | head -c 600

• 관측소 번호 rfobscd, 이름 obsnm, 주소 addr·etcaddr, 위경도 lon·lat(도-분-초 문자열)
• 수위 최신값 (10분 단위)

curl -s "http://api.hrfco.go.kr/$HRFCO_KEY/waterlevel/list/10M.json" | head -c 600

{ "wlobscd" : "1001603", "ymdhm" : "202610311150", "wl" : "0.16", "fw" : "0.05" }

• wl: 수위(m), fw: 유량(m³/s). 유량은 빈칸(" ")인 관측소가 있음 → 0이 아니라 '없음'으로 처리
• 11:59에 조회했는데 시각이 11:50 → 약 10분 늦게 들어옴. 시각은 한국시간
• 강수량 최신값 (10분 단위)

curl -s "http://api.hrfco.go.kr/$HRFCO_KEY/rainfall/list/10M.json" | head -c 400

• rf: 10분 강수량(mm)
• 관측소 하나만 지정해서 부르기

curl -s "http://api.hrfco.go.kr/$HRFCO_KEY/waterlevel/list/10M/1006664.json"

• 응답이 작아서 잘리지 않음 → 서버 수집은 이 방식으로 함 (트러블슈팅 1번 참고)
• 과거 자료 조회: list/{단위}/{번호}/{시작}/{끝}.json
  • 10분(10M)은 12자리 yyyymmddhhmm, 1시간(1H)은 10자리 yyyymmddhh (트러블슈팅 2번 참고)
  • 결과를 시각·값만 보기 좋게 출력

P='import sys,json;[print(x["ymdhm"],x.get("wl",x.get("rf"))) for x in reversed(json.load(sys.stdin)["content"])]'
curl -s "http://api.hrfco.go.kr/$HRFCO_KEY/rainfall/list/1H/10064070/2025071900/2025071923.json" | python3 -c "$P"

B. 원주 관측소 찾기

• 관측소 전체 목록을 파일로 받아 주소에 '원주'가 들어간 것만 골라내려 했으나 응답이 중간에 잘림 (트러블슈팅 1번 참고)
• 강수량: 잘린 파일 안에 원주 관측소가 들어 있어서 grep으로 찾음

curl -s -o rf_info.json "http://api.hrfco.go.kr/$HRFCO_KEY/rainfall/info.json"
grep -B2 -A4 "obsnm.*원주" rf_info.json

• 수위: 잘린 파일엔 부론면 남한강 본류 2곳(법천교, 남한강대교)뿐이라 계곡 경보엔 못 씀
  • 본류: 강의 가장 큰 줄기. 계곡 물은 작은 지류를 거쳐 들어옴
• 한강홍수통제소 홈페이지 → 수문 → 실시간 수문자료 → 수위 자료에서 원주 수위 관측소 11곳 확인
  • 가현교, 남한강대교, 동부교, 문막교, 법천교, 봉미교, 옥산교, 원주교, 장현교, 지정대교, 판됀2교
• 관측소 팝업의 엑셀 다운로드로 주소, 팝업 주소창의 obscd로 번호 확인
  • 예: wlpopup.do?obscd=1006664 → 동부교

• 두 번호 모두 API로 호출해 홈페이지 값과 같은 것 확인

C. 대상 계곡과 사고일 데이터

• 네이버 지도로 계곡 물이 어느 수위 관측소를 지나는지 확인
  • 동부교로 오는 원주천은 금대리 → 판부면 → 동부교 방향(중앙고속도로를 따라)으로 내려옴
  • 서곡리 개울은 서곡초 서쪽을 지나 북쪽으로 가지만 동부교 줄기가 아님
• 서곡리 물(서곡천)은 섬강 수계로, 흥업면 사제리 사제교를 지나 호저면 만종리 쪽으로 흐름 (강원일보 기사 기준). 원주 시내 원주천 위 동부교·원주교는 안 지남
  • 수계: 물이 모여 같은 큰 강으로 흘러가는 하천 묶음
• 대상 계곡 2곳으로 정함 (신청서의 '계곡 2~3곳'과 맞음)

• 서곡리 하류 수위 후보 3곳 주소 확인 (홈페이지 팝업 엑셀)

• 결정 방향: 서곡리는 상류 강수 사전 경보만, 하류 수위 즉시 경보는 금대리만 (회의에서 확정)
• 사고일(2025-07-19) 1시간 자료 조회

curl -s "http://api.hrfco.go.kr/$HRFCO_KEY/rainfall/list/1H/10064070/2025071900/2025071923.json" | python3 -c "$P"
curl -s "http://api.hrfco.go.kr/$HRFCO_KEY/rainfall/list/1H/10064075/2025071900/2025071923.json" | python3 -c "$P"
curl -s "http://api.hrfco.go.kr/$HRFCO_KEY/waterlevel/list/1H/1006664/2025071900/2025071923.json" | python3 -c "$P"

• 서곡초교 강수 (mm/시간)

03시 1   04시 12   05시 11   06시 1   07시 8   08시 11
10시 2   12시 1    19시 4    21시 4   23시 1   (나머지 0)
하루 약 56mm, 새벽~아침에 몰림

• 신촌리 강수, 동부교 수위: 그날 24시간 전부 결측
  • 결측: 관측소가 그 시각 값을 못 보내서 비어 있는 것
  • 동부교는 어제(10/30)와 올해 7월 자료는 정상 → 사고일만 기록이 없거나 설치가 그 뒤일 가능성. 언제부터 있는지는 미확인
• 기준값 정리
  • 상류 강수 기준(X): 서곡초교 사고일 값으로 1차 설정 가능
  • 하류 수위 기준(Y): 사고일 자료가 없어서 다른 강우일 기록이나 관측소 공식 기준 수위로 정해야 함 → 컨설팅 1회차 질문

D. 위치정보 법적 절차

• 기준은 서버가 개인위치정보를 받느냐
  • 개인위치정보: 특정 사람이 어디 있는지 알 수 있는 위치 정보
  • 개인위치정보를 다루는 위치기반서비스는 신고 필요 (담당: 방송미디어통신위원회, 예전 방송통신위원회)
  • 개인위치정보를 다루지 않으면 신고 의무 폐지. 보호조치·누설 금지 등 일부 규정은 그대로 적용
• 여울목 기능별 판단

• 결정 방향: GPS는 폰 안에서만 쓰고 서버로 보내지 않음. 웹의 실시간 사용자 수·공무원 알림은 후순위
• 근거 기사가 2015년이라 이후 개정 여부는 컨설팅 때 확인
• 참고: 비즈한국 기사

트러블슈팅

1. 관측소 전체 목록 API 응답이 중간에 잘림

• 증상 : waterlevel/info.json, rainfall/info.json을 받아 파이썬으로 읽으면 JSONDecodeError
• 확인한 것 : 받은 파일 끝이 문장 중간에서 끊김. 헤더는 200, Transfer-Encoding: chunked. 압축·HTTP/1.0으로 다시 받아도 해결 안 됨
• 원인 : 서버가 큰 목록을 끝까지 보내지 않음 (우리 쪽 문제 아님)
• 해결 : 원주 관측소는 홈페이지 실시간 수문자료에서 찾고, 팝업 주소의 obscd로 번호 확인. 운영은 번호를 지정해서 부르므로 응답이 작아 영향 없음
• 재발 방지 : 관측소 목록은 전체 API에 의존하지 않고, 쓸 관측소 번호를 DB에 고정해 둔다

2. 1시간 자료 조회에서 값이 전부 비어 나옴

• 증상 : 동부교 1시간 자료를 여러 날짜로 조회했는데 값이 전부 빈칸이거나 에러
• 확인한 것 : 날짜를 12자리(분 포함)로 넣었음. 10자리로 다시 조회하니 최근 값은 정상
• 원인 : 1시간 자료는 날짜를 10자리(yyyymmddhh)로 넣어야 함
• 해결 : 10자리로 다시 조회. 그래도 2025-07-19는 결측이라 실제로 기록이 없는 것으로 확인
• 재발 방지 : 10분은 12자리, 1시간은 10자리. 빈 결과가 나오면 형식부터 확인

남은 작업

• 한강홍수통제소 강수량·수위 API 호출 확인
• 원주 대상 계곡 2곳과 관측소 매칭
• 사고일(2025-07-19) 과거 데이터 확인
• 동부교 수위 기록이 언제부터 있는지 확인
• 하류 수위 기준(Y) 정할 다른 강우일 찾기
• 서곡리 하류 수위 관측소 찾기 → 쓸 만한 곳 없음, 강수 경보만 (회의에서 확정)
• 위치정보 관련 법적 절차 1차 확인 (이후 개정 여부는 컨설팅 때)
• DB 설계와 수집 코드

set -a; source ~/secrets/yeoulmok.env; set +a                                    # API 키를 환경변수로 불러옴
curl -s "http://api.hrfco.go.kr/$HRFCO_KEY/waterlevel/list/10M/1006664.json"     # 동부교 최신 수위 (10분 단위)
curl -s "http://api.hrfco.go.kr/$HRFCO_KEY/rainfall/list/1H/10064070/2025071900/2025071923.json"  # 서곡초교 사고일 강수 (1시간 단위)

{ "wlobscd": "1006664", "ymdhm": "202610311200", "wl": "0.08", "fw": " " }

curl -s -o rf_info.json "http://api.hrfco.go.kr/$HRFCO_KEY/rainfall/info.json"  # 강수 관측소 전체 목록을 파일로 저장
grep -B2 -A4 "obsnm.*원주" rf_info.json                                          # 이름에 '원주'가 들어간 것만 앞뒤 줄과 함께 출력