地震情報(震度速報)通知メッセージ(バージョン1)¶

目次

パラメータ一覧表
パラメータ詳細
注意事項
WebSocket APIから通知されるメッセージ例

パラメータ一覧表 ¶

セクションパラメータタイプ設定値意味ユニーク備考

details Array(要素はHash) 以下のパラメータを設定メッセージの詳細情報設定セクション地震情報(震度速報)が設定されます。

id Number アプリ定義値履歴データユニークID 詳細はこちらのページを参照ください。

createid Number アプリ定義値最新データユニークID 詳細はこちらのページを参照ください。

datatypename String "jmaearthquake_flash" 固定データタイプ名詳細はこちらのページを参照ください。

dataversion Number 1 固定データバージョン詳細はこちらのページを参照ください。

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)

データ保持期限日時詳細はこちらのページを参照ください。

xmlid String 【YYYYMMDDHHmmSS】-【XML電文データハッシュ値】気象庁XML電文ごとに割り振るユニークID

YYYYMMDDHHmmSS値は電文発信時刻(send_datetime値(UTC))で算出。

XML電文データは、気象庁から配信されるデータ内の気象バイナリデータ本文(XMLのgzip圧縮データ)を指す。

typecode String

気象庁定義値

"VXSE51"固定

気象庁XML電文データ種類コード VXSE51は気象地震情報(震度速報)を示す。

controlstatus String

気象庁定義値

"通常", "訓練", "試験"

発表された地震情報(震度速報)の運用種別

controlstatuscode String "0", "1", "2" 運用種別をコード化した情報複合キー

0 - 通常

1 - 訓練

2 - 試験

「eventid」と「areacode」との組み合わせで一意なレコードとなる。

infotype String

気象庁定義値

"発表", "訂正", "取消"

発表形態

infotypecode String "1", "2", "3" 発表形態をコード化した情報

1 - 発表

2 - 訂正

3 - 取消

eventid String XML電文記載値本情報の地震識別番号複合キー「controlstatuscode」と「areacode」との組み合わせで一意なレコードとなる。

serial String XML電文記載値情報の発表番号

title String XML電文記載値標題

headline String XML電文記載値見出し文

prefcode String XML電文記載値地震情報(震度速報)発表対象の都道府県コードコード定義はパラメータ詳細を参照

prefname String XML電文記載値地震情報(震度速報)発表対象の都道府県名称名称定義はパラメータ詳細を参照

areacode String XML電文記載値地震情報(震度速報)発表対象の地域コード複合キー

コード定義はパラメータ詳細を参照

「controlstatuscode」と「eventid」との組み合わせで一意なレコードとなる。

areaname String XML電文記載値地震情報(震度速報)発表対象の地域名称名称定義はパラメータ詳細を参照

maxint String

気象庁定義値

"3", "4", "5-", "5+", "6-", "6+", "7"

地震情報(震度速報)発表対象の地域の最大震度情報

additionalinfo String XML電文記載値追加情報

forecastcomment String XML電文記載値付加情報：固定付加文

freeformcomment String XML電文記載値付加情報：自由付加文

send_datetime String

ISO8601形式

(例:YYYY-MM-DDTHH:mm:SSZ(UTC表記))

発信時刻

report_datetime String

ISO8601形式

(例:YYYY-MM-DDTHH:mm:00+09:00(JST表記))

発表時刻時刻は分単位で刻み、秒は常に00が設定

editorial_office String XML電文記載値実際に発表作業を行った官署名

publishing_office String XML電文記載値業務的に発表した官署名

officecode String XML電文記載値発信官署コード

パラメータ詳細 ¶

xmlid:XML電文ID

説明気象庁XML電文ごとのユニークな値を設定。

情報定義元気象庁XML電文データを基にアプリケーションで独自定義

設定値気象庁のXML電文の発信時刻(send_datetime値)とXML電文のハッシュ値(SHA256)を利用し、【YYYYMMDDHHmmSS】+ 【XML電文ハッシュ値】を設定。

備考

XML電文の発信時刻(send_datetime値)はUTC表記。

同一XML電文で登録された情報を取得する際などの利用を想定。

typecode:データ種類コード

説明 XML電文のデータ種類コードを設定。

情報定義元気象庁通知電文ヘッダ: XML電文のデータ種類コード値部

設定値地震情報(震度速報)では、「VXSE51」固定。

備考

controlstatus:運用種別

説明発表された地震情報(震度速報)の運用種別を設定。

情報定義元気象庁XML電文(地震情報)内：<Report><Control><Status>タグ

設定値

情報定義元の値をそのまま設定。

情報定義元は、「通常」、「訓練」、「試験」のいずれかが設定。

備考

通常報について

- 地震発生を観測した場合に発表する地震情報(震度速報)が元の情報の場合、controlstatusを「通常」で設定します。

訓練報について

- 気象庁が不定期で訓練報を通知することがあり、この場合controlstatusを「訓練」で設定します。

- 訓練報の扱いは、利用者毎の定義となります。

試験報について

- 気象庁が不定期で試験報を通知することがあり、この場合controlstatusを「試験」で設定します。

- 上述以外に、端末設置時などで地震情報の受信が行えるかの試験を行う場合、controlstatusを「試験」で設定することがあります。

- 試験報の扱いは、利用者毎の定義となります。

controlstatuscode:運用種別コード

説明 controlstatusをコード化した文字列を設定。

情報定義元気象庁XML電文データを基にアプリケーションで独自定義

設定値 controlstatus値により下表の条件で設定。

備考

運用種別: controlstatus 運用種別コード: controlstatuscode

通常 0

訓練 1

試験 2

infotype:情報形態

説明情報形態を設定。

情報定義元気象庁XML電文(地震情報)内：<Report><Head><InfoType>タグ

設定値

情報定義元の値をそのまま設定。

“発表”、“訂正”、“取消”のいずれかが設定。

備考 ”訂正”は現在気象庁で運用していないため、設定されない。(定義のみ)

infotypecode:情報形態コード

説明 infotypeをコード化した文字列を設定。

情報定義元気象庁XML電文データを基にアプリケーションで独自定義

設定値 infotype値により下表の条件で設定。

備考

情報形態: infotype 情報形態コード: infotypecode

発表 1

訂正 2

取消 3

eventid:識別情報

説明地震情報(震度速報)の地震を識別するための番号を設定。

情報定義元気象庁XML電文(地震情報)内：<Report><Head><EventID>タグ

設定値情報定義元の値をそのまま設定。

備考地震識別番号は、特定の地震を識別するために気象庁のシステムが割り振る14桁の半角数字表記の番号。

serial:情報番号

説明情報の発表番号を設定。

情報定義元気象庁XML電文(地震情報)内：<Report><Head><Serial>タグ

設定値空文字、または情報定義元の値をそのまま設定。

備考地震情報(震度速報)発表時には通常、空タグが設定されるため空文字を設定。

title:標題

説明本情報の具体的な内容を示す値を設定。

情報定義元気象庁XML電文(地震情報)内：<Report><Head><Title>タグ

設定値情報定義元の値をそのまま設定。

備考

headline:見出し文

説明見出しの内容を設定。

情報定義元気象庁XML電文(地震情報)内：<Report><Head><Headline><Text>タグ

設定値情報定義元の値をそのまま設定。

備考

prefcode:都道府県コード

説明地震情報(震度速報)発表対象の都道府県コードを設定。

情報定義元気象庁XML電文(地震情報)内：<Body><Intensity><Observation><Pref><Code>タグ

設定値情報定義元の値をそのまま設定。

備考

気象庁防災情報XMLフォーマット | 技術資料

上記サイトのコード管理表及び個別コード表の『個別コード表[zip形式]』内の、「地震火山関連コード表.xls」の地震情報／都道府県等コード表シート(23)の定義を参照。

prefname:都道府県名称

説明地震情報(震度速報)発表対象の都道府県名称を設定。

情報定義元気象庁XML電文(地震情報)内：<Report><Body><Intensity><Observation><Pref><Name>タグ

設定値情報定義元の値をそのまま設定。

備考

気象庁防災情報XMLフォーマット | 技術資料

上記サイトのコード管理表及び個別コード表の『個別コード表[zip形式]』内の、「地震火山関連コード表.xls」の地震情報／都道府県等コード表シート(23)の定義を参照。

areacode:地域コード

説明地震情報(震度速報)発表対象の地域コードを設定。

情報定義元気象庁XML電文(地震情報)内：<Report><Body><Intensity><Observation><Pref><Area><Code>タグ

設定値情報定義元の値をそのまま設定。

備考

気象庁防災情報XMLフォーマット | 技術資料

上記サイトのコード管理表及び個別コード表の『個別コード表[zip形式]』内の、「地震火山関連コード表.xls」の地震情報／細分区域コード表シート(24)、「AreaForecastLocalE」列の定義を参照。

areaname:地域名称

説明地震情報(震度速報)発表対象の地域名称を設定。

情報定義元気象庁XML電文(地震情報)内：<Report><Body><Intensity><Observation><Pref><Area><Name>タグ

設定値情報定義元の値をそのまま設定。

備考

気象庁防災情報XMLフォーマット | 技術資料

上記サイトのコード管理表及び個別コード表の『個別コード表[zip形式]』内の、「地震火山関連コード表.xls」の地震情報／細分区域コード表シート(24)、「AreaForecastLocalE」列の定義を参照。

maxint:最大震度

説明地震情報(震度速報)発表対象の地域における、最大観測震度を設定。

情報定義元気象庁XML電文(地震情報)内：<Report><Body><Intensity><Observation><Pref><Area><City><MaxInt>タグ

設定値情報定義元の値をそのまま設定。

備考

additionalinfo:追加情報

説明追加情報を設定。

情報定義元気象庁XML電文(地震情報)内：<Report><Body><Text>タグ

設定値情報定義元の値をそのまま設定。

備考

forecastcomment:付加情報：固定付加文

説明付加情報の固定付加文を設定。

情報定義元気象庁XML電文(地震情報)内：<Report><Body><Comments><ForecastComment><Text><Report>タグ

設定値情報定義元の値をそのまま設定。

備考

freeformcomment:付加情報：自由付加文

説明付加情報の自由付加文を設定。

情報定義元気象庁XML電文(地震情報)内：<Report><Body><Comments><FreeFormComment>タグ

設定値情報定義元の値をそのまま設定。

備考

send_datetime:発信時刻

説明気象庁システムからの発信時刻を設定。

情報定義元気象庁XML電文(地震情報)内：<Report><Control><DateTime>タグ

設定値情報定義元の値をそのまま設定。

備考 UTC表記のDateTime型

report_datetime:発表時刻

説明発表官署が地震情報(震度速報)を発表した時刻を設定

情報定義元気象庁XML電文(地震情報)内：<Report><Head><ReportDateTime>タグ

設定値情報定義元の値をそのまま設定。

備考

JST表記のDateTime型

時刻は分単位で、秒は常に"00"

editorial_office:編集官署名

説明実際に発表作業を行った官署名を設定。

情報定義元気象庁XML電文(地震情報)内：<Report><Control><EditorialOffice>タグ

設定値情報定義元の値をそのまま設定。

備考

publishing_office:発表官署名

説明業務的に発表した官署名を設定。

情報定義元気象庁XML電文(地震情報)内：<Report><Control><PublishingOffice>タグ

設定値情報定義元の値をそのまま設定。

備考

officecode:発信官署コード

説明電文の発信を行った官署コード値を設定。

情報定義元気象庁通知電文ヘッダ: 発信官署コード値部

設定値

情報定義元の値をそのまま設定。

設定されるコード値とそれに対応する官署名を下表に示す。

備考

発信官署コード

(英字発信官署名)

気象官署名

RJTD 気象庁本庁

JPOS 大阪管区気象台

注意事項 ¶

地震識別番号について

地震識別番号はある特定の地震を識別するために気象庁が割り当てる番号であり、いったん割り当てられた地震識別番号は、その後の関連する電文の配信に際して一貫して利用されます。
このため、地震情報(震度速報)に含まれる地震識別番号をキーとして、地震情報(震源・震度に関する情報など)や津波情報などを取得することが基本的には可能となりますが、
システム障害発生などにより発信官署が異なる場合や、複数地震が連続して発生した場合などには、同一地震であっても地震識別番号が一貫しない場合があります。

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

"version": {                                    // バージョン情報(全パラメータ必須)
  "common_version": "1",                            // [common]区のバージョンが指定
  "details_version": "1"                            // [details]区のバージョンが指定
},
"common": {                                     // 共通情報(全パラメータ必須)
  "datatype": "jmaearthquake_flash",                    // 通知メッセージ種別
  "msgid": "eq_jmaearthquake_flash_20150721182000000000",// メッセージID
  "sendid": "server1",                                  // 発信元ID
  "senddatetime": "2015-07-21 18:20:00+09:00"           // 発信時刻
},
"details": [                                    // メッセージ詳細(全パラメータ必須)
  {
    "id" : 918344,                                       // 履歴データID
    "createid" : 9245344,                                // 最新データID
    "datatypename" : "jmaearthquake_flash",              // データタイプ名(地震情報(震度速報)=jmaearthquake_flash)
    "dataversion" : 1,                                   // データバージョン
    "create_date" : "2015-09-02T11:51:39.665304+09:00",  // データ登録日時
    "update_date" : "2015-09-02T11:51:39.665304+09:00",  // データ更新日時
    "expire_date" : "",                                  // データ保存期限日時
    "xmlid" : "20150828144758-f15f8f5bbffd508b9f4244e4edb72bea49dcb896ecb05b9c5efd40ec4a26a8b7",
                                                         // XMLID
    "typecode" : "VXSE51",                               // データ種類コード
    "controlstatuscode" : "0",                           // 運用種別コード
    "controlstatus" : "通常",                            // 運用種別
    "infotypecode" : "1",                                // 発表形態コード
    "infotype" : "発表",                                 // 発表形態
    "eventid" : "20150828234628",                        // 地震識別番号
    "serial" : "",                                       // 発表番号
    "title"" : "震度速報",                               // 標題
    "headline" : "２８日２３時４６分ころ、地震による強い揺れを感じました。震度３以上が観測された地域をお知らせします。",
                                                         // 見出し文
    "prefcode" : "08",                                   // 都道府県コード
    "prefname" : "茨城県",                               // 都道府県名称
    "areacode" : "300",                                  // 地域コード
    "areaname" : "茨城県北部",                           // 地域名称
    "maxint" : "3",                                      // 最大震度
    "additionalinfo" : "",                               // テキスト要素
    "forecastcomment" : "今後の情報に注意してください。",// 固定付加文
    "freeformcomment" : "",                              // 自由付加文
    "send_datetime" : "2015-08-28T14:47:58Z",            // 発信時刻
    "report_datetime" : "2015-08-28T23:47:00+09:00",     // 発表時刻
    "editorial_office" : "気象庁本庁",                   // 編集官署名
    "publishing_office" : "気象庁",                      // 発表官署名
    "officecode" : "RJTD"                                // 発信官署コード
  }
]