ダム便覧のデータを使ってダムオタクになってみた #API

この記事は国交DPFアドベントカレンダー2023に参加しています。本日は24日目です。
残すところあと2日(´;ω;｀)

さて、、、

みなさんはサンタさんになにをお願いしましたか？？

私はダムカードをお願いしました。ダムカードって知ってますか？？

ダムカードってなに？

国交省が管理するダムではそれぞれのダムごとに「ダムカード」というトレカみたいなカードを作成して、ダムを訪問した人に対してダムカードを配布しているんです！
そして、全国各地のダムを訪れてダムカードを収集するのが流行っているらしいです。
ダムカードにはダムの形式や貯水容量、建設時に使われた技術などのちょっとマニアックな情報も載っているそうです。

著作権の関係上、実際の写真は載せられないのでどんなものか気になる人はこちら！

ダムの形式って？

先ほど、ダムカードにはダムの形式についての情報が載っていると書きました。
そうなんです。ダムは13個もの違う形式があるんです！
それがこちら。

ダム名称	略字	説明
アーチダム	A	アーチの形状をしたダム。アーチの形状によって、水の圧力を分散させて支えている。そのため水圧が大きい場所や、地盤が軟弱な場所に建設。
バットレスダム	Ｂ	アーチダムの一種。アーチの両端にバットレスと呼ばれる支柱を設置したダム。バットレスによって、アーチの構造を補強し、耐久性を高めることができる。
台形ＣＳＧダム	ＣＳＧ	コンクリートブロックを積み上げて作られたダム。コンクリートブロックを組み立てるだけでダムを建設できるため、工期が短く、コストを抑えることが可能。
アースダム	E	土や砂などの材料を盛って作られたダム。材料の重さや密度を利用して、水の重さを支える。主に洪水調節や灌漑などの目的で建設。
重力式コンクリートダム	Ｇ	最も一般的なコンクリートダムの形式。コンクリートの重さで水の重さを支え、水力発電、洪水調節、灌漑などの目的で建設。
重力式アーチダム	ＧＡ	アーチ式コンクリートダムと重力式コンクリートダムの両方の特徴を持つダム。アーチの形状によって水圧を分散させ、コンクリートの重さによって水圧を支える。
重力式コンクリート・フィル複合ダム	ＧＦ	重力式コンクリートダムとフィルダムの両方の構造を持つダム。重力式コンクリートダムで水圧を支え、フィルダムで貯水池の底面を補強。
中空重力式コンクリートダム	ＨＧ	重力式コンクリートダムの中を空洞にしたダム。コンクリートの量を減らすことで、コストを抑えることが可能。
マルティプルアーチダム	ＭＡ	複数のアーチを組み合わせて作られたダム。アーチの形状によって水圧を分散させ、耐久性を高めることが可能。
ロックフィルダム	R	岩や砂利などの材料を積み上げて作られたダム。材料の重さや密度を利用して、水の重さを支えている。主に洪水調節や灌漑などの目的で建設。
堰	ＦＧ	川の流れをせき止めたり、水位を調節したりするための構造物。ダムと比べると比較的小規模なものが多く、農業用水の取水や、河川の流量調節などに利用。
アスファルトフェイシングフィルダム	ＦＡ	フィルダムの表面にアスファルトを舗装したダム。アスファルトによって、水の浸透を防ぎ、貯水池の底面を保護することが可能。
アスファルトコアフィルダム	ＦＣ	フィルダムの中央部にアスファルトを充填したダム。アスファルトによって、フィルダムの強度を高め、耐久性を向上させることが可能。

なんかたくさんありますよね、２列目の「略字」は国交DPFに掲載されている「ダム便覧」上でダムの形式を識別するためのものです。
さて、ダムカードにもこれらの形式が記載されるのですが、

折角ならいろんな形式のダムカードを集めたくないですか？？

と、いうことで本日はダム便覧のデータをGIS上に可視化し、どこに・どの形式のダムがあるかを調べてみました！

下準備

先ほど少しフライングしてしまったのですが、国交DPFには日本全国のダムのデータが掲載されています。それがこちらダム便覧!

まずはこちらのデータを国交DPFの利用者向けAPIを使用して取得してみます。

これまでの記事でAPIについて説明してきたので細かい順序は省きます。。
まずはダム便覧のデータIDを調べます。

query {
  dataCatalog(IDs: null) {
    id
    title
  }
}

すると、国交DPFの掲載データのデータセットっとIDの一覧が表示され、ダムのデータIDは

 {
        "id": "dhb",
        "title": "ダム便覧"
      }

とわかります。
では、ダム便覧のすべてのデータ属性一覧を取得しましょう。

query {
 search(
   term: "",
   phraseMatch: true,
   first: 0,
   size: 3000,
   attributeFilter: {
     AND:[
       {
         attributeName: "DPF:dataset_id",
         is: "dhb"
       }
     ]
   }
 ) {
   totalNumber
   searchResults {
     title
     lat
     lon
     metadata
   }
 }
}

jsonファイルの出力がちょっとうまくいかなかったので今回は出力結果をコピペしてjsonファイルを作っちゃいます。時には力技もだいじ。（小声）

次に出力したjsonファイルをcsvに変換します。これはがんばってプログラムかいてみた。

import json
import csv

# JSONファイル読み取り
json_file_path = 'ダム.json'  
with open(json_file_path, 'r', encoding='utf-8') as json_file:
   data = json.load(json_file)

# CSVファイル書き込み
csv_file_path = 'output.csv' 
with open(csv_file_path, 'w', newline='', encoding='utf-8') as csv_file:
   csv_writer = csv.writer(csv_file)

   # ヘッダー書き込み
   headers = data['data']['search']['searchResults'][0]['metadata'].keys()
   csv_writer.writerow(headers)

   # 各行を書き込み
   for result in data['data']['search']['searchResults']:
       row = [result['metadata'].get(key, "") for key in headers]
       csv_writer.writerow(row)

出力したのがこんな感じ。