J-ALERT(XMLバージョン2対応版)通知メッセージ¶
目次
パラメータ一覧表¶
セクション パラメータ タイプ 設定値 意味 ユニーク 備考 details Array(要素はHash) 以下のパラメータを設定 メッセージの詳細情報設定セクション J-ALERTが設定されます。 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) データ保持期限日時 詳細は こちらのページ を参照ください。 docid String XML電文記載値(UUID または半角英数字、ハイフン、ピリオド、アンダースコアを組み合わせた文字列)マルチメディア振興センターのシステムで採番されたID 複合キー 以下のキーとの組み合わせで一意なレコードとなる。「countrycode」「citycode」「status」revision String XML電文記載値("1"固定) ドキュメントのリビジョン番号 常に新たな情報として「1」が設定されます。 lang String "ja"固定 言語 countrycode String "392"固定 国名コード 複合キー 以下のキーとの組み合わせで一意なレコードとなる。「docid」「citycode」「status」countryname String "Japan"固定 国名 prefcode String 01~47(都道府県コード)、00(不明)、99(全国) 都道府県コード 総務省定義の「全国地方公共団体コード」 の先頭2桁citycode値の十万の位、一万の位の抽出値prefname String 北海道~沖縄県(全国都道府県名称)、「不明」、「全国」 都道府県名称 総務省定義の「全国地方公共団体コード」 の都道府県コードに割り当てられている名称prefcode値に該当する都道府県名称citycode String XML電文記載値(数字6桁固定長) 市区町村コード(総務省定義「全国地方公共団体コード」) 複合キー cityname String XML電文記載値 市区町村名称 市区町村名称に都道府県名称が付与される場合あり。(例:福島県喜多方市) send_at String XML電文記載値(XML Schema datetime形式時刻情報(例:YYYY-MM-DDTHH:mm:SS+HH:mm)) 送信日時 status String XML電文記載値("Actual", "Exercise", "Test") 運用種別 複合キー Actual - 本番Exercise - 訓練Test - テスト以下のキーとの組み合わせで一意なレコードとなる。「docid」「countrycode」「citycode」category String "CivilProtection"固定 カテゴリ subject String "国民保護に関する情報"固定 タイトル info_summary String XML電文記載値 本文 info_detail String XML電文記載値 詳細 info_summaryと同内容 info_complement String 空文字列 使用しません。将来のための予約項目です。 incident_desc String 空文字列 使用しません。将来のための予約項目です。 invalid_desc String XML電文記載値 取消、無効化された場合の説明文 無効の場合のみ使用します。取消はありません。 invalid_datetime String XML電文記載値 取消、無効化された日時 無効の場合のみ使用します。取消はありません。 invalid_type_code String "0", "1", "2" 取消・無効種別コード 0 - 有効1 - 取消(※使用しません)2 - 無効editorial_office Array(要素はHash) XML電文記載値 作成部署情報 詳細は こちら を参照ください。 publishing_office Array(要素はHash) XML電文記載値 発表部署情報 詳細は こちら を参照ください。
パラメータ詳細¶
説明 ドキュメント毎に割り当てられたIDを設定。 情報定義元 マルチメディア振興センターXML電文(commons:documentID) 設定値 情報定義元の値をそのまま設定。 備考
説明 ドキュメントのリビジョン番号を設定。 情報定義元 マルチメディア振興センターXML電文(commons:documentRevision) 設定値 情報定義元の値をそのまま設定。 備考 常に新たな情報として「1」が設定される。
説明 設定言語情報を設定。 情報定義元 アプリケーションで独自定義 設定値 "ja" 固定 備考
説明 対象となる国名コードを設定。 情報定義元 アプリケーションで独自定義 設定値 "392" 固定 備考 ISO 3166-1で定義された国名コード(392=日本)
説明 対象となる国名を設定。 情報定義元 アプリケーションで独自定義 設定値 "Japan" 固定 備考
説明 対象となる都道府県コードを設定。 情報定義元 マルチメディア振興センターXML電文(commons:jisX0402)を基にアプリケーションで独自定義 設定値 "01"~"47", "00", "99" 備考
説明 対象となる都道府県名称を設定。 情報定義元 マルチメディア振興センターXML電文(commons:jisX0402)を基にアプリケーションで独自定義 設定値 【都道府県名称】または"不明"または"全国" 備考 prefcode値から都道府県名称を取得する。prefcode値が99の場合は、「全国」を設定する。都道府県が判別できない場合は、「不明」を設定する。
説明 対象となる市区町村(地域)コードを設定。 情報定義元 マルチメディア振興センターXML電文(commons:jisX0402) 設定値 情報定義元の値をそのまま設定。 備考 「全国地方公共団体コード」は、 総務省のwebサイト をご確認ください。全国地方公共団体コードは6桁のコードで表されます。対象が都道府県全体となる場合は都道府県のコードが設定されます。(例: 北海道=010006)
説明 対象となる市区町村(地域)名を設定。 情報定義元 マルチメディア振興センターXML電文(commons:areaName) 設定値 情報定義元の値をそのまま設定。 備考 市区町村コードと紐付いた名称以外が設定される可能性があります。
説明 送信日時を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_ib:CreateDateTime) 設定値 情報定義元の値をそのまま設定。 備考
説明 運用種別を設定。 情報定義元 マルチメディア振興センターXML電文(commons:distributionStatus) 設定値 情報定義元の値をそのまま設定。 備考 Actual: 本番Exercise: 訓練Test: テスト
説明 カテゴリを設定。 情報定義元 マルチメディア振興センターXML電文(commons:category) 設定値 情報定義元の値をそのまま設定。 備考 "CivilProtection" 固定
説明 タイトルを設定。 情報定義元 マルチメディア振興センターXML電文(pcx_ib:Title) 設定値 情報定義元の値をそのまま設定。 備考 "国民保護に関する情報" 固定無効化された場合、空文字列が設定されます。
説明 本文(内容)を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_cp:Content) 設定値 情報定義元の値をそのまま設定。 備考 無効化された場合、空文字列が設定されます。
説明 詳細を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_cp:Content) 設定値 本文(info_summary)と同内容を設定 備考 無効化された場合、空文字列が設定されます。
説明 補足情報を設定。(予約) 情報定義元 なし 設定値 常に空文字を設定。 備考 使用しません。将来のための予約項目です。
説明 説明文を設定。(予約) 情報定義元 なし 設定値 常に空文字を設定。 備考 使用しません。将来のための予約項目です。
説明 取消、無効化された場合の説明文を設定。 情報定義元 マルチメディア振興センターXML電文(取消: pcx_eb:Description)(無効: commons_dr:description)設定値 情報定義元の値をそのまま設定。 備考 無効の場合のみ使用します。 取消はありません。
説明 取消、無効化された日時を設定。 情報定義元 マルチメディア振興センターXML電文(取消: pcx_eb:DateTime)(無効: commons_dr:dateTimeRevoked)設定値 情報定義元の値をそのまま設定。 備考 無効の場合のみ使用します。 取消はありません。
説明 取消・無効種別コードを設定。 情報定義元 マルチメディア振興センターXML電文を基にアプリケーションで独自定義 設定値 0: 有効1: 取消(※使用しません)2: 無効備考 取消はありません。
説明 作成部署情報を設定。 情報定義元 マルチメディア振興センターXML電文 設定値 情報定義元の値をそのまま設定。 備考 設定値の詳細は こちら を参照ください。
説明 発表部署情報を設定。 情報定義元 マルチメディア振興センターXML電文 設定値 情報定義元の値をそのまま設定。 備考 設定値の詳細は こちら を参照ください。
作成部署情報(editorial_office)の詳細¶
項目名 | <固有名称>key名 | タイプ |
---|---|---|
部署の名称 | office_name | String |
組織の名称 | organization_name | String |
組織コード | organization_code | String |
組織のドメイン名 | organization_domain_name | String |
office_name:部署の名称
説明 部署の名称を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_eb:OfficeName) 設定値 情報定義元の値をそのまま設定。 備考 "J-ALERT(政府)"固定 organization_name:組織の名称
説明 組織の名称を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_eb:OrganizationName) 設定値 情報定義元の値をそのまま設定。 備考 "J-ALERT(政府)"固定 organization_code:組織コード
説明 組織コードを設定。 情報定義元 マルチメディア振興センターXML電文(pcx_eb:OrganizationCode) 設定値 情報定義元の値をそのまま設定。 備考 organization_domain_name:組織のドメイン名
説明 組織のドメイン名を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_eb:OrganizationDomainName) 設定値 情報定義元の値をそのまま設定。 備考
発表部署情報(publishing_office)の詳細¶
項目名 | <固有名称>key名 | タイプ |
---|---|---|
部署の名称 | office_name | String |
組織の名称 | organization_name | String |
組織コード | organization_code | String |
組織のドメイン名 | organization_domain_name | String |
office_name:部署の名称
説明 部署の名称を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_eb:OfficeName、無効の場合はcommons:publishingOfficeName)設定値 情報定義元の値をそのまま設定。 備考 "J-ALERT(消防庁)"固定(無効の場合は除く) organization_name:組織の名称
説明 組織の名称を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_eb:OrganizationName、無効の場合はcommons:publishingOrganizationName)設定値 情報定義元の値をそのまま設定。 備考 "J-ALERT(消防庁)"固定(無効の場合は除く) organization_code:組織コード
説明 組織コードを設定。 情報定義元 マルチメディア振興センターXML電文(pcx_eb:OrganizationCode、無効の場合はcommons:publishingOfficeID)設定値 情報定義元の値をそのまま設定。 備考 organization_domain_name:組織のドメイン名
説明 組織のドメイン名を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_eb:OrganizationDomainName、無効の場合はcommons:publishingOfficeDomainName)設定値 情報定義元の値をそのまま設定。 備考
注意事項¶
- 対象となる地域が「全国」(citycode=999997)である場合について
- 発表されたJ-ALERT(国民保護情報)の対象地域が「全国」である場合、本サービスでは、全都道府県に対して発表されたものとみなし、全国(prefcode=99)の情報に加え、全都道府県の情報を通知します。
WebSocket APIから通知されるメッセージ例¶
"version": { "common_version": "1", "details_version": "1" }, "common": { "datatype": "jalert2", "msgid": "eq_jalert2_20200130100005574351", "sendid": "1", "senddatetime": "2020-01-30 10:00:05+0900" }, "details": [ { "id": 1, "createid": 1, "datatypename": "jalert2", "dataversion": 1, "create_date": "2020-01-30T10:00:04.426671+09:00", "update_date": "2020-01-30T10:00:04.426671+09:00", "expire_date": "", "docid": "5d3c49ce-8e99-4eea-9780-f91315b2210d", "revision": "1", "lang": "ja", "countrycode": "392", "countryname": "Japan", "prefcode": "01", "prefname": "北海道", "citycode": "010006", "cityname": "北海道", "send_at": "2020-01-30T10:00:04+09:00", "status": "Test", "category": "CivilProtection", "subject": "国民保護に関する情報", "info_summary": "【訓練】試験放送です。", "info_detail": "【訓練】試験放送です。", "info_complement": "", "incident_desc": "", "invalid_desc": "", "invalid_datetime": "", "invalid_type_code": "0", "editorial_office": [ { "office_name": "J-ALERT(政府)", "organization_name": "J-ALERT(政府)", "organization_code": "", "organization_domain_name": "j-alert.go.jp" } ], "publishing_office": [ { "office_name": "J-ALERT(消防庁)", "organization_name": "J-ALERT(消防庁)", "organization_code": "", "organization_domain_name": "j-alert.go.jp" } ] } ]