津波速報通知メッセージ(バージョン1)

パラメータ一覧表

セクション パラメータ タイプ 設定値 意味 ユニーク 備考
details   Array(要素はHash) 以下のパラメータを設定 メッセージの詳細情報設定セクション   津波速報情報が設定されます。
  id Number アプリ定義値 履歴データユニークID   詳細は こちらのページ を参照ください。
  createid Number アプリ定義値 最新データユニークID   詳細は こちらのページ を参照ください。
  datatypename String アプリ定義値 データタイプ名   詳細は こちらのページ を参照ください。
  dataversion Number アプリ定義値 データバージョン   詳細は こちらのページ を参照ください。
  create_date String ISO8601形式(例:YYYY-MM-DDTHH:MM:SS.mmmmm+HH:MM) データ登録日時   詳細は こちらのページ を参照ください。
  update_date String ISO8601形式(例:YYYY-MM-DDTHH:MM:SS.mmmmm+HH:MM) データ最終更新日時   詳細は こちらのページ を参照ください。
  expire_date String
空文字または
ISO8601形式(例:YYYY-MM-DDTHH:MM:SS.mmmmm+HH:MM)
データ保持期限日時   詳細は こちらのページ を参照ください。
areacode String XML電文記載値 津波予報区コード 複合キー
コード定義は パラメータ詳細 を参照
「controlstatus」との組み合わせで一意なレコードとなる。
areaname String XML電文記載値 津波予報区名   名称定義は パラメータ詳細 を参照
controlstatus String "通常"、"訓練"、"試験" 津波運用種別 複合キー 「areacode」との組み合わせで一意なレコードとなる。
wavetypecode String 気象庁定義値 津波警報種別コード    
wavetypename String 気象庁定義値 津波警報種別名    
lastwavetypecode String 気象庁定義値 津波警報種別コード(前回)    
lastwavetypename String 気象庁定義値 津波警報種別名(前回)    
pressdt String
XML電文記載値
ISO8601形式(例:YYYY-MM-DDTHH:MM:SS+HH:MM)
気象庁発表時刻    
headline String XML電文記載値 ヘッドライン    
warningcomment String XML電文記載値 固有付加文    
freeformcomment String XML電文記載値 自由付加文    
height String 気象庁定義値 予測される津波の高さ   単位も含む
at String
XML電文記載値
ISO8601形式(例:YYYY-MM-DDTHH:MM:SS+HH:MM)
津波の到達予測時刻    
vt String
XML電文記載値
ISO8601形式(例:YYYY-MM-DDTHH:MM:SS+HH:MM)
津波予報の失効時刻
(警報種別が津波予報以外は空文字)
   
arrived String 気象庁定義値 津波の到達区分    
termmsg String ""(空文字固定) 端末表示文言    

パラメータ詳細

説明 津波予報区コードを設定。
情報定義元 気象庁XML電文(津波警報・注意報・予報)内:<Report><Body><Tsunami><Forecast><Item><Area><Code>タグ
設定値 情報定義元の値をそのまま設定。
備考
上記サイトのコード管理表及び個別コード表の『個別コード表[zip形式]』の内、「地震火山関連コード表.xls」の津波予報区コード表シート(31)の定義を参照。
本パラメータに設定されるのは、「津波予報区について」で定義されているコードで、コード表に含まれる予報区の結合表現・領域のコード(十の位が8または9)は対象外です。
説明 津波予報区名を設定。
情報定義元 気象庁XML電文(津波警報・注意報・予報)内:<Report><Body><Tsunami><Forecast><Item><Area><Name>タグ
設定値 情報定義元の値をそのまま設定。
備考
上記サイトのコード管理表及び個別コード表の『個別コード表[zip形式]』の内、「地震火山関連コード表.xls」の津波予報区コード表シート(31)の定義を参照。
説明 発表された津波情報の運用種別を設定。
情報定義元 気象庁XML電文(津波警報・注意報・予報)内:<Report><Control><Status>タグ
設定値
情報定義元の値をそのまま設定。
情報定義元は、「通常」、「訓練」、「試験」のいずれかが設定。
備考
通常報について
- 気象庁が津波を予測し発表を行う津波警報・注意報・予報が元の情報の場合、controlstatusを「通常」で設定します。
訓練報について
- 気象庁が不定期で訓練報を通知することがあり、この場合controlstatusを「訓練」で設定します。
- 訓練報の扱いは、利用者毎の定義となります。
試験報について
- 気象庁が不定期で試験報を通知することがあり、この場合controlstatusを「試験」で設定します。
- 試験報の扱いは、利用者毎の定義となります。
説明 津波予報区に対する津波注意報・警報などの名称コードを設定。
情報定義元 気象庁XML電文(津波警報・注意報・予報)内:<Report><Body><Tsunami><Forecast><Item><Category><Kind><Code>タグ
設定値 情報定義元の値をそのまま設定。
備考  
説明 津波予報区に対する津波注意報・警報などの名称を設定。
情報定義元 気象庁XML電文(津波警報・注意報・予報)内:<Report><Body><Tsunami><Forecast><Item><Category><Kind><Name>タグ
設定値 情報定義元の値をそのまま設定。
備考  
説明 津波予報区に対して前回発表されていた津波注意報・警報などの名称コードを設定。
情報定義元 気象庁XML電文(津波警報・注意報・予報)内:<Report><Body><Tsunami><Forecast><Item><Category><LastKind><Code>タグ
設定値 情報定義元の値をそのまま設定。
備考  
説明 津波予報区に対して前回発表されていた津波注意報・警報などの名称を設定。
情報定義元 気象庁XML電文(津波警報・注意報・予報)内:<Report><Body><Tsunami><Forecast><Item><Category><LastKind><Name>タグ
設定値 情報定義元の値をそのまま設定。
備考  
  • 警報種別コード/警報種別名((前回)含む)の関連表

    警報種別コード 警報種別名 備考
    00 津波なし 警報種別コード(前回)/警報種別名(前回)でのみ、津波速報の新規発表時に設定
    50 警報解除  
    51 津波警報  
    52 大津波警報  
    53 大津波警報:発表  
    60 津波注意報解除  
    62 津波注意報  
    71 津波予報(若干の海面変動)  
    72 津波予報(若干の海面変動) 津波注意報解除、津波予報(若干の海面変動)への切替
    73 津波予報(若干の海面変動) 津波警報解除、津波予報(若干の海面変動)への切替)
説明 気象庁が津波警報・注意報・予報を発表した時刻を設定。
情報定義元 気象庁XML電文(津波警報・注意報・予報)内:<Report><Head><ReportDateTime>タグ
設定値 情報定義元の値をそのまま設定。
備考
JST表記のDateTime型(ISO8601形式(YYYY-MM-DDTHH:mm:SS+09:00))で表記。
時刻は分単位で、秒は常に"00"
説明 見出し文を自由文形式で設定。
情報定義元 気象庁XML電文(津波警報・注意報・予報)内:<Report><Head><Headline><Text>タグ
設定値 情報定義元の値をそのまま設定。
備考  
説明 付加的な情報を固定付加文の形式で設定。
情報定義元 気象庁XML電文(津波警報・注意報・予報)内:<Report><Body><Comments><WarningComment><Text>タグ
設定値 空文字、または情報定義元の値をそのまま設定。
備考 <Comments><WarningComment><Text>タグが存在しない場合、空文字を設定。
説明 その他の付加的な情報を自由付加文の形式で設定。
情報定義元 気象庁XML電文(津波警報・注意報・予報)内:<Report><Body><Comments><FreeFormComment>タグ
設定値 空文字、または情報定義元の値をそのまま設定。
備考 <Comments><FreeFormComment>タグが存在しない場合、空文字を設定。
説明 予想される津波の高さの最大値を文字列表現で設定。
情報定義元 気象庁XML電文(津波警報・注意報・予報)内:<Report><Body><Tsunami><Forecast><Item><MaxHeight><jmx_eb:TsunamiHeight>タグのdescription属性
設定値
空文字、または情報定義元の値をそのまま設定。
情報定義元は、「0.2m未満」、「1m」、「3m」、「5m」、「10m」、「10m超」、「高い」、「巨大」のいずれかが設定。
備考 津波減衰による津波警報や注意報の切り替えの場合や、解除系(予報への切り替え含む)の場合、XML電文には<MaxHeight>タグが存在しないため、この場合は空文字を設定。
説明 津波の到達予想時刻を設定。
情報定義元 気象庁XML電文(津波警報・注意報・予報)内:<Report><Body><Tsunami><Forecast><Item><FirstHeight><ArrivalTime>タグ
設定値 空文字、または情報定義元の値をそのまま設定。
備考
JST表記のDateTime型(ISO8601形式(YYYY-MM-DDTHH:mm:SS+09:00))で表記。
津波警報・注意報を解除する場合(予報への切り替え含む)場合、XML電文には<FirstHeight>タグが存在しないため、この場合は空文字を設定。
また既に第一波が到達したと推測される場合、当該津波予報区内の潮位観測点で第一波が観測された場合、<ArrivalTime>タグは存在しないため、この場合も空文字を設定。
説明 警報種別:津波予報の失効日時を設定
情報定義元 気象庁XML電文(津波警報・注意報・予報)内:<Report><Head><ValidDateTime>タグ
設定値 空文字、または情報定義元の値をそのまま設定。
備考
JST表記のDateTime型(ISO8601形式(YYYY-MM-DDTHH:mm:SS+09:00))で表記。
時刻は分単位で、秒は常に"00"
警報種別が『津波予報』系の場合にのみ設定されます。それ以外の場合は、空文字が設定されます。
気象庁発表情報の警報種別が『津波予報』系であるにも関わらず、失効日時が設定されていない場合、サーバ受信時刻から5分後の値が設定されています。
説明 津波の到達区分を設定。
情報定義元 気象庁XML電文(津波警報・注意報・予報)内:<Report><Body><Tsunami><Forecast><Item><FirstHeight><Condition>タグ
設定値
空文字、または情報定義元の値をそのまま設定。
情報定義元は、「ただちに津波来襲と予測」、「津波到達中と予測」、「第一波の到達を確認」のいずれかが設定。
備考
津波警報・注意報を解除する場合(予報への切り替え含む)場合、XML電文には<FirstHeight>タグが存在しないため、この場合は空文字を設定。
また津波が未到達の場合など、XML電文に<Condition>タグが存在しないため、この場合も空文字を設定。
説明 端末表示用文言
情報定義元 なし
設定値 常に空文字を設定。
備考 利用しない。

WebSocket APIから通知されるメッセージ例

"version": {                                    // バージョン情報(全パラメータ必須)
  "common_version": "1",                          // [common]区のバージョンが指定
  "details_version": "1"                          // [details]区のバージョンが指定
},
"common": {                                     // 共通情報(全パラメータ必須)
  "datatype": "tsunami",                          // 通知メッセージ種別
  "msgid": "server1-TSUNAMI-20131031100000",      // メッセージID
  "sendid": "server1",                            // 発信元ID
  "senddatetime": "2013-10-31 10:00:00+0900"      // 発信時刻
},
"details": [                                    // メッセージ詳細(全パラメータ必須)
  {
    "id": 1,                                        // 履歴データID
    "createid": 2,                                  // 最新データID
    "datatypename": "tsunami",                      // データタイプ名
    "dataversion": 1,                               // データバージョン
    "create_date": "2013-10-30T00:00:00.11+09+00",  // データ登録日時
    "update_date": "2013-10-31T10:00:00.01+09+00",  // データ更新日時
    "expire_date": "2013-11-10T10:00:00.01+09+00",  // データ保持期限日時
    "areacode": "312",                              // 津波予報区コード
    "areaname": "東京湾内",                         // 津波予報区名
    "controlstatus": "通常",                        // 津波運用種別
    "wavetypecode": "62",                           // 津波警報種別コード(62:津波注意報)
    "wavetypename": "津波注意報",                   // 津波警報種別名
    "lastwavetypecode": "62",                       // (前回)津波警報種別コード(62:津波注意報)
    "lastwavetypename": "津波注意報",               // (前回)津波警報種別名
    "pressdt": "2013-11-19T10:00:00+09:00",         // 気象庁発表時刻
    "headline": "",                                 // ヘッドライン
    "warningcomment": 1,                            // 固有付加文
    "freeformcomment": 38.1,                        // 自由付加文
    "height": "1m",                               // 予測される津波の高さ(単位含む)
    "at": "2013-11-19T10:15:00+09:00",              // 津波到達予測時刻
    "vt": "",                                       // 津波予報失効時刻
    "arrived": "ただちに津波来襲と予測",            // 津波到達予測区分
    "termmsg": ""                                   // 端末表示文言
  },
  {
    "id": 3,                                        // 履歴データID
    "createid": 4,                                  // 最新データID
    "datatypename": "tsunami",                      // データタイプ名
    "dataversion": 1,                               // データバージョン
    "create_date": "2013-10-30T00:00:00.11+09:00",  // データ登録日時
    "update_date": "2013-10-31T10:00:00.01+09:00",  // データ更新日時
    "expire_date": "2013-11-10T10:00:00.01+09:00",  // データ保持期限日時
    "areacode": "330",                              // 津波予報区コード
    "areaname": "相模湾",                           // 津波予報区名
    "controlstatus": "通常",                        // 津波運用種別
    "wavetypecode": "71",                           // 津波警報種別コード(71:津波予報)
    "wavetypename": "津波予報",                     // 津波警報種別名
    "lastwavetypecode": "62",                       // (前回)津波警報種別コード(62:津波注意報)
    "lastwavetypename": "津波注意報",               // (前回)津波警報種別名
    "pressdt": "2013-11-19T10:00:00+09:00",         // 気象庁発表時刻
    "headline": "",                                 // ヘッドライン
    "warningcomment": 1,                            // 固有付加文
    "freeformcomment": 38.1,                        // 自由付加文
    "height": "3m",                               // 予測される津波の高さ(単位含む)
    "at": "2013-11-19T10:10:00+09:00",              // 津波到達予測時刻
    "vt": "2013-11-19T10:15:00+09:00",              // 津波予報失効時刻
    "arrived": "ただちに津波来襲と予測",            // 津波到達予測区分
    "termmsg": ""                                   // 端末表示文言
  }
]