REST API仕様(指定河川洪水予報)


指定河川洪水予報について

  • 指定河川洪水予報は、河川の増水や氾濫などに対する水防活動の判断や住民の避難行動の参考となるように、気象庁は国土交通省または都道府県の機関と共同して、あらかじめ指定した河川について、区間を決めて水位または流量を示した洪水の予報を行っています。
  • 気象庁では、対象となる河川の水位や氾濫の状況によって氾濫注意情報、氾濫警戒情報、氾濫危険情報、氾濫発生情報の4つの情報を発表しています。

注意事項

  • 本仕様は検討段階のものであるため、仕様が変更される可能性があります。
  • 本サービスは、河川洪水の発生を予知するものではありません。
  • 本サービスは、気象庁が発表する指定河川洪水予報に含まれる情報(予報区域、対象市町村など)を用いて、氾濫注意情報、氾濫警戒情報、氾濫危険情報、氾濫発生情報を通知するものです。
  • 指定河川洪水予報についての詳細は、 気象庁のwebサイト でご確認ください。
  • 指定河川洪水予報のデータには、「通常」「訓練」「試験」のモードが存在しており、データを利用する際にはこれらのモードに対して適切な処理を行ってください。
    • 例えば「訓練」「試験」モードのデータは利用しない、利用する場合は明らかに 訓練 や 試験 であることが分かるようにするなど、利用者の混乱を避けてください。
    • 「訓練」「試験」モードのデータを、「通常」データであるかのような処理は 行わない でください。
    • モードの誤用によるトラブルについては、弊社は一切の責任を負わないものとします。

指定河川洪水予報のデータについて

  • 気象庁発表の指定河川洪水予報を元に、予報区域の市町村ごとに予報の発令状態などをREST API経由で登録/検索します。
    • 指定河川洪水予報のXML電文仕様は、 気象庁防災情報XMLフォーマット | 技術資料 の電文毎の解説資料:解説資料セット[zip形式]に含まれる、『指定河川洪水予報_解説資料.pdf』に記載されています。
    • XML電文は、上記サイト内のサンプルデータで確認できます。
  • 本サービスでは、気象庁定義の市町村コード・運用種別・予報区域ごとに洪水予報を保持します。
    • 1つの予報区域の市町村につき、運用種別:「通常」「訓練」「試験」の3レコードを最大で保持します。
    • 発令されたことのない情報はレコードとして存在しません。(ある市町村で指定河川洪水予報が発令されたことがない場合)

REST API 指定河川洪水予報データ仕様

  • 指定河川洪水予報をREST APIから取得する際、APIパラメータのqueryセクションのdatatypenameには、"jmaflood"を設定します。
  • REST APIで取得できるデータはバージョンにより異なります。