REST API仕様(気象特別警報・警報・注意報)
- 気象特別警報・警報・注意報は、気象庁が、大雨や強風などによって災害が起こるおそれのあるときに注意や警戒を呼びかけるために発表される情報のことで、災害が起こるおそれがある場合に「注意報」、重大な災害が起こるおそれがある場合に「警報」、さらに重大な災害が起こるおそれが著しく大きい場合に「特別警報」を発表します。
- 気象庁では、対象となる現象や災害の内容によって6種類の特別警報、7種類の警報、16種類の注意報を発表しています。
- 本サービスは、気象災害の発生を予知するものではありません。
- 本サービスは、気象庁が発表する気象特別警報・警報・注意報に含まれる情報(報種別名称、発表形態、対象市町村など)を用いて、大雨、洪水、高潮など気象等に関する警報・注意報情報の登録および閲覧をするものです。
- 気象特別警報・警報・注意報についての詳細は、 気象庁のwebサイト でご確認ください。
- 気象特別警報・警報・注意報のデータには、「通常」「訓練」「試験」のモードが存在しており、データを利用する際にはこれらのモードに対して適切な処理を行ってください。
- 例えば「訓練」「試験」モードのデータは利用しない、利用する場合は明らかに 訓練 や 試験 であることが分かるようにするなど、利用者の混乱を避けてください。
- 「訓練」「試験」モードのデータを、「通常」データであるかのような処理は 行わない でください。
- モードの誤用によるトラブルについては、弊社は一切の責任を負わないものとします。
- 気象庁発表の気象特別警報・警報・注意報を元に、市町村区の気象カテゴリーごとに警報の発令状態などをREST API経由で登録/検索します。
- 気象特別警報・警報・注意報のXML電文仕様は、気象庁防災情報XMLフォーマット | 技術資料 の電文毎の解説資料:解説資料セット[zip形式]に含まれる、『気象特別警報・警報・注意報_解説資料.pdf』に記載されています。
- XML電文は、上記サイト内のサンプルデータで確認できます。
- 本サービスでは、気象庁定義の市町村コード・運用種別、また独自定義の気象カテゴリーコードごとに気象情報を保持します。
- 1つの市町村につき、気象カテゴリーコード毎に最大17レコード。またそれぞれの気象カテゴリーコード毎に、運用種別:「通常」「訓練」「試験」の3レコードを最大で保持します。
- 発令されたことのない情報はレコードとして存在しません。(ある市町村で着氷注意報が発令されたことがない場合など)
- 気象特別警報・警報・注意報をREST APIから取得する際、APIパラメータのqueryセクションのdatatypenameには、"jmaweather"を設定します。
- REST APIで取得できるデータはバージョンにより異なります。