REST API仕様(津波速報(情報拡張版))
- 津波速報は、気象庁から発表される津波警報・注意報・予報のことで、地震発生時に地震の規模や位置を推定し、沿岸で予想される津波の高さを求め、地震発生から約3分を目標に発表されるものです。
- 本サービスは、津波の発生を予知するものではありません。
- 本サービスは、気象庁が発表する『津波警報・注意報・予報』に含まれる予報資料(津波予報区、津波の高さ予測値、津波の到達予想日時など)を津波速報として登録および閲覧をするものです。
- 『津波警報・注意報・予報』に含まれる、地震情報は本サービスでは取り扱いません。
- 地震情報を利用される場合は、地震情報:震源・震度情報(jmaearthquake_result)をご利用ください。
- 津波速報のデータには、「通常」「訓練」「試験」のモードが存在しており、データを利用する際にはこれらのモードに対して適切な処理を行ってください。
- 例えば「訓練」「試験」モードのデータは利用しない、利用する場合は明らかに 訓練 や 試験 であることが分かるようにするなど、利用者の混乱を避けてください。
- 「訓練」「試験」モードのデータを、「通常」データであるかのような処理は 行わない でください。
- モードの誤用によるトラブルについては、弊社は一切の責任を負わないものとします。
- 本サービスは、津波速報(tsunami)には含まれていなかった情報を追加したものとなります。
- 大きな変更点として、地震識別番号が追加された点、および気象庁発表の取消電文に対応した点があります。
- 詳しくは、後述のデータ仕様をご参照ください。
- 気象庁発表の津波警報・注意報・予報を元に、津波予報区ごとに予測される津波の高さの情報などをREST API経由で登録/検索します。
- 津波警報・注意報・予報のXML電文仕様は、 気象庁防災情報XMLフォーマット | 技術資料 の電文毎の解説資料:解説資料セット[zip形式]に含まれる、『地震火山関連_解説資料.pdf』の「津波警報・注意報・予報」に記載されています。
- XML電文は、上記サイト内のサンプルデータで確認できます。
- 本サービスでは、気象庁定義の津波予報区ごとに津波予測情報を保持します。
- 1つの津波予報区毎に、運用種別:「通常」「訓練」「試験」の3レコードを最大で保持します。
- 発令されたことのない情報はレコードとして存在しません。(ある津波予報区に津波速報が発令されたことがない場合など)
- 津波速報(情報拡張版)をREST APIから取得する際、APIパラメータのqueryセクションのdatatypenameには、"jmatsunami_flash"を設定します。
- REST APIで取得できるデータはバージョンにより異なります。