REST API仕様(津波速報(情報拡張版))


津波速報について

  • 津波速報は、気象庁から発表される津波警報・注意報・予報のことで、地震発生時に地震の規模や位置を推定し、沿岸で予想される津波の高さを求め、地震発生から約3分を目標に発表されるものです。

注意事項

  • 本サービスは、津波の発生を予知するものではありません。
  • 本サービスは、気象庁が発表する『津波警報・注意報・予報』に含まれる予報資料(津波予報区、津波の高さ予測値、津波の到達予想日時など)を津波速報として登録および閲覧をするものです。
  • 『津波警報・注意報・予報』に含まれる、地震情報は本サービスでは取り扱いません。
    • 地震情報を利用される場合は、地震情報:震源・震度情報(jmaearthquake_result)をご利用ください。
  • 津波速報のデータには、「通常」「訓練」「試験」のモードが存在しており、データを利用する際にはこれらのモードに対して適切な処理を行ってください。
    • 例えば「訓練」「試験」モードのデータは利用しない、利用する場合は明らかに 訓練試験 であることが分かるようにするなど、利用者の混乱を避けてください。
    • 「訓練」「試験」モードのデータを、「通常」データであるかのような処理は 行わない でください。
    • モードの誤用によるトラブルについては、弊社は一切の責任を負わないものとします。

津波速報(情報拡張版)のデータについて

  • 本サービスは、津波速報(tsunami)には含まれていなかった情報を追加したものとなります。
    • 大きな変更点として、地震識別番号が追加された点、および気象庁発表の取消電文に対応した点があります。
    • 詳しくは、後述のデータ仕様をご参照ください。
  • 気象庁発表の津波警報・注意報・予報を元に、津波予報区ごとに予測される津波の高さの情報などをREST API経由で登録/検索します。
    • 津波警報・注意報・予報のXML電文仕様は、 気象庁防災情報XMLフォーマット | 技術資料 の電文毎の解説資料:解説資料セット[zip形式]に含まれる、『地震火山関連_解説資料.pdf』の「津波警報・注意報・予報」に記載されています。
    • XML電文は、上記サイト内のサンプルデータで確認できます。
  • 本サービスでは、気象庁定義の津波予報区ごとに津波予測情報を保持します。
    • 1つの津波予報区毎に、運用種別:「通常」「訓練」「試験」の3レコードを最大で保持します。
    • 発令されたことのない情報はレコードとして存在しません。(ある津波予報区に津波速報が発令されたことがない場合など)

REST API 津波速報(情報拡張版)のデータ仕様

  • 津波速報(情報拡張版)をREST APIから取得する際、APIパラメータのqueryセクションのdatatypenameには、"jmatsunami_flash"を設定します。
  • REST APIで取得できるデータはバージョンにより異なります。