気象特別警報・警報・注意報パラメータ(バージョン1)¶
パラメータ一覧表¶
| No | 項目名 | <固有名称>key名 | 設定値 | 意味 | データ定義元 | ユニーク | 備考 |
|---|---|---|---|---|---|---|---|
|
XML電文ID | xmlid | 【YYYYMMDDHHmmSS】-【XML電文データハッシュ値】 | 気象庁XML電文ごとに割り振るユニークID | アプリケーション独自定義 | YYYYMMDDHHmmSS値は電文発信時刻(send_datetime値(UTC))で算出。
XML電文データは、気象庁から配信されるデータ内の気象バイナリデータ本文(XMLのgzip圧縮データ)を指す。
|
|
|
データ種類コード | typecode | "VPWW53"固定 | 気象庁XML電文データ種類コード | 気象庁 | VPWW53は気象特別警報・警報・注意報を示す | |
|
運用種別 | controlstatus | "通常"、 "訓練"、 "試験" | 発表された気象情報の運用種別 | 気象庁 | ||
|
運用種別コード | controlstatuscode | "0"、 "1"、 "2" | 運用種別をコード化した情報 | アプリケーション独自定義 | 複合キー | 0 - 通常
1 - 訓練
2 - 試験
「11:市町村コード」と「13:気象カテゴリーコード」との組み合わせで一意なレコードとなる。
|
|
標題 | title | 【対象地域名称】気象警報・注意報 | 標題 | 気象庁 | 対象地域名称はXML電文が対象とする地域の名称が設定 | |
|
見出し文 | headline | XML電文記載値 | 見出し文 | 気象庁 | ||
|
地域コード | areacode | 気象庁定義値 | 気象情報発令対象の都道府県地域コード | 気象庁 | コード定義は パラメータ詳細 を参照
北海道・鹿児島県・沖縄県のみ市町村の地域により異なるコードが設定
|
|
|
地域名称 | areaname | 気象庁定義値 | 気象情報発令対象の都道府県地域名称 | 気象庁 | 名称定義は パラメータ詳細 を参照
北海道・鹿児島県・沖縄県のみ市町村の地域により異なる名称が設定
|
|
|
都道府県コード | prefcode | "01" ～ "47" | 気象情報発令対象の都道府県コード(全国地方公共団体コード) | アプリケーション独自定義 | 総務省定義の「全国地方公共団体コード」 に準ずる
areacode値の先頭2桁を設定
|
|
|
都道府県名称 | prefname | 【都道府県名称】 または "不明" | 気象情報発令対象の都道府県名称 | アプリケーション独自定義 | prefcode値から都道府県名称を取得
都道府県が判別できない場合は「不明」を設定
|
|
|
市町村コード | citycode | 気象庁定義値 | 気象情報発令対象の市町村コード | 気象庁 | 複合キー | コード定義は パラメータ詳細 を参照
「4:運用種別コード」と「13:気象カテゴリーコード」との組み合わせで一意なレコードとなる。
|
|
市町村名称 | cityname | 気象庁定義値 | 気象情報発令対象の市町村名称 | 気象庁 | 名称定義は パラメータ詳細 を参照 | |
|
気象カテゴリーコード | categorycode | "0001"、 "0002"、 "0003"、 "0004"、 "0005"、 "0006"、 "0007"、 "0008"、 "0009"、 "0010"、 "0011"、 "0012"、 "0013"、 "0014"、 "0015"、 "0016"、 "0017"、 "9999" | 気象特別警報・警報・注意報を項目に分け、コード化した情報 | アプリケーション独自定義 | 複合キー | 0001 - 大雨(大雨注意報・大雨警報・大雨特別警報)
0002 - 大雪(大雪注意報・大雪警報・大雪特別警報)
0003 - 風雪(風雪注意報・風雪警報・暴風雪特別警報)
0004 - 風(強風注意報・暴風警報・暴風特別警報)
0005 - 波浪(波浪注意報・波浪警報・波浪特別警報)
0006 - 高潮(高潮注意報・高潮警報・高潮特別警報)
0007 - 洪水(洪水注意報・洪水警報)
0008 - 雷(雷注意報)
0009 - 融雪(融雪注意報)
0010 - 濃霧(濃霧注意報)
0011 - 乾燥(乾燥注意報)
0012 - なだれ(なだれ注意報)
0013 - 低温(低温注意報)
0014 - 霜(霜注意報)
0015 - 着氷(着氷注意報)
0016 - 着雪(着雪注意報)
0017 - その他(その他の注意報)
9999 - 不明
「4:運用種別コード」と「11:市町村コード」との組み合わせで一意なレコードとなる。
|
|
気象カテゴリー名称 | categoryname | "大雨"、 "大雪"、 "風雪"、 "風"、 "波浪"、 "高潮"、 "洪水"、 "雷"、 "融雪"、 "濃霧"、 "乾燥"、 "なだれ"、 "低温"、 "霜"、 "着氷"、 "着雪"、 "その他"、 "不明" | 気象特別警報・警報・注意報の項目名 | アプリケーション独自定義 | ||
|
報種別コード | reportcode | "02"、 "03"、 "04"、 "05"、 "06"、 "07"、 "08"、 "10"、 "12"、 "13"、 "14"、 "15"、 "16"、 "17"、 "18"、 "19"、 "20"、 "21"、 "22"、 "23"、 "24"、 "25"、 "26"、 "27"、 "32"、 "33"、 "35"、 "36"、 "37"、 "38" | 気象特別警報・警報・注意報のコード値 | 気象庁 | コード定義元は パラメータ詳細 を参照
02 - 暴風雪警報
03 - 大雨警報
04 - 洪水警報
05 - 暴風警報
06 - 大雪警報
07 - 波浪警報
08 - 高潮警報
10 - 大雨注意報
12 - 大雪注意報
13 - 風雪注意報
14 - 雷注意報
15 - 強風注意報
16 - 波浪注意報
17 - 融雪注意報
18 - 洪水注意報
19 - 高潮注意報
20 - 濃霧注意報
21 - 乾燥注意報
22 - なだれ注意報
23 - 低温注意報
24 - 霜注意報
25 - 着氷注意報
26 - 着雪注意報
27 - その他の注意報
32 - 暴風雪特別警報
33 - 大雨特別警報
35 - 暴風特別警報
36 - 大雪特別警報
37 - 波浪特別警報
38 - 高潮特別警報
|
|
|
報種別名称 | reportname | "暴風雪警報"、 "大雨警報"、 "洪水警報"、
"暴風警報"、 "大雪警報"、 "波浪警報"、
"高潮警報"、 "大雨注意報"、 "大雪注意報"、
"風雪注意報"、 "雷注意報"、 "強風注意報"、
"波浪注意報"、 "融雪注意報"、 "洪水注意報"、
"高潮注意報"、 "濃霧注意報"、 "乾燥注意報"、
"なだれ注意報"、 "低温注意報"、 "霜注意報"、
"着氷注意報"、 "着雪注意報"、 "その他の注意報"、
"暴風雪特別警報"、 "大雨特別警報"、 "暴風特別警報"、
"大雪特別警報"、 "波浪特別警報"、 "高潮特別警報"
|
気象特別警報・警報・注意報の名称 | 気象庁 | 名称定義元は パラメータ詳細 を参照 | |
|
警報区分 | warninglevel | "1"、 "2"、 "3" | 気象特別警報・警報・注意報の区分をコード化した情報 | アプリケーション独自定義 | 1 - 注意報系
2 - 警報系
3 - 特別警報系
|
|
|
発表形態 | status | "発表"、 "継続”、 "解除"、 "特別警報から警報”、 "特別警報から注意報”、 "警報から注意報” | 発表形態(前回電文からの遷移状態) | 気象庁 | ||
|
発表形態コード | statuscode | "1"、 "2"、 "3"、 "4"、 "5"、 "6" | 発表形態をコード化した情報 | アプリケーション独自定義 | 1 - 発表
2 - 継続
3 - 解除
4 - 特別警報から警報
5 - 特別警報から注意報
6 - 警報から注意報
|
|
|
発令状態コード | announcecode | "0"、 "1" | 気象情報の発令状態をコード化した情報 | アプリケーション独自定義 | 0 - 解除/なし
1 - 発令中
|
|
|
状況 | condition | "土砂災害"、 "浸水害"、 "土砂災害、浸水害"、または空文字 | 当該報に関する状況 | 気象庁 | 大雨特別警報・大雨警報以外は常に空文字 | |
|
特記事項 | attention | XML電文記載値 | 当該報に関する特記事項 | 気象庁 | 特記事項が複数存在する場合、「,」区切りで値を設定 | |
|
付加事項 | addition | XML電文記載値 | 当該報に関する付加事項 | 気象庁 | 付加事項が複数存在する場合、「,」区切りで値を設定 | |
|
発信時刻 | send_datetime | ISO8601形式(例:YYYY-MM-DDTHH:mm:SSZ(UTC表記)) | 発信時刻 | 気象庁 | ||
|
発表時刻 | report_datetime | ISO8601形式(例:YYYY-MM-DDTHH:mm:00+09:00(JST表記)) | 発表時刻 | 気象庁 | 時刻は分単位で刻み、秒は常に00が設定 | |
|
編集官署名 | editorial_office | XML電文記載値 | 実際に発表作業を行った官署名 | 気象庁 | ||
|
発表官署名 | publishing_office | XML電文記載値 | 業務的に発表した官署名 | 気象庁 | ||
|
発信官署コード | officecode | XML電文記載値 | 発信官署コード | 気象庁 | コード定義は パラメータ詳細 を参照 |
パラメータ詳細¶
説明 気象庁配信電文(XML)ごとのユニークな値を設定。 情報定義元 気象庁XML電文データを基にアプリケーションで独自定義 設定値 気象庁のXML電文の発信時刻(send_datetime値)とXML電文のハッシュ値(SHA256)を利用し、【YYYYMMDDHHmmSS】+【XML電文ハッシュ値】を設定。 備考
説明 XML電文のデータ種類コードを設定。 情報定義元 気象庁通知電文ヘッダ: XML電文のデータ種類コード値部 設定値 "VPWW53" 固定 備考 "VPWW53"は気象特別警報・警報・注意報を示す。
説明 発表された気象情報の運用種別を設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Control><Status>タグ 設定値 備考
説明 controlstatusをコード化した文字列を設定。 情報定義元 気象庁XML電文データを基にアプリケーションで独自定義 設定値 controlstatus値により下表の条件で設定。 備考
運用種別: controlstatus 運用種別コード: controlstatuscode 通常 0 訓練 1 試験 2
説明 情報の標題を設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Head><Title>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 見出し文を自由文形式で設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Head><Headline><Text>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 気象特別警報・警報・注意報の対象となる府県予報区コードを設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Head><Headline><Information type="気象警報・注意報（府県予報区等）"><Item><Areas><Area><Code>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 気象特別警報・警報・注意報の対象となる府県予報区名称を設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Head><Headline><Information type="気象警報・注意報（府県予報区等）"><Item><Areas><Area><Name>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 気象特別警報・警報・注意報の対象となる都道府県コードを設定。 情報定義元 気象庁XML電文データを基にアプリケーションで独自定義 設定値 "01" ～ "47" 備考
説明 気象特別警報・警報・注意報の対象となる都道府県名称を設定。 情報定義元 気象庁XML電文データを基にアプリケーションで独自定義 設定値 【都道府県名称】または "不明" 備考
説明 気象特別警報・警報・注意報の対象となる市町村コードを設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Body><Warning type="気象警報・注意報（市町村等）"><Item><Area><Code>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 気象特別警報・警報・注意報の対象となる市町村名称を設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Body><Warning type="気象警報・注意報（市町村等）"><Item><Area><Name>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 気象特別警報・警報・注意報を系統ごとに項目化したコードを設定。 情報定義元 気象庁XML電文データを基にアプリケーションで独自定義 設定値 報種別コード(reportcode)の値を基に、下表の通りに設定。 備考
説明 気象特別警報・警報・注意報を系統ごとに項目化した名称を設定。 情報定義元 気象庁XML電文データを基にアプリケーションで独自定義 設定値 報種別コード(reportcode)の値を基に、下表の通りに設定。 備考
気象カテゴリー名称/気象カテゴリーコード表
気象カテゴリー名称: categoryname 気象カテゴリーコード: categorycode 対象報種別名称: reportname 備考 大雨 0001 大雨注意報・大雨警報・大雨特別警報 大雪 0002 大雪注意報・大雪警報・大雪特別警報 風雪 0003 風雪注意報・風雪警報・暴風雪特別警報 風 0004 強風注意報・暴風警報・暴風特別警報 波浪 0005 波浪注意報・波浪警報・波浪特別警報 高潮 0006 高潮注意報・高潮警報・高潮特別警報 洪水 0007 洪水注意報・洪水警報 雷 0008 雷注意報 融雪 0009 融雪注意報 濃霧 0010 濃霧注意報 乾燥 0011 乾燥注意報 なだれ 0012 なだれ注意報 低温 0013 低温注意報 霜 0014 霜注意報 着氷 0015 着氷注意報 着雪 0016 着雪注意報 その他 0017 その他の注意報 不明 9999 対象なし 未定義のreportcode値を受信した場合に設定。
説明 気象特別警報・警報・注意報の種別コードを設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Body><Warning type="気象警報・注意報（市町村等）"><Item><Kind><Code>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 気象特別警報・警報・注意報の種別名称を設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Body><Warning type="気象警報・注意報（市町村等）"><Item><Kind><Name>タグ 設定値 情報定義元の値をそのまま設定。 備考
報種別コード/報種別名称表
報種別コード: reportcode 報種別名称: reportname 02 暴風雪警報 03 大雨警報 04 洪水警報 05 暴風警報 06 大雪警報 07 波浪警報 08 高潮警報 10 大雨注意報 12 大雪注意報 13 風雪注意報 14 雷注意報 15 強風注意報 16 波浪注意報 17 融雪注意報 18 洪水注意報 19 高潮注意報 20 濃霧注意報 21 乾燥注意報 22 なだれ注意報 23 低温注意報 24 霜注意報 25 着氷注意報 26 着雪注意報 27 その他の注意報 32 暴風雪特別警報 33 大雨特別警報 35 暴風特別警報 36 大雪特別警報 37 波浪特別警報 38 高潮特別警報
説明 気象特別警報・警報・注意報をコード化した値を設定。 情報定義元 気象庁XML電文データを基にアプリケーションで独自定義 設定値 備考
説明 気象特別警報・警報・注意報の発表形態を設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Body><Warning type="気象警報・注意報（市町村等）"><Item><Kind><Status>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 気象特別警報・警報・注意報の発表形態をコード化した値を設定。 情報定義元 気象庁XML電文データを基にアプリケーションで独自定義 設定値 備考
説明 気象特別警報・警報・注意報の発令状態をコード化した文字列を設定。 情報定義元 気象庁XML電文データを基にアプリケーションで独自定義 設定値 備考
発表形態/発表形態コード/発令状態コード表
発表形態: status 発表形態コード: statuscode 発令状態: announcecode 発表 1 1 継続 2 1 解除 3 0 特別警報から警報 4 1 特別警報から注意報 5 1 警報から注意報 6 1
説明 当該気象特別警報・警報・注意報の状況を設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Body><Warning type="気象警報・注意報（市町村等）"><Item><Kind><Condition>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 当該気象特別警報・警報・注意報に関する特記事項を設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Body><Warning type="気象警報・注意報（市町村等）"><Item><Kind><Attention><Note>タグ 設定値 備考
説明 当該気象特別警報・警報・注意報に関する付加事項を設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Body><Warning type="気象警報・注意報（市町村等）"><Item><Kind><Addition><Note>タグ 設定値 備考
説明 気象庁システムからの発信時刻を設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Control><DateTime>タグ 設定値 情報定義元の値をそのまま設定。 備考 UTC表記のDateTime型(ISO8601形式(YYYY-MM-DDTHH:mm:SS+09:00))で表記。
説明 発表官署が気象特別警報・警報・注意報を発表した時刻を設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Head><ReportDateTime>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 実際に発表作業を行った官署名を設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Control><EditorialOffice>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 業務的に発表した官署名を設定。 情報定義元 気象庁XML電文(気象特別警報・警報・注意報)内：<Report><Control><PublishingOffice>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 電文の発信を行った官署コード値を設定。 情報定義元 気象庁通知電文ヘッダ: 発信官署コード値部 設定値 情報定義元の値をそのまま設定。 備考
REST APIで取得できるデータ例(JSON)¶
"code": "200", // REST API実行結果コード "message": "success.", // REST API実行結果メッセージ "datalist": [ // REST API取得データ(配列) { "id" : "111111", // システムで採番されたユニークID "datatypename" : "jmaweather", // データタイプ名(気象情報=jmaweather) "dataversion" : 1, // データバージョン "create_date" : "2014-08-30T05:38:23.198548+09:00", // システム登録日時 "update_date" : "2014-09-22T16:13:51.545447+09:00", // システム更新日時 "expire_date" : "", // 保存期限日時 "// 以下、データタイプ固有パラメータ "xmlid" : "20140922071344-9b5b29c1985769b3cb15d0f465bcb4439b9684d156d19baf4d2f8737ee165081", // XMLID "typecode" : "VPWW53", // データ種類コード "controlstatus" : "通常", // 運用種別 "controlstatuscode" : "0", // 運用種別コード "title" : "渡島・檜山地方気象警報・注意報", // 表題 "headline" : "渡島、檜山地方では、２２日夜のはじめ頃まで竜巻などの激しい突風や急な強い雨、落雷に、２２日夜遅くから２３日昼前まで濃霧による視程障害に注意してください。", // 見出し文 "areacode" : "017010", // 対象地域コード "areaname" : "渡島地方", // 対象地域名称 "prefcode" : "01", // 対象都道府県コード "prefname" : "北海道", // 対象都道府県名称 "citycode" : "0120200", // 対象市町村コード "cityname" : "函館市", // 対象市町村名称 "categorycode" : "0008", // 気象カテゴリーコード "categoryname" : "雷", // 気象カテゴリー名称 "reportcode" : "14", // 報種別コード "reportname" : "雷注意報", // 報種別名称 "warninglevel" : "1", // 警報区分 "status" : "継続", // 発表形態 "statuscode" : "2", // 発表形態コード "announcecode" : "1", // 発令状態コード "condition" : "", // 状況 "attention" : "", // 特記事項 "addition" : "竜巻,ひょう", // 付加事項 "send_datetime" : "2014-09-22T07:13:44Z", // 発信時刻 "report_datetime" : "2014-09-22T16:13:00+09:00", // 発表時刻 "editorial_office" : "函館地方気象台", // 編集官署名 "publishing_office" : "函館地方気象台", // 発表官署名 "officecode" : "JPSF" // 発信官署コード }, { "id" : "222222", // システムで採番されたユニークID "datatypename" : "jmaweather", // データタイプ名(気象情報=jmaweather) "dataversion" : 1, // データバージョン "create_date" : "2014-08-30T05:38:23.198548+09:00", // システム登録日時 "update_date" : "2014-09-22T16:13:51.545447+09:00", // システム更新日時 "expire_date" : "", // 保存期限日時 "// 以下、データタイプ固有パラメータ "xmlid" : "20140922071344-9b5b29c1985769b3cb15d0f465bcb4439b9684d156d19baf4d2f8737ee165081", // XMLID "typecode" : "VPWW53", // データ種類コード "controlstatus" : "通常", // 運用種別 "controlstatuscode" : "0", // 運用種別コード "title" : "渡島・檜山地方気象警報・注意報", // 表題 "headline" : "渡島、檜山地方では、２２日夜のはじめ頃まで竜巻などの激しい突風や急な強い雨、落雷に、２２日夜遅くから２３日昼前まで濃霧による視程障害に注意してください。", // 見出し文 "areacode" : "017020", // 対象地域コード "areaname" : "檜山地方", // 対象地域名称 "prefcode" : "01", // 対象都道府県コード "prefname" : "北海道", // 対象都道府県名称 "citycode" : "0137100", // 対象市町村コード "cityname" : "せたな町", // 対象市町村名称 "categorycode" : "0008", // 気象カテゴリーコード "categoryname" : "雷", // 気象カテゴリー名称 "reportcode" : "14", // 報種別コード "reportname" : "雷注意報", // 報種別名称 "warninglevel" : "1", // 警報区分 "status" : "継続", // 発表形態 "statuscode" : "2", // 発表形態コード "announcecode" : "1", // 発令状態コード "condition" : "", // 状況 "addition" : "竜巻,ひょう", // 特記事項 "attention" : "", // 付加事項 "send_datetime" : "2014-09-22T07:13:44Z", // 発信時刻 "report_datetime" : "2014-09-22T16:13:00+09:00", // 発表時刻 "editorial_office" : "函館地方気象台", // 編集官署名 "publishing_office" : "函館地方気象台", // 発表官署名 "officecode" : "JPSF" // 発信官署コード }, (略) ]