Lアラート(公共情報コモンズ)データ(バージョン1)¶
目次
パラメータ一覧表¶
No | 項目名 | <固有名称>key名 | 設定値 | 意味 | データ定義元 | ユニーク | 備考 |
---|---|---|---|---|---|---|---|
|
ドキュメントID | docid | UUID | マルチメディア振興センターのシステムで採番されたID | マルチメディア振興センター | 複合キー | あるドキュメントIDの情報に更新があった場合は、revisionのみが上がります。
以下のキーとの組み合わせで一意のデータとなる。
「4:国コード」
「8:市区町村コード」
「11:運用種別」
|
|
リビジョン | revision | "1" ~ | ドキュメントのリビジョン番号 | マルチメディア振興センター | ||
|
言語 | lang | "ja"固定 | 言語情報 | アプリケーション独自定義 | ||
|
国コード | countrycode | "392"固定 | 国名コード(ISO 3166-1定義) | アプリケーション独自定義 | 複合キー | 以下のキーとの組み合わせで一意のデータとなる。
「1:ドキュメントID」
「8:市区町村コード」
「11:運用種別」
|
|
国名称 | countryname | "Japan"固定 | 国名称 | アプリケーション独自定義 | ||
|
都道府県コード | prefcode | 01~47(都道府県コード)または00(不明) | 発表情報の対象都道府県コード | アプリケーション独自定義 | 総務省定義の「全国地方公共団体コード」 の先頭2桁
8.citycode値の十万の位、一万の位を抽出した値
|
|
|
都道府県名称 | prefname | 北海道~沖縄県(都道府県名称)または「不明」 | 発表情報の対象都道府県名称 | アプリケーション独自定義 | 総務省定義の「全国地方公共団体コード」 の都道府県コードに割り当てられている名称
6.prefcode値に該当する都道府県名称
|
|
|
市区町村コード | citycode | 数字6桁固定長 | 総務省が定義している「全国地方公共団体コード」 | マルチメディア振興センター | 複合キー | |
|
市区町村名称 | cityname | XML電文記載値 | 発表情報の対象地域名称 | マルチメディア振興センター | 8.citycodeに紐付いた市区町村名ではなく、マルチメディア振興センターが設定した地域名称が設定されています。 | |
|
発表情報送信日時 | send_at | XML-Schema datetime形式時刻情報(例:YYYY-MM-DDTHH:mm:SS+HH:mm) | 発表情報の送信日時 | マルチメディア振興センター | ||
|
運用種別 | status | "Actual", "Exercise", "Test" | 発表情報の運用種別 | マルチメディア振興センター | 複合キー | Actual - 本番
Exercise - 訓練
Test - テスト
以下のキーとの組み合わせで一意のデータとなる。
「1:ドキュメントID」
「4:国コード」
「8:市区町村コード」
|
|
情報カテゴリ | category | "EvacuationOrder", "Shelter", "AntidisasterHeadquarter", "DamageInformation", "Event", "GeneralInformation" | 発表情報カテゴリー | マルチメディア振興センター | EvacuationOrder - 避難情報
Shelter - 避難所情報
AntidisasterHeadquarter - 災害対策本部設置状況
DamageInformation - 被害情報
Event - イベント情報
GeneralInformation - お知らせ
|
|
|
タイトル | subject | XML電文記載値 | 発表情報文書のタイトル | マルチメディア振興センター | ||
|
本文 | info_summary | XML電文記載値 | 発表情報文書の本文 | マルチメディア振興センター | ||
|
詳細 | info_detail | XML電文記載値 | 発表情報文書の詳細 | マルチメディア振興センター | 情報カテゴリの値により、設定内容が異なります。
詳細は こちら を参照ください。
|
|
|
補足情報 | info_complement | XML電文記載値 | 発表情報文書の補足情報 | マルチメディア振興センター | ||
|
説明文 | incident_desc | XML電文記載値 | 発表情報文書の事象に対する説明文 | マルチメディア振興センター |
パラメータ詳細¶
説明 ドキュメント毎に割り当てられたIDを設定。 情報定義元 マルチメディア振興センターXML電文(commons:documentID) 設定値 情報定義元の値をそのまま設定。 備考
説明 ドキュメントのリビジョン番号を設定。 情報定義元 マルチメディア振興センターXML電文(commons:documentRevision) 設定値 情報定義元の値をそのまま設定。 備考
説明 設定言語情報を設定。 情報定義元 アプリケーションで独自定義 設定値 "ja" 固定 備考
説明 対象となる国名コードを設定。 情報定義元 アプリケーションで独自定義 設定値 "392" 固定 備考 ISO 3166-1で定義された国名コード(392=日本)
説明 対象となる国名を設定。 情報定義元 アプリケーションで独自定義 設定値 "Japan" 固定 備考
説明 対象となる都道府県コードを設定。 情報定義元 マルチメディア振興センターXML電文(commons:jisX0402)を基にアプリケーションで独自定義 設定値 "01"~"47", "00" 備考
説明 対象都道府県名称を設定。 情報定義元 マルチメディア振興センターXML電文(commons:jisX0402)を基にアプリケーションで独自定義 設定値 【都道府県名称】または"不明" 備考 prefcode値から都道府県名称を取得する。都道府県が判別できない場合は、「不明」を設定する。
説明 対象となる市区町村(地域)コードを設定。 情報定義元 マルチメディア振興センターXML電文(commons:jisX0402) 設定値 情報定義元の値をそのまま設定。 備考 「全国地方公共団体コード」は、 総務省のwebサイト をご確認ください。全国地方公共団体コードは6桁のコードで表されます。対象が都道府県全体となる場合は都道府県のコードが設定されます。(例: 北海道=010006)
説明 対象となる市区町村(地域)名を設定。 情報定義元 マルチメディア振興センターXML電文(commons:areaName) 設定値 情報定義元の値をそのまま設定。 備考 市区町村コードと紐付いた名称以外が設定される可能性があります。
説明 情報の送信日時を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_ib:TargetDateTime または pcx_ib:ReportDateTime)設定値 情報定義元の値をそのまま設定。 備考 TargetDateTime未設定の場合、ReportDateTime値を設定。
説明 発表情報の運用種別を設定。 情報定義元 マルチメディア振興センターXML電文(edxlde:distributionStatus) 設定値 情報定義元の値をそのまま設定。 備考 Actual: 本番Exercise: 訓練Test: テスト
説明 発表情報のカテゴリーを設定。 情報定義元 マルチメディア振興センターXML電文(commons:category) 設定値 情報定義元の値をそのまま設定。 備考 AntidisasterHeadquarter: 災害対策本部設置状況EvacuationOrder: 避難情報Shelter: 避難所情報DamageInformation: 被害情報GeneralInformation: お知らせEvent: イベント情報
説明 発表情報のタイトルを設定。 情報定義元 マルチメディア振興センターXML電文(pcx_ib:Title) 設定値 情報定義元の値をそのまま設定。 備考
説明 発表情報の本文(内容)を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_ib:Headline) 設定値 情報定義元の値をそのまま設定。 備考
説明 発表情報の詳細を設定。 情報定義元 マルチメディア振興センターXML電文 設定値 情報カテゴリ(category)の値により、値の形式及び設定される項目が異なります。 備考 設定値の詳細は こちら を参照ください。
説明 発表情報の補足情報を設定。 情報定義元 マルチメディア振興センターXML電文(ComplementaryInfo) 設定値 情報定義元の値をそのまま設定。 備考
説明 発表情報の説明文を設定。 情報定義元 マルチメディア振興センターXML電文(edxlde:incidentDescription) 設定値 情報定義元の値をそのまま設定。 備考
詳細(info_detail)の詳細¶
詳細(info_detail)の設定値は、情報カテゴリ(category)の設定値に応じ、以下の仕様の通り設定されます。
情報カテゴリ(category)
災害対策本部設置状況(AntidisasterHeadquarter)¶
- 値の形式 : JSONとしてデシリアライズ可能なString
項目名 | <固有名称>key名 | タイプ | |||
---|---|---|---|---|---|
災害名 | disastername | String | |||
値 | values | Array(要素はHash) | 【項目名】 | 【<固有名称>key名】 | 【タイプ】 |
本部種別 | type | String | |||
設置状況 | status | String | |||
設置・解散日時 | datetime | String | |||
本部名称 | name | String |
disastername:災害名
説明 発表情報の災害名を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_eb:DisasterName) 設定値 情報定義元の値をそのまま設定。 備考 values:災害対策本部情報
説明 発表情報に関連する災害対策本部の情報群を設定。 情報定義元 マルチメディア振興センターXML電文 設定値 後述のパラメータをハッシュ配列で格納。 備考 type:本部種別
説明 災害対策本部の種別を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_ah:Type) 設定値 情報定義元の値をそのまま設定。 備考 情報定義元は、「警戒本部」、「対策本部」のいずれかが設定。設定値の詳細は、マルチメディア振興センターのフォーマット仕様書を参照。status:設置状況
説明 災害対策本部の設置状況を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_ah:Status) 設定値 情報定義元の値をそのまま設定。(解散または設置) 備考 情報定義元は、「解散」、「設置」のいずれかが設定。設定値の詳細は、マルチメディア振興センターのフォーマット仕様書を参照。datetime:設置・解散日時
説明 災害対策本部の設置または解散日時を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_ah:DateTime) 設定値 情報定義元の値をそのまま設定。 備考 name:本部名称
説明 災害対策本部の名称を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_ah:Name) 設定値 情報定義元の値をそのまま設定。 備考
例(情報を見やすく加工しています)
{ "disastername" : "20140910風水害", "values" : [ { "type" : "警戒本部", "status" : "解散", "datetime" : "2014-09-11T09:50:00.000+09:00", "name" : "" } ] }
避難情報(EvacuationOrder)¶
- 値の形式 : JSONとしてデシリアライズ可能なString
項目名 | <固有名称>key名 | タイプ | |||
---|---|---|---|---|---|
災害名 | disastername | String | |||
値 | values | Array(要素はHash) | 【項目名】 | 【<固有名称>key名】 | 【タイプ】 |
発令区分 | sort | String | |||
発令・解除区分 | issue_or_lift | String | |||
発令・解除地区名 | areaname | String | |||
発令・解除地区名かな | areanamekana | String | |||
発令・移行・解除日時 | datetime | String |
disastername:災害名
説明 発表情報の災害名を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_eb:DisasterName) 設定値 情報定義元の値をそのまま設定。 備考 values:避難情報
説明 発表情報に関連する避難情報の情報群を設定。 情報定義元 マルチメディア振興センターXML電文 設定値 後述のパラメータをハッシュ配列で格納。 備考 sort:発令区分
説明 避難情報の発令区分を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_ev:Sort)を基にアプリケーションにて一部変換 設定値 "高齢者等避難", "避難指示", "警戒区域"備考 情報定義元は、「避難準備」(弊社システムにて「高齢者等避難」へ変換)、「避難指示」、「警戒区域」のいずれかを設定。設定値の詳細は、マルチメディア振興センターのフォーマット仕様書を参照。※2021/05/20 「避難勧告」は廃止されました。※2021/12/15 法令の改正に対応するため、弊社システムにて情報定義元による設定値「避難準備」を「高齢者等避難」へ変換して配信するように仕様変更を行いました。issue_or_lift:発令・解除区分
説明 避難情報の発令または解除の区分を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_ev:IssueOrLift) 設定値 情報定義元の値をそのまま設定。 備考 情報定義元は、「発令」、「解除」のいずれかが設定。設定値の詳細は、マルチメディア振興センターのフォーマット仕様書を参照。areaname:発令・解除地区名
説明 避難情報の対象となる発令または解除地区の名称を設定。 情報定義元 マルチメディア振興センターXML電文(commons:areaName) 設定値 情報定義元の値をそのまま設定。 備考 areanamekana:発令・解除地区名かな
説明 避難情報の対象となる発令または解除地区の名称をかな文字で設定。 情報定義元 マルチメディア振興センターXML電文(commons:areaNameKana) 設定値 情報定義元の値をそのまま設定。 備考 datetime:発令・移行・解除日時
説明 避難情報の発令、移行または解除の日時を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_ev:DateTime) 設定値 情報定義元の値をそのまま設定。 備考
例(情報を見やすく加工しています)
{ "disastername" : "平成26年9月9日からの大雨", "values" : [ { "sort" : "避難指示", "issue_or_lift" : "解除", "areaname" : "有珠の沢町", "areanamekana" : "うすのさわちょう", "datetime" : "2014-09-11T15:30:00+09:00" }, { "sort" : "避難準備", "issue_or_lift" : "解除", "areaname" : "樽前", "areanamekana" : "たるまえ", "datetime" : "2014-09-11T15:30:00+09:00" } ] }
注意事項¶
- 本データタイプはXMLバージョン1.5に対応しています。そのため、情報発信側のシステムがXMLバージョン2.1で発信し、発令区分に「緊急安全確保」を設定した場合、該当する地区の情報は配信されません。
- 詳しくは、 マルチメディア振興センター「公共情報コモンズXMLバージョン2.1の公開について」 にある以下の資料をご参照ください。
- CMNS-B20-033_公共情報コモンズXML定義書version2.1_解説資料(第1版)
- 詳しくは、 マルチメディア振興センター「公共情報コモンズXMLバージョン2.1の公開について」 にある以下の資料をご参照ください。
避難所情報(Shelter)¶
- 値の形式 : JSONとしてデシリアライズ可能なString
項目名 | <固有名称>key名 | タイプ | |||
---|---|---|---|---|---|
災害名 | disastername | String | |||
値 | values | Array(要素はHash) | 【項目名】 | 【<固有名称>key名】 | 【タイプ】 |
避難所種別 | type | String | |||
避難所区分 | sort | String | |||
避難所名称 | areaname | String | |||
避難所名称かな | areanamekana | String | |||
避難所の住所 | address | String |
disastername:災害名
説明 発表情報の災害名を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_eb:DisasterName) 設定値 情報定義元の値をそのまま設定。 備考 values:避難所情報
説明 発表情報に関連する避難所の情報群を設定。 情報定義元 マルチメディア振興センターXML電文 設定値 後述のパラメータをハッシュ配列で格納。 備考 type:避難所種別
説明 避難所の種別を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_sh:Type) 設定値 情報定義元の値をそのまま設定。 備考 情報定義元は、「避難所」、「臨時避難所」、「広域避難場所:開設措置なし」、「一時避難場所:開設措置なし」のいずれかが設定。設定値の詳細は、マルチメディア振興センターのフォーマット仕様書を参照。sort:避難所区分
説明 避難所の設置区分を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_sh:Sort) 設定値 情報定義元の値をそのまま設定。 備考 情報定義元は、「未開設」、「開設」、「閉鎖」、「不明」、「常設」のいずれかが設定。設定値の詳細は、マルチメディア振興センターのフォーマット仕様書を参照。areaname:避難所名称
説明 避難所の名称を設定。 情報定義元 マルチメディア振興センターXML電文(commons:areaName) 設定値 情報定義元の値をそのまま設定。 備考 areanamekana:避難所名称かな
説明 避難所の名称をかな文字で設定。 情報定義元 マルチメディア振興センターXML電文(commons:areaNameKana) 設定値 情報定義元の値をそのまま設定。 備考 address:避難所の住所
説明 避難所の住所を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_sh:Address) 設定値 情報定義元の値をそのまま設定。 備考
例(情報を見やすく加工しています)
{ "disastername" : "平成26年9月11日大雨・洪水による被害", "values" : [ { "type" : "避難所", "sort" : "閉鎖", "areaname" : "利府町総合体育館", "areanamekana" : "", "address" : "青山一丁目57-2" }, { "type" : "避難所", "sort" : "閉鎖", "areaname" : "赤沼公民館", "areanamekana" : "", "address" : "利府町葉山一丁目3-2" } ] }
被害情報(DamageInformation)¶
- 値の形式 : JSONとしてデシリアライズ可能なString
項目名 | <固有名称>key名 | タイプ | |||
---|---|---|---|---|---|
災害名 | disastername | String | |||
人的被害 | humandamage | Array(要素はHash) | 【項目名】 | 【<固有名称>key名】 | 【タイプ】 |
値 | counter | String | |||
単位 | unit | String | |||
種類 | type | String | |||
住家被害 | housedamage | Array(要素はHash) | 【項目名】 | 【<固有名称>key名】 | 【タイプ】 |
値 | counter | String | |||
単位 | unit | String | |||
種類 | type | String | |||
その他 | otherdamage | Array(要素はHash) | 【項目名】 | 【<固有名称>key名】 | 【タイプ】 |
値 | counter | String | |||
単位 | unit | String | |||
種類 | type | String |
disastername:災害名
説明 発表情報の災害名を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_eb:DisasterName) 設定値 情報定義元の値をそのまま設定。 備考 humandamage:人的被害
説明 被害情報の内、人的被害に関する情報群を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_di:HumanDamages) 設定値 後述のパラメータをハッシュ配列で格納。 備考 counter:値
説明 人的被害の値を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_di:HumanDamage) 設定値 情報定義元の値をそのまま設定。 備考 unit:単位
説明 人的被害の単位を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_di:)HumanDamage counterUnit属性 設定値 情報定義元の値をそのまま設定。 備考 "人" 固定 type:種類
説明 人的被害の種類を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_di:HumanDamage humanDamageType属性) 設定値 情報定義元の値をそのまま設定。 備考 情報定義元は、「死者」、「行方不明者数」、「負傷者_重傷」、「負傷者_軽傷」を設定。設定値の詳細は、マルチメディア振興センターのフォーマット仕様書を参照。
housedamage:住家被害
説明 被害情報の内、住家被害に関する情報群を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_di:HouseDamages) 設定値 後述のパラメータをハッシュ配列で格納。 備考 counter:値
説明 住家被害の値を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_di:HouseDamage) 設定値 情報定義元の値をそのまま設定。 備考 unit:単位
説明 住家被害の単位を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_di:HouseDamage:counterUnit) 設定値 情報定義元の値をそのまま設定。 備考 情報定義元は、「棟」、「世帯」、「人」を設定。設定値の詳細は、マルチメディア振興センターのフォーマット仕様書を参照。type:種類
説明 住家被害の種類を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_di:HouseDamage:houseDamageType) 設定値 情報定義元の値をそのまま設定。 備考 情報定義元は、「全壊」、「半壊」、「一部破損」、「床上浸水」、「床下浸水」を設定。設定値の詳細は、マルチメディア振興センターのフォーマット仕様書を参照。
otherdamage:その他
説明 被害情報の内、その他被害の情報群を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_di:OtherDamages) 設定値 後述のパラメータをハッシュ配列で格納。 備考 counter:値
説明 被害の値を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_di:OtherDamage) 設定値 情報定義元の値をそのまま設定。 備考 unit:単位
説明 被害の単位を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_di:OtherDamage:counterUnit) 設定値 情報定義元の値をそのまま設定。 備考 設定値の詳細は、マルチメディア振興センターのフォーマット仕様書を参照。 type:種類
説明 被害の種類を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_di:OtherDamage:otherDamageType) 設定値 情報定義元の値をそのまま設定。 備考 設定値の詳細は、マルチメディア振興センターのフォーマット仕様書を参照。
例(情報を見やすく加工しています)
{ "disastername" : "平成26年9月11日大雨・洪水による被害", "humandamage" : [ { "counter" : "0", "unit" : "人", "type" : "死者" }, { "counter" : "0", "unit" : "人", "type" : "行方不明者数" }, { "counter" : "0", "unit" : "人", "type" : "負傷者_重傷" }, { "counter" : "0", "unit" : "人", "type" : "負傷者_軽傷" } ], "housedamage" : [ { "counter" : "0", "unit" : "棟", "type" : "全壊" }, { "counter" : "0", "unit" : "世帯", "type" : "全壊" }, { "counter" : "0", "unit" : "棟", "type" : "半壊" }, { "counter" : "0", "unit" : "世帯", "type" : "半壊" } ], "otherdamage" : [] }
お知らせ(GeneralInformation)¶
値の形式 : String
説明 お知らせ本文を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_gi:Description) 設定値 情報定義元の値をそのまま設定。 備考 例
◆日時:9月12日午前8時頃 ◆場所:南区唐橋琵琶町の路上 ◆概要:女子中学生が徒歩で登校中、下半身を露出する男を目撃した。その後、男は自転車で逃走した。 ◆男の特徴:年齢40歳位、青色作業着様上下、銀色自転車に乗車 ◎お子さんには、防犯ブザー等の防犯グッズを持たせ、使い方も一緒に確認しましょう。 ◎不審な人物を見かけたら、すぐに110番通報してください。 南警察署 075-682-0110
イベント情報(Event)¶
値の形式 : String
説明 イベントの詳細を設定。 情報定義元 マルチメディア振興センターXML電文(pcx_en:Description) 設定値 情報定義元の値をそのまま設定。 備考 例
9月29日(月曜日)午後6時半、総合教育センター2階の研修室で。 議題は「市まちづくり基本条例の見直しについて」。 定員10人。 傍聴希望者は当日午後6時20分までに直接、会場へ。 希望者多数の場合は抽選。 問い合わせ先 市まちづくり推進課(電話: 072-780-3533)
REST APIで取得できるデータ例(JSON)¶
{ "code": "200", // REST API実行結果コード "message": "success.", // REST API実行結果メッセージ "datalist": [ // REST API取得データ(配列) { "id": "1", // システムで採番されたユニークID "datatypename": "publiccommons1", // データタイプ名(Lアラート(公共情報コモンズ)=publiccommons1) "dataversion": 1, // データバージョン "create_date": "2013-11-18T00:00:00.000+09:00",// システム登録日時 "update_date": "2013-11-18T00:00:00.000+09:00",// システム更新日時 "expire_date": "2013-12-18T00:00:00.000+09:00",// 保持期限日時 // 以下、データタイプ固有パラメータ "docid": "6bffaf56-7af9-4d1a-a268-6195ca3c1de9", // ドキュメントID(UUID) "revision": "1", // リビジョン "lang": "ja", // 言語 "countrycode": "392", // 国名コード "countryname": "Japan", // 国名 "prefcode": "22", // 都道府県コード "prefname": "静岡県", // 都道府県名称 "citycode": "131016", // 市区町村コード "cityname": "下田市", // 市区町村名称 "send_at": "2013-12-18T00:00:00+09:00", // 発表情報送信日時 "status": "Actual", // 運用種別 "category": "EvacuationOrder", // 情報カテゴリ "subject": "下田市:(訓練)H26 熱海市総合防災訓練 避難情報 解除", // タイトル "info_summary": "下田市:(訓練)H26 熱海市総合防災訓練 避難情報 解除", // 本文 "info_detail": "{ "disastername": "(訓練)H26 熱海市総合防災訓練", "values": [{ "sort": "避難指示", "issue_or_lift": "解除", "areanamekana": "", "areaname": "A地区", "datetime": "2013-10-31T10:00:00+09:00" }] }", // 詳細 "info_complement": "", // 補足情報 "incident_desc": "(訓練)H26 熱海市総合防災訓練", // 説明文 }, ] }