データソースとデータ構造
このサイトのデータ起源、ダム名寄せの方法、テーブル構造、欠損の分布、観測の粒度をまとめています。 外部公開データのみを利用し、独自の改変は最小限 (単位換算・名寄せ・正規化) です。
1. 使用データソース
優先度は同一ダムで複数ソースが値を持つときに採用するソースの並びです (大きい数字が優先)。
| ソース | 提供データ | 更新頻度 | ライセンス | 優先度 | 直近30日 | 最終取得 |
|---|---|---|---|---|---|---|
| shimane-bousai 島根県防災Web (bousai.pref.shimane.lg.jp/dam) — /data/dam/list/{ts}.json | 島根県土木部管理 14 ダム (布部/山佐/三瓶/波積/八戸/浜田/第二浜田/大長見/御部/益田川/笹倉/大峠/銚子/美田) の貯水位・有効貯水量(千m³)・全流入量・全放流量・貯水率。県直轄ダムの新規カバレッジ。 | 時次 (元データは 10 分粒度; 取得は毎時 :37) | 公開情報 — 出典明示で再配布可 | 313 | 9,384 件 19 基 | 2026/06/28 18:00 JST |
| tottori-bousai 鳥取県防災Web (bousai.pref.tottori.lg.jp/dam) — /data/dam/list/{ts}.json | 鳥取県管理 6 ダム (百谷/佐治川/東郷/賀祥/朝鍋/菅沢) の貯水位・有効貯水量(千m³)・全流入量・全放流量・貯水率。菅沢ダムは本ソース唯一の観測源。 | 時次 (元データは 10 分粒度; 取得は毎時 :33) | 公開情報 — 出典明示で再配布可 | 312 | 3,322 件 6 基 | 2026/06/28 20:20 JST |
| tochigi-bodik 栃木県河川水位・雨量情報システム ダム諸量 (data.bodik.jp/dataset/090000_river_dam_parameter) | 栃木県管理 7 ダム (寺山/塩原/西荒川/東荒川/三河沢/中禅寺/松田川) の貯水位・貯水量(m³)・全流入量・全放流量。BODIK NGSI-v2 CSV。 | 時次 (元データは 10 分粒度; 取得は毎時 :27) | CC-BY 4.0 — 出典明示で再配布可 | 311 | 210 件 7 基 | 2026/06/28 0:50 JST |
| hyogo-bodik 兵庫県 ダム諸量データ (data.bodik.jp/dataset/280003_dam_hyogo) | 兵庫県管理 ~20 ダム (青野/生野/引原/安室/金出地/与布土/諭鶴羽 ほか) の貯水位・貯水量(m³)・全流入量・全放流量。BODIK オープンデータ CSV。 | 時次 (元データは 10 分粒度; 取得は毎時 :25) | CC-BY 4.0 — 出典明示で再配布可 | 311 | 14,693 件 21 基 | 2026/06/28 20:10 JST |
| osaka-bousai 大阪府河川防災情報 (osaka-kasen-portal.net/suibou/publicdata/choryuryo.json) | 大阪府管理 3 ダム (安威川/箕面川/狭山池) の有効貯水量(m³)・貯水率。水位・流量は非公開。 | 時次 (元データは 1 分更新; 取得は毎時 :31) | 公開情報 — 出典明示で再配布可 | 310 | 1,854 件 3 基 | 2026/06/28 20:30 JST |
| hiroshima-bousai 広島県防災Web (bousai.pref.hiroshima.lg.jp/dam) — /data/dam/list/{ts}.json | 広島県管理 18 ダムの貯水位・有効貯水量(千m³)・全流入量・全放流量・貯水率。県管理 12 + 国管理 5 (cgr-mlit-dam と重複) + 農水省 1。 | 時次 (元データは 10 分粒度; 取得は毎時 :29) | 公開情報 — 出典明示で再配布可 | 310 | 10,639 件 18 基 | 2026/06/28 20:10 JST |
| fukuoka-bodik 福岡市関連9ダム貯水量 — BODIK オープンデータ (data.bodik.jp/dataset/401307_mizukanri) | 福岡市水道局管理 9 ダム (南畑/五ケ山/脊振/曲渕/江川/久原/長谷/猪野/瑞梅寺) の有効貯水量(千m³)。水位・流量は非公開。 | 時次 (毎時更新; 取得は毎時 :35) | CC-BY 4.0 (出典明示で商用利用可) | 310 | 4,838 件 9 基 | 2026/06/28 20:00 JST |
| kanagawa-dam かながわの水がめ (kanagawa-dam.jp) — JSON API `summary.php` | 神奈川県 5 ダム (相模/城山/三保/宮ヶ瀬/道志) の貯水位・貯水量・貯水率・流入量・放流量。 | 時次 (1 時間粒度; 取得は毎時 :05) | 神奈川県企業庁 — 出典明示で再配布可 (推定) | 310 | 3,340 件 5 基 | 2026/06/27 11:00 JST |
| kasenbosai 国土交通省 川の防災情報 (river.go.jp) — tmlist/dam per-obs JSON | 全国 ~870 ダムの 10 分粒度 貯水位・貯水量・有効容量貯水率・全流入量・全放流量。MLIT SCC の per-dam tmlist/dam/{obs_fcd}.json から取得。 | 時次 (元データは 10 分粒度; 取得は毎時 :03) | 国の公式統計値 — 出典明示で再配布可 | 310 | 650,690 件 868 基 | 2026/06/28 21:00 JSTparsed |
| okayama-bousai おかやま防災ポータル (bousai.pref.okayama.jp) | 岡山県管理 ~15 ダム (旭川/鳴滝/河平/三室川/黒木/香々美/久賀/津川/黒谷/鬼ヶ岳/大佐/日笠/槙谷/楢井 ほか) の貯水位・有効貯水量・貯水率・流入量・全放流量。 | 時次 (元データは 30 分粒度; 取得は毎時 :21) | 岡山県オープンデータ — 出典明示で再配布可 (推定) | 309 | 14,887 件 21 基 | 2026/06/28 20:00 JST |
| wakayama-kasen | 和歌山県河川防災情報 ダム諸量 — 19 ダム hourly CSV | — | — | 308 | 9,638 件 19 基 | 2026/06/28 20:30 JST |
| oita-bousai | 大分県河川情報 ダム諸量現況表 — 防災Web HTML table, 10 dams, hourly | — | — | 308 | 1,270 件 10 基 | 2026/06/28 18:50 JST |
| shiga-bousai 滋賀県土木防災情報システム (shiga-bousai.jp/dam) | 滋賀県 6 ダム (日野川/石田川/宇曽川/青土/姉川/永源寺) の貯水位・流入量・放流量・60分雨量。 | 時次 (1 時間粒度; 取得は毎時 :07) | 滋賀県オープンデータ — 出典明示で再配布可 (推定) | 308 | 6,349 件 6 基 | 2026/06/28 21:00 JST |
| tokushima-bousai | 徳島県河川砂防水位観測所 ダム諸量情報 — 7 ダム (Shift_JIS HTML, 10分更新) | — | — | 308 | 3,494 件 7 基 | 2026/06/28 20:50 JST |
| gifu-kasen | 岐阜県川の防災情報 ダム諸量 — 14 ダム (UTF-8 HTML, hourly) | — | — | 308 | 6,501 件 13 基 | 2026/06/28 21:00 JST |
| niigata-bousai 新潟県河川防災情報システム (doboku-bousai.pref.niigata.jp/kasen) | 新潟県管理 ~20 ダム (三面/奥三面/大谷/胎内川/奥胎内/早出川/破間川/笠堀/刈谷田川 ほか) の貯水位・貯水率・流入量・全放流量。 | 時次 (元データは 10 分粒度; 取得は毎時 :23) | 新潟県オープンデータ — 出典明示で再配布可 (推定) | 308 | 15,114 件 20 基 | 2026/06/28 20:20 JST |
| yamagata-bousai | 山形県河川・砂防情報 — 防災Web JSON dk=4, hourly (~17 ダム) | — | — | 308 | 8,758 件 16 基 | 2026/06/28 20:50 JST |
| fukui-bousai | 福井県河川・砂防総合情報システム ダム諸量現況表 — 13 ダム (Shift_JIS HTML, hourly) | — | — | 308 | 6,765 件 13 基 | 2026/06/28 21:10 JST |
| ishikawa-kasen | 石川県河川総合情報システム ダム諸量 — 11 県管理ダム hourly JSON | — | — | 308 | 6,071 件 11 基 | 2026/06/28 20:00 JST |
| ibaraki-bousai | 茨城県河川防災情報 ダム諸量現況表 — 防災Web HTML table, 7 dams, hourly | — | — | 308 | 3,906 件 7 基 | 2026/06/28 20:40 JST |
| miyazaki-bousai | 宮崎県ダム諸量現況表 — 防災Web HTML table, 13 dams, hourly | — | — | 308 | 7,265 件 13 基 | 2026/06/28 20:50 JST |
| akita-kasen | 秋田県ダム一覧表 — 防災Web HTML table, 18 dams, hourly | — | — | 308 | 9,438 件 17 基 | 2026/06/28 21:00 JST |
| toyama-bousai | 富山県 県内ダム情報実況表 — 16 ダム (Salesforce public page, hourly) | — | — | 308 | 8,615 件 16 基 | 2026/06/28 21:00 JST |
| kumamoto-bousai | 熊本県防災情報システム 地方別ダム情報 — 6 ダム (Shift_JIS JS, 60分更新) | — | — | 308 | 3,334 件 6 基 | 2026/06/28 20:00 JST |
| miyagi-kasen | 宮城県土木総合情報システム ダム現況表 — 21 ダム (18 県管理 + 3 国管理), hourly | — | — | 308 | 1,774 件 4 基 | 2026/06/28 21:00 JST |
| iwate-kasen | 岩手県河川情報システム — Gamen32Servlet, 10 dams, hourly | — | — | 308 | 4,269 件 8 基 | 2026/06/28 20:00 JST |
| aichi-kasen | 愛知県川の防災情報 ダム表 — 2 ダム (UTF-8 HTML, 10分更新) | — | — | 308 | 6,960 件 2 基 | 2026/06/28 21:00 JST |
| nagano-kasen | 長野県 河川砂防情報ステーション — 17 県管理ダム hourly JSON | — | — | 308 | 9,268 件 17 基 | 2026/06/28 20:00 JST |
| fukushima-kasen | 福島県河川流域総合情報システム — 11 県管理ダム hourly JSON | — | — | 308 | 6,010 件 11 基 | 2026/06/28 20:00 JST |
| kochi-bousai | 高知県水防情報システム ダム諸量現況表 — 11 ダム (静的 Shift_JIS HTML) | — | — | 308 | 6,019 件 11 基 | 2026/06/28 20:30 JST |
| kagawa-bousai | かがわ防災Webポータル ダム諸量 — 18 ダム hourly JSON | — | — | 308 | 9,920 件 18 基 | 2026/06/28 20:30 JST |
| saga-bousai | 佐賀県河川砂防情報システム ダム現況表 — 19 県管理ダム hourly (3-page Shift_JIS) | — | — | 308 | 9,509 件 18 基 | 2026/06/28 20:30 JST |
| kyoto-bousai | 京都府 河川防災情報 ダム諸量現況表 — 6 ダム hourly | — | — | 308 | 3,238 件 6 基 | 2026/06/28 20:40 JST |
| saitama-suibo | 埼玉県 川の防災情報 ダム諸量 — 9 ダム hourly CSV | — | — | 308 | 4,111 件 8 基 | 2026/06/28 20:30 JST |
| yamaguchi-bousai | 山口県土木防災情報システム ダム観測局 — 23 ダム hourly HTML | — | — | 308 | 12,101 件 23 基 | 2026/06/27 20:50 JST |
| gunma-kasen | 群馬県水位雨量情報システム ダム現況表 — 7 県管理ダム hourly | — | — | 308 | 3,855 件 7 基 | 2026/06/28 20:00 JST |
| tndam-hyogo | 兵庫県丹波農林振興事務所 ダムテレメータ — 6 dams (Tanba area), hourly | — | — | 308 | 491 件 6 基 | 2026/06/28 20:51 JST |
| shizuoka-bousai | 静岡県 SIPOS ダム情報 JSON API — 6 dams (奥野/太田川/都田川農/大倉川農/青野大師/長島国), hourly | — | — | 308 | 522 件 5 基 | 2026/06/28 20:50 JST |
| kagoshima-bousai | 鹿児島県防災ポータル ダム情報 — JSON API, hourly (active during flood events) | — | — | 308 | — | — |
| ehime-bousai | 愛媛県河川・砂防情報システム ダム諸量経過表 — 12 dams (6 pref + 6 national), hourly | — | — | 308 | 1,290 件 12 基 | 2026/06/28 20:00 JST |
| nagasaki-kasen | 長崎県河川砂防情報 ダム情報 — 35 ダム (JSON, 30分更新) | — | — | 308 | 33,770 件 32 基 | 2026/06/28 20:50 JST |
| nara-kasen | 奈良県河川情報システム ダム現況 — 5 ダム (Shift_JIS HTML, ~10分更新) | — | — | 308 | 2,224 件 4 基 | 2026/06/28 21:00 JST |
| tottori-dam 鳥取県ダム諸量情報システム (tottoridam.jp) | 鳥取県 5 ダム (賀祥/朝鍋/佐治川/東郷/百谷) の貯水位・有効貯水量・貯水率・流入量・放流量・時間雨量。 | 時次 (1 時間粒度; ページは 10 分毎にリフレッシュ; 取得は毎時 :09) | 鳥取県オープンデータ — 出典明示で再配布可 (推定) | 307 | 3,780 件 5 基 | 2026/06/28 21:00 JST |
| aomori-dam 青森県砂防ダム情報 (kasensabo.bousai.pref.aomori.jp) | 青森県 7 ダム (下湯/浅虫/久吉/遠部/浅瀬石川/津軽/清水目) の貯水位・流入量・全放流量。 | 時次 (リアルタイム; 取得は毎時 :11) | 青森県オープンデータ — 出典明示で再配布可 (推定) | 306 | 3,775 件 5 基 | 2026/06/28 21:00 JST |
| hkd-mlit-dam 国土交通省 北海道開発局 ダムリアルタイム情報 (info-dam.hdb.hkd.mlit.go.jp) | 北海道開発局直轄 18 ダム (平取/忠別/豊平峡/岩尾内/漁川/定山渓/金山/鹿ノ子/新桂沢/二風谷/美利河/留萌/サンル/札内川/大雪/滝里/十勝/夕張シューパロ) の貯水位・流入量・放流量・貯水量・貯水率。 | 時次 (元データは 10 分粒度; 取得は毎時 :13) | 国の公式統計値 — 出典明示で再配布可 | 305 | 9,814 件 18 基 | 2026/06/28 21:10 JST |
| cgr-mlit-dam 国土交通省 中国地方整備局 ダム防災情報システム (cgr.mlit.go.jp/cginfo/syokai/busyo/kasen/dam_bousai) | 中国地方整備局直轄 11 ダム (岡山:苫田 / 広島:土師・弥栄・八田原・温井・灰塚 / 山口:島地川 / 鳥取:菅沢・殿 / 島根:志津見・尾原) の貯水位・流入量・放流量・貯水率(有効容量)・雨量。 | 時次 (取得は毎時 :15) | 国の公式統計値 — 出典明示で再配布可 | 304 | 6,236 件 11 基 | 2026/06/28 21:00 JST |
| skr-hiji-dam | 国土交通省 四国地方整備局 肱川ダム統合管理事務所 — 野村・鹿野川ダム (Ehime) | — | — | 303 | 1,107 件 2 基 | 2026/06/28 20:10 JST |
| qsr-ryumon-dam | 国土交通省 九州地方整備局 竜門ダム管理所 — 竜門ダム (佐田川水系, Fukuoka) | — | — | 303 | 154 件 1 基 | 2026/06/28 20:10 JST |
| ktr-tone-dam | 国土交通省 関東地方整備局 利根川ダム統合管理事務所 — 9 国管理ダム hourly JSON | — | — | 303 | 4,927 件 9 基 | 2026/06/28 20:00 JST |
| ktr-kinu-dam 国土交通省 関東地方整備局 鬼怒川ダム統合管理事務所 (ktr.mlit.go.jp/kinudamu/daminfo) | 関東地方整備局 鬼怒川ダム統管直轄 4 ダム (栃木県: 五十里/川俣/川治/湯西川) の貯水位・全流入量・全放流量・累加雨量。 | 時次 (元データは 10 分粒度; 取得は毎時 :17) | 国の公式統計値 — 出典明示で再配布可 | 303 | 2,287 件 4 基 | 2026/06/28 21:10 JST |
| qsr-turuta-dam | 国土交通省 九州地方整備局 鶴田ダム管理所 — 鶴田ダム (川内川水系, Kagoshima) | — | — | 303 | 554 件 1 基 | 2026/06/28 20:10 JST |
| qsr-toukan-dam | 国土交通省 九州地方整備局 筑後川ダム統合管理事務所 — 2 dams: 松原/下筌 (筑後川水系, Oita) | — | — | 303 | 1,102 件 2 基 | 2026/06/28 20:00 JST |
| okinawa-eb | 沖縄県企業局 — 倉敷・山城ダム日次 (貯水量+貯水率) | — | — | 302 | 40 件 2 基 | 2026/06/28 0:00 JST |
| hrr-mlit-dam 国土交通省 北陸地方整備局 ダム防災情報 (hrr.mlit.go.jp/river/dam-bousai) | 北陸地方整備局直轄 7 ダム (福島:大川 / 山形:横川 / 新潟:大石・三国川 / 長野:大町 / 富山:宇奈月 / 石川:手取川) の貯水位・流入量・放流量。 | 時次 (元データは 10 分粒度; 取得は毎時 :19) | 国の公式統計値 — 出典明示で再配布可 | 302 | 1,092 件 7 基 | 2026/06/28 21:00 JST |
| kkr-mlit-dam | 国土交通省 近畿地方整備局 — 12 国管理ダム 貯水率 (JSON, 日次, 土日祝除く) | — | — | 302 | 156 件 12 基 | 2026/06/27 6:00 JST |
| jwa-chiba-bouso | 水資源機構 千葉用水総合管理所 — 長柄・東金ダム日次 (EL水位+貯水率) | — | — | 302 | 16 件 2 基 | 2026/06/26 0:00 JST |
| tokyo-waterworks 東京都水道局 水源情報 (waterworks.metro.tokyo.lg.jp/suigen/suigen.html) | 東京都の水源 15 ダム (利根川・荒川・多摩川 水系) の貯水量 (万m³) と貯水率 (%)。前日からの増減量。 | 日次 (毎日 12:00 / 18:00 JST に取得) | 東京都オープンデータ (出典明示で再配布可) | 300 | 450 件 15 基 | 2026/06/28 0:00 JST |
| jwa-toyokawa 水資源機構 中部支社 豊川水系 (water.go.jp/mizu/chubu/realtime/index_2.html) | 豊川水系 2 ダム (宇連/大島) の貯水位(EL.m)・有効貯水量(m³)・流入量・放流量。リアルタイム観測; jwa-junpo (10 日) / aitoyo (日次) より高頻度。 | 時次 (元データは ~10 分粒度; 取得は毎時 :43) | 公的統計 — 出典明示で再配布可 | 298 | 1,204 件 2 基 | 2026/06/28 20:30 JST |
| shimokubo | 水資源機構 利根川上流総合管理所 下久保ダム 実時計 (10分間隔) | — | — | 297 | 560 件 1 基 | 2026/06/28 20:40 JST |
| jwa-chikugo 水資源機構 筑後川ダム統合管理事務所 (water.go.jp/chikugo/chikugo/water-source.html) | 筑後川水系 7 ダム (松原/下筌/大山/合所/江川/寺内/小石原川) の貯水率・貯水量。 | 日次 (毎日 0:00 JST 値; 取得は 10:00 JST) | 公的統計 — 出典明示で再配布可 | 297 | 210 件 7 基 | 2026/06/28 0:00 JST |
| jwa-kiso-rt 水資源機構 中部支社 木曽川水系 実時計 (water.go.jp/mizu/chubu/realtime/index.html) | 木曽川水系 6 dams (牧尾/味噌川/阿木川/岩屋/徳山/中里貯水池) の貯水位(EL.m)・有効貯水量(千m³→m³)・流入量・放流量。jwa-chubu (日次, 優先度 296) を時次に格上げ。 | 時次 (元データは ~10 分粒度; 取得は毎時 :47) | 公的統計 — 出典明示で再配布可 | 297 | 3,337 件 6 基 | 2026/06/28 20:40 JST |
| jwa-yoshino 水資源機構 吉野川上流総合管理所 (water.go.jp/mizu/ikeda/mizuinfo/dyn/html/p0001/60/p000101.html) | 吉野川水系 5 ダム (池田/早明浦/新宮/富郷/柳瀬) の貯水位(EL.m)・流入量・全放流量。早明浦ダムのみ利水貯水率[速報値]も提供 (四国の水不足予測の主要指標)。jwa-junpo (10 日) より高頻度で水位も追加。 | 時次 (元データは 5 分粒度で自動更新; 取得は毎時 :45) | 公的統計 — 出典明示で再配布可 | 297 | 2,815 件 5 基 | 2026/06/28 20:00 JST |
| jwa-toneara 水資源機構 関東支社 (water.go.jp/honsya/honsya/suigen/sokuhou/toneara/index.html) | 利根川水系 9 施設 (矢木沢/奈良俣/藤原/相俣/薗原/八ッ場/下久保/草木/渡良瀬貯水池) と荒川水系 4 施設 (二瀬/滝沢/浦山/荒川貯水池) の貯水量(万m³)・貯水率。藤原/相俣/薗原/八ッ場/二瀬は新規カバレッジ。 | 日次 (毎日 0:00 JST 値; 取得は毎時 :39) | 公的統計 — 出典明示で再配布可 | 296 | 221 件 13 基 | 2026/06/26 0:00 JST |
| jwa-chubu 水資源機構 中部支社 (water.go.jp/mizu/chubu/report/) | 木曽川水系 6 ダム (牧尾/阿木川/味噌川/岩屋/中里/徳山) の貯水量(千m³)・貯水率・流入量・放流量。中里ダムは新規カバレッジ; 他 5 ダムは jwa-junpo より日次で詳細なデータを提供。 | 日次 (取得は毎時 :41) | 公的統計 — 出典明示で再配布可 | 296 | 96 件 6 基 | 2026/06/26 0:00 JST |
| aitoyo あいとよネット 公益財団法人 愛知・豊川用水振興協会 (aitoyo.or.jp) | 木曽川 4 ダム (牧尾/阿木川/味噌川/岩屋), 豊川 1 ダム (宇連), 矢作川 2 ダム (矢作/羽布) の 利水容量・貯水量・貯水率・前日差・平年貯水率。 | 日次 (木曽川/豊川は 24:00 JST 値, 矢作川は 09:00 JST 値; 取得は 11:00 JST) | 公益財団法人発行 — 出典明示で再配布可 | 295 | 112 件 7 基 | 2026/06/25 0:00 JST |
| chiba-suisei 千葉県 水政課 県内ダムの貯水状況 (pref.chiba.lg.jp/suisei/chosui) | 千葉県内 23 ダム (水道用 20 + 工業用水 3) の貯水容量・貯水量(m³)・貯水率(%)。 | 日次 (毎日 9:00 JST 値; 取得は 11:30 JST) | 千葉県オープンデータ — 出典明示で再配布可 (推定) | 290 | 44 件 22 基 | 2026/06/15 9:00 JST |
| jwa-junpo 水資源機構 旬報 (water.go.jp/honsya/honsya/suigen/junpo/index.html) | 水資源機構が管理する全国 26 ダムの利水容量・貯水量 (千m³)・貯水率 (現在 / 平年 / 平年比)。 | 10 日毎 (毎月 1 / 11 / 21 日 JST 公表; 取得は日次でポーリング) | 統計法に基づく公的統計 (出典明示で再配布可) | 290 | 78 件 26 基 | 2026/06/21 0:00 JST |
| mudam NILIM ダム諸量データベース (mudam.nilim.go.jp) | 全国 600 ダム × 日次 貯水位・流入量・放流量 (貯水量直接なし)。チャートの歴史的深さ補完用。 | 日次 (1-2 年遅れの確定値; 1998-最新まで) | 国の公式統計値 — 出典明示で再配布可 (robots.txt allows) | 280 | — | — |
| yamanashi-dam | 山梨県雨量・水位情報 時間ダム諸量表 — 6 県管理ダム (Shift_JIS HTML) | — | — | 280 | 3,303 件 6 基 | 2026/06/28 20:00 JST |
| synthetic 当サイトの内部生成 (シード値) | 上流フィードが未接続のダム向けにグラフ表示用の補完値を生成。実観測値ではない旨を UI で明示。 | 不変 (一括投入後の更新なし) | CC0 (出典明示は任意) | 200 | — | — |
| ndi 国土交通省 国土数値情報 (W01: 河川, W07: ダム, A21: 流域) | マスタデータの土台。位置 (緯度経度), 都道府県, 河川, 流域, 総貯水容量, 堤高, 竣工年。 | 年次 (毎年初旬に最新版へ差し替え) | 出典明示で再配布可 (政府標準利用規約 2.0 互換) | 80 | — | — |
| damnet 一般財団法人日本ダム協会「ダム便覧」 (dambinran.damnet.or.jp) | 利水容量・有効貯水容量, 目的, 型式, 堤頂長, 流域面積, 湛水面積, 着工年, 事業者, 施工者, ダム湖名, 写真。 | 月 1 回 (master:refresh:damnet cron / 毎月 5 日 03:00 UTC) | 個別データの引用・改変は出典明示で可。一括 DL は要相談。 | 50 | — | — |
wikipedia ja.wikipedia.org REST API (pageimages prop) | Damnet に写真がない場合のフォールバック。記事サムネイル URL のみ。 | 月 1 回 (images:refresh:wikipedia cron / 毎月 2 日 05:00 UTC) | CC-BY-SA 4.0 (各ページの著作者に従う) | — | — | 未取得 |
gsi 国土地理院 標高 API (cyberjapandata.gsi.go.jp/general/dem) | 地点標高 (DEM10B / 5A 統合)。緯度経度から数 m 精度で取得。 | 月 1 回 (master:refresh:elevation cron) | 出典明示で利用可 | — | — | 未取得 |
2. ダム名寄せ (Damnet ↔ 国土数値情報)
土台は国土数値情報 (NDI) の 2,754 行のダムマスタ。これに対しダム便覧 (Damnet) の 2,600 件をぶつけて属性を埋めています。両者を結合する一意 ID は無いため、 以下の手順でマッチさせています。
- 名前の正規化:
NFKC → 「（再）/（元）/（新）」剥離 → 「ダム/貯水池/池」接尾辞剥離 → 小文字化。再開発前/後で別行になっている NDI 側のダム (175 件 該当) を 1 つにまとめるための処理です。 - キー生成:
prefCode | normalizeName(name)。都道府県を必ず一致させることで、同名異所のダム (例: 同じ「中央ダム」が複数県に存在) の誤接続を防止。 - 多対 1 マッチ: NDI 側に同キーが複数行ある場合 (再/元 のペアなど) は、 Damnet ID は最初の 1 行にだけ付与し、属性 (利水容量・諸元) はグループ全行に backfill します (Damnet の unique 制約に違反しないため)。
- 属性の上書きルール:
COALESCE(damnet, 既存)。NDI が既に値を持つカラムは上書きせず、空欄だけ Damnet で埋めます。 数値ソースの差分を抑えるためで、両ソースが矛盾するときは NDI が優先。 - slug 修復: 仮 slug (
dam-NNN-PP) のダムは Damnet から得た 読み仮名を slug 化して置き換えます (例:dam-716-14→doushi-14)。
実装:
apps/web/bin/match_damnet.ts / 検収レビュー待ちの曖昧マッチは match_review テーブルに堆積。具体例
実際のデータで遭遇したパターンと、それぞれを正規化ロジックがどう同じキーに落とし込んでいるかの例。
シンプルな接尾辞剥離
NDI 側
道志ダムDamnet 側
道志ダム正規化キー
どうし「ダム」を剥がして prefCode=14 (神奈川) と組み合わせて一致 (Damnet ID 0699)。利水容量 616 千 m³ がそのまま流入。
再開発バリアント (元/再 を統合)
NDI 側
佐久間（元）／佐久間（再）Damnet 側
佐久間ダム正規化キー
さくまNDI が再開発前後を別行で持つが Damnet は 1 件。両方に同じ利水容量 (221.6 百万 m³) を backfill。Damnet ID は片方だけに付与。
新しく作り直した dam
NDI 側
新桂沢（再）Damnet 側
新桂沢ダム正規化キー
しんかつらざわ「（再）」を剥離。新桂沢は元の桂沢ダムを嵩上げした再開発で、Damnet 上は別エントリ。
NFKC 正規化 (全半角ゆれ)
NDI 側
夕張シューパロ（再）Damnet 側
夕張シューパロダム正規化キー
ゆうばりしゅうぱろ全角カタカナはそのまま、（再）剥離 + ダム剥離。pref=01 (北海道) で 1 件にマッチ。
貯水池 / 池 の表記ゆれ
NDI 側
御大典池Damnet 側
御大典池正規化キー
みのりがい「池」「貯水池」もダムと同じ扱いで剥離。読み仮名「みのりがい」で slug を再生成。
同名異所
NDI 側
中央ダム (北海道) / 中央ダム (福島県)Damnet 側
中央ダム × 2 件正規化キー
ちゅうおう名前のみだと衝突するが prefCode を必ずキーに含めるので誤接続しない (01 と 07 で別キー)。
名前一致せず（マッチ失敗）
NDI 側
表沢堤Damnet 側
(該当なし)正規化キー
おもてざわ-?「堤」は接尾辞剥離対象外で、Damnet にも当該名なし。skippedNotFound として 利水容量 NULL のまま残る。
Damnet ID 衝突 (片方だけ採用)
NDI 側
鶴田（元） / 鶴田（再）Damnet 側
鶴田ダム正規化キー
つるたどちらも同じ Damnet 行を参照。external_ids.damnet=0XXX は最初の 1 行にだけ付与され、もう一方は skippedConflict としてスキップ (ただし利水容量等の属性は両方に適用)。
3. データ構造 (ER 図)
中心は dams (マスタ) と observations (時系列)。 外部の生データ (raw_snapshots) は監査用に S3 へ保管し、解析後の値だけを observations に書き戻す Lakehouse 風の構成です。
線種: 実線 = FK 結合 / 点線 = ソフトリンク (jsonb 経由)。観測テーブルは TimescaleDB の hypertable で時間方向に自動分割。
4. ダムマスタの主なカラム
dams テーブルは 2,754 行。出処を併記しています。
| カラム | 意味 | 主な出処 | 充足率 |
|---|---|---|---|
slug | URL 断片 (例: doushi-14)。読み仮名+都道府県コードから生成。 | 自動生成 | 100 % |
name | 日本語ダム名 | NDI | 100 % |
name_kana | 読み仮名 (ひらがな) | Damnet | 88.0 % |
pref_code | JIS 都道府県コード (01〜47) | NDI | 100 % |
location | 緯度経度 (PostGIS geography Point, EPSG:4326) | NDI | 100 % |
elevation_m | 標高 (メートル)。緯度経度を国土地理院 DEM API に問い合わせ。 | 国土地理院 | 100 % |
watershed_id | 一級 / 二級水系 ID (FK to watersheds) | NDI A21 + 空間結合 | 100 % |
manager | 管理者 (例: 国土交通省, 神奈川県企業庁) | NDI / Damnet | 79 % |
type | 型式 (重力式コンクリート, アースフィル, ロックフィル …) | Damnet | — |
height_m | 堤高 (m) | NDI / Damnet | 100.0 % |
total_capacity_m3 | 総貯水容量 | NDI | 100 % |
active_capacity_m3 | 利水容量 = 貯水率の分母として採用 | Damnet | 86.9 % |
effective_capacity_m3 | 有効貯水容量 = 総貯水量 − 堆砂容量 | Damnet (active と同値で mirror) | 86.9 % |
completed_year | 竣工年 | NDI / Damnet | 91.9 % |
purposes | 目的コード (F=洪水調節, N=不特定, A=灌漑, W=上水, I=工業, P=発電, S=消流雪) | Damnet | 88.0 % |
watershed_area_km2 | 流域面積 | Damnet | 88.0 % |
image_url | ダム写真 (Damnet 優先, Wikipedia フォールバック) | Damnet / Wikipedia | 44.7 % |
external_ids | ソース別の外部 ID (jsonb) | - | damnet 87.0 % |
5. 欠損データの分布
利水容量を例に、容量帯ごとの欠落率を示します。大規模ダムほどカバレッジが高く、 10万 m³ 未満の小規模ダム (農業用ため池, 砂防ダム等) で Damnet 未収録が顕著です。
| 容量帯 | ダム数 | 欠落 (利水容量) | 欠落率 |
|---|---|---|---|
| 10億 m³ 以上 | 2 | 0 | 0.0 % |
| 1〜10億 m³ | 54 | 1 | 1.9 % |
| 1000万〜1億 m³ | 412 | 8 | 1.9 % |
| 100〜1000万 m³ | 845 | 18 | 2.1 % |
| 10〜100万 m³ | 942 | 84 | 8.9 % |
| 10万 m³ 未満 | 494 | 244 | 49.4 % |
| 不明 | 5 | 5 | 100.0 % |
欠落の主因: ① Damnet 未収録 (主に 10 万 m³ 未満の小規模ダム), ② 名寄せできなかった同名・別字ゆれ (match_review に堆積)。再開発バリアント (（再）/（元）) は 名寄せ時に統合済み。
6. 観測値の粒度
観測対象ダム数
959
観測総数
2,137,285
直近 24h
33,520
期間
2020-01-01 JST 〜 2026-06-28 JST
- 原始粒度: 1 時間。過去データの定期バッチ取込時にこの粒度で保存します (リアルタイム監視ではありません)。
- カラム:
storage_volume_m3, storage_rate, inflow_m3s, outflow_m3s, water_level_m, quality_flag。欠落カラムは NULL (誤値の補間や想定値補完はしない)。 - 集計: TimescaleDB の continuous aggregate で日次 (
obs_daily) と月次 (obs_monthly) を自動更新。グラフ・統計はこの集計を読みます。 - retention: 原始データは無期限保持 (容量効率は Timescale の 列圧縮)。S3 上の生スナップショット (raw_snapshots) も無期限。
- 品質フラグ:
quality_flagで「正常 / 推定 / 観測停止 / 異常値」を区別。利用者はquality_flag = 'ok'のみで分析するのが安全。 - 提供範囲: 本サービスは 履歴データに特化 しており、現在時刻の値 (リアルタイム) は再配信していません。最新値が必要な場合は 川の防災情報 などの一次情報源を併用してください。