竜巻注意情報パラメータ(バージョン1)


パラメータ一覧表

No 項目名 <固有名称>key名 設定値 意味 データ定義元 ユニーク 備考
1 XML電文ID xmlid 【YYYYMMDDHHmmSS】-【XML電文データハッシュ値】 気象庁XML電文ごとに割り振るユニークID アプリケーション独自定義  
YYYYMMDDHHmmSS値は電文発信時刻(send_datetime値(UTC))で算出。
XML電文データは、気象庁から配信されるデータ内の気象バイナリデータ本文(XMLのgzip圧縮データ)を指す。
2 データ種類コード typecode "VPHW50"固定 気象庁XML電文データ種類コード 気象庁    
3 標題 title 【対象地域名称】竜巻注意情報 標題 気象庁   対象地域名称はXML電文が対象とする地域の名称が設定
4 運用種別 controlstatus "通常"、 "訓練"、 "試験" 発表された竜巻注意情報の運用種別 気象庁 複合キー 「18:市町村コード」との組み合わせで一意なレコードとなる
5 運用種別コード controlstatuscode "0"、 "1"、 "2" 運用種別をコード化した情報 アプリケーション独自定義  
0 - 通常
1 - 訓練
2 - 試験
6 編集官署名 editorial_office 任意 実際に発表作業を行った官署名 気象庁    
7 発表官署名 publishing_office 任意 業務的に発表した官署名 気象庁    
8 識別情報 eventid "" 識別情報 気象庁   常に空文字
9 情報番号 serial 1~ 情報の発表番号 気象庁  
竜巻注意情報の発表内容の有効時間(1時間)内に
続報発表があった場合に値を加算
10 見出し文 headline 任意 見出し文 気象庁    
11 発信時刻 send_datetime
ISO8601形式
(例:YYYY-MM-DDTHH:mm:SSZ(UTC表記))
発信時刻 気象庁    
12 発表時刻 report_datetime
ISO8601形式
(例:YYYY-MM-DDTHH:mm:00+09:00(JST表記))
発表時刻 気象庁   時刻は分単位で刻み、秒は常に00が設定
13 基点時刻 target_datetime
ISO8601形式
(例:YYYY-MM-DDTHH:mm:00+09:00(JST表記))
基点時刻 気象庁   時刻は分単位で刻み、秒は常に00が設定
14 失効時刻 valid_datetime
ISO8601形式
(例:YYYY-MM-DDTHH:mm:00+09:00(JST表記))
失効時刻 気象庁   時刻は分単位で刻み、秒は常に00が設定
15 都道府県名称 prefname 【都道府県名称】 または "不明" 竜巻注意情報発令対象の都道府県名称 アプリケーション独自定義  
prefcode値から都道府県名称を取得
都道府県が判別できない場合は「不明」を設定
16 都道府県コード prefcode "01" ~ "47" 竜巻注意情報発令対象の都道府県コード(全国地方公共団体コード) アプリケーション独自定義    
17 市町村名称 cityname 任意 竜巻注意情報発令対象の市町村名称 気象庁    
18 市町村コード citycode 任意 竜巻注意情報発令対象の市町村コード 気象庁 複合キー  
19 情報名 infoname "竜巻注意情報"、 "なし" 情報名 気象庁    
20 情報コード infocode "1"、 "0" 情報名をコード化した情報 気象庁  
1 - 竜巻注意情報
0 - なし
21 発表状況 status "発表"、 "なし" 発表状況 気象庁    
22 発表状況コード statuscode "1"、"0" 発表状況をコード化した情報 気象庁  
1 - 発表
0 - なし
23 発信官署コード officecode 任意 発信官署コード 気象庁    

パラメータ詳細

  • xmlid:XML電文ID

    説明 気象庁配信電文(XML)ごとのユニークな値を設定。
    情報定義元 気象庁XML電文データを基にアプリケーションで独自定義
    設定値 気象庁のXML電文の発信時刻(send_datetime値)とXML電文のハッシュ値(SHA256)を利用し、【YYYYMMDDHHmmSS】+【XML電文ハッシュ値】を設定。
    備考
    XML電文の発信時刻(send_datetime値)はUTC表記。
    同一気象庁XML電文で登録された情報を取得する際などの利用を想定。
  • typecode:データ種類コード

    説明 XML電文のデータ種類コードを設定。
    情報定義元 気象庁通知電文ヘッダ: XML電文のデータ種類コード値部
    設定値 "VPHW50" 固定
    備考 "VPHW50"は竜巻注意情報を示す。
  • title:標題

    説明 情報の標題を設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Head><Title>タグ
    設定値 情報定義元の値をそのまま設定。
    備考 基となる気象庁XML電文が対象とする地域の名称に続き、”竜巻注意情報”が付加された値を設定。
  • controlstatus:運用種別

    説明 発表された竜巻注意情報の運用種別を設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Control><Status>タグ
    設定値
    情報定義元の値をそのまま設定。
    情報定義元は、「通常」、「訓練」、「試験」のいずれかが設定。
    備考
    通常報について
    - 気象庁が竜巻・突風に対する注意を呼びかける際に発表する竜巻注意情報が元の情報の場合、controlstatusを「通常」で設定します。
    訓練報について
    - 気象庁が不定期で訓練報を通知することがあり、この場合controlstatusを「訓練」で設定します。
    - 訓練報の扱いは、利用者毎の定義となります。
    試験報について
    - 気象庁が不定期で試験報を通知することがあり、この場合controlstatusを「試験」で設定します。
    - 試験報の扱いは、利用者毎の定義となります。
  • controlstatuscode:運用種別コード

    説明 controlstatusをコード化した文字列を設定。
    情報定義元 気象庁XML電文データを基にアプリケーションで独自定義
    設定値 controlstatus値により下表の条件で設定。
    備考  
    運用種別: controlstatus 運用種別コード: controlstatuscode
    通常 0
    訓練 1
    試験 2
  • editorial_office:編集官署名

    説明 実際に発表作業を行った官署名を設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Control><EditorialOffice>タグ
    設定値 情報定義元の値をそのまま設定。
    備考  
  • publishing_office:発表官署名

    説明 業務的に発表した官署名を設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Control><PublishingOffice>タグ
    設定値 情報定義元の値をそのまま設定。
    備考  
  • eventid:識別情報

    説明 識別情報を設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Head><EventID>タグ
    設定値 情報定義元の値をそのまま設定。
    備考 常に空文字
  • serial:情報番号

    説明 情報の発表番号を設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Head><Serial>タグ
    設定値 情報定義元の値をそのまま設定。
    備考
    竜巻注意情報の新規発表の場合は「1」となる。
    竜巻注意情報の発表内容の有効時間(1時間)内に続報発表があった場合に値を加算。
  • headline:見出し文

    説明 警戒文を設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Head><Headline><Text>タグ
    設定値 情報定義元の値をそのまま設定。
    備考  
  • send_datetime:発信時刻

    説明 気象庁システムからの発信時刻を設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Control><DateTime>タグ
    設定値 情報定義元の値をそのまま設定。
    備考 UTC表記のDateTime型(ISO8601形式(YYYY-MM-DDTHH:mm:SS+09:00))で表記。
  • report_datetime:発表時刻

    説明 発表官署が竜巻注意情報を発表した時刻を設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Head><ReportDateTime>タグ
    設定値 情報定義元の値をそのまま設定。
    備考
    JST表記のDateTime型(ISO8601形式(YYYY-MM-DDTHH:mm:SS+09:00))で表記。
    時刻は分単位で、秒は常に"00"
  • target_datetime:基点時刻

    説明 基点時刻を設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Head><TargetDateTime>タグ
    設定値 情報定義元の値をそのまま設定。
    備考 UTC表記のDateTime型(ISO8601形式(YYYY-MM-DDTHH:mm:SS+09:00))で表記。
  • valid_datetime:失効時刻

    説明 竜巻注意情報の失効時刻を設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Head><ValidDateTime>タグ
    設定値 情報定義元の値をそのまま設定。
    備考
    JST表記のDateTime型(ISO8601形式(YYYY-MM-DDTHH:mm:SS+09:00))で表記。
    時刻は分単位で、秒は常に"00"
  • prefname:都道府県名称

    説明 竜巻注意情報の対象となる都道府県名称を設定。
    情報定義元 気象庁XML電文データを基にアプリケーションで独自定義
    設定値 【都道府県名称】または "不明"
    備考
    prefcode値から都道府県名称を取得する。
    都道府県が判別できない場合は「不明」を設定する。
  • prefcode:都道府県コード

    説明 竜巻注意情報の対象となる都道府県コードを設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Head><Headline><Information type="竜巻注意情報(発表細分")><Item><Areas codeType="気象情報/府県予報区・細分区域等"><Area><Code>タグ
    設定値 情報定義元値の先頭2桁("01" ~ "47")
    備考 総務省定義の全国地方公共団体コード に準ずる。
  • citycode:市町村コード

    説明 竜巻注意情報の対象となる市町村コードを設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Body><Warning type="竜巻注意情報(市町村等)"><Item><Area><Code>タグ
    設定値 情報定義元の値をそのまま設定。
    備考
    上記サイトのコード管理表及び個別コード表の『個別コード表[zip形式]』内の、「YYYYMMDD_AreaInformationCity-AreaForecastLocalM.xls」のAreaInformationCityシートA列の定義を参照。
    総務省で定義された「全国地方公共団体コード」の市町村コードではありません。
  • cityname:市町村名称

    説明 竜巻注意情報の対象となる市町村名称を設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Body><Warning type="竜巻注意情報(市町村等)"><Item><Area><Name>タグ
    設定値 情報定義元の値をそのまま設定。
    備考
    上記サイトのコード管理表及び個別コード表の『個別コード表[zip形式]』内の、「YYYYMMDD_AreaInformationCity-AreaForecastLocalM.xls」のAreaInformationCityシートC列の定義を参照。
  • infoname:情報名

    説明 竜巻注意情報の情報名を設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Body><Warning type="竜巻注意情報(市町村等)"><Item><Kind><Name>タグ
    設定値 情報定義元の値をそのまま設定。
    備考  
  • infocode:情報コード

    説明 竜巻注意情報の情報名をコード化した値を設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Body><Warning type="竜巻注意情報(市町村等)"><Item><Kind><Code>タグ
    設定値 情報定義元の値をそのまま設定。
    備考  
    情報名
    (infoname)
    情報名コード
    (infocode)
    "竜巻注意情報" 1
    "なし" 0
  • status:発表状況

    説明 竜巻注意情報の発表状況を設定。
    情報定義元 気象庁XML電文(竜巻注意情報)内:<Report><Body><Warning type="竜巻注意情報(市町村等)"><Item><Kind><Status>タグ
    設定値 情報定義元の値をそのまま設定。
    備考  
  • statuscode:発表状況コード

    説明 竜巻注意情報の発表状況をコード化した値を設定。
    情報定義元 気象庁XML電文データを基にアプリケーションで独自定義
    設定値 発表状況(status)により、以下の条件で設定。
    備考  
    発表状況
    (status)
    発表状況コード
    (statuscode)
    "発表" 1
    "なし" 0
  • officecode:発信官署コード

    説明 電文の発信を行った官署コード値を設定。
    情報定義元 気象庁通知電文ヘッダ: 発信官署コード値部
    設定値 情報定義元の値をそのまま設定。
    備考
    上記サイトの『気象庁防災情報XML形式の電文配信に用いるデータ種類コードについて』の別紙2の定義を参照。

REST APIで取得できるデータ例(JSON)

"code": "200",                                   // REST API実行結果コード
"message": "success.",                           // REST API実行結果メッセージ
"datalist": [                                    // REST API取得データ(配列)
  {
    "id" : "217613",                                      // システムで採番されたユニークID
    "datatypename" : "jmatornado",                        // データタイプ名(竜巻注意情報=jmatornado)
    "dataversion" : 1,                                    // データバージョン
    "create_date" : "2014-09-10T01:35:30.592207+09:00",   // システム登録日時
    "update_date" : "2014-09-12T14:40:32.154656+09:00",   // システム更新日時
    "expire_date" : "",                                   // 保存期限日時
    // 以下、データタイプ固有パラメータ
    "xmlid" : "20150213064200-a2add0042c71449f009a649faf0f0d8a85b400d7f1c43d28099825bd198ff4e5",
                                                          // XMLID
    "typecode" : "VPHW50",                                // データ種類コード
    "title" : "神奈川県竜巻注意情報",                     // 標題
    "controlstatus" : "通常",                             // 運用種別
    "controlstatuscode" : "0",                            // 運用種別コード
    "editorial_office" : "横浜地方気象台",                // 編集官署名
    "publishing_office" : "横浜地方気象台",               // 発表官署名
    "officecode" : "JPTF",                                // 発信官署コード
    "eventid" : "",                                       // 識別情報
    "serial" : "1",                                       // 識別番号

    "headline" : "【目撃情報あり】神奈川県西部で竜巻などの激しい突風が発生したとみられます。神奈川県は、竜巻などの激しい突風が発生するおそれが非常に高まっています。空の様子に注意してください。雷や急な風の変化など積乱雲が近づく兆しがある場合には、頑丈な建物内に移動するなど、安全確保に努めてください。落雷、ひょう、急な強い雨にも注意してください。",
                                                          // 見出し文
    "send_datetime" : "2015-02-13T06:42:00Z",             // 発信時刻
    "report_datetime" : "2015-02-13T15:42:00+09:00",      // 発表時刻
    "target_datetime" : "2015-02-13T15:42:00+09:00",      // 基点時刻
    "valid_datetime" : "2015-02-13T15:50:00+09:00",       // 失効時刻
    "prefname" : "神奈川県",                              // 対象都道府県名称
    "prefcode" : "14",                                    // 対象都道府県コード
    "cityname" : "清川村",                                // 対象市町村名称
    "citycode" : "1440200",                               // 対象市町村コード
    "infoname" : "竜巻注意情報",                          // 情報名
    "infocode" : "1",                                     // 情報コード
    "status" : "発表",                                    // 発表状況
    "statuscode" : "1",                                   // 発表状況コード
  },
  {
    "id" : "217613",                                      // システムで採番されたユニークID
    "datatypename" : "jmatornado",                        // データタイプ名(竜巻注意情報=jmatornado)
    "dataversion" : 1,                                    // データバージョン
    "create_date" : "2014-09-10T01:35:30.592207+09:00",   // システム登録日時
    "update_date" : "2014-09-12T14:40:32.154656+09:00",   // システム更新日時
    "expire_date" : "",                                   // 保存期限日時
    // 以下、データタイプ固有パラメータ
    "xmlid" : "20150213064200-a2add0042c71449f009a649faf0f0d8a85b400d7f1c43d28099825bd198ff4e5",
                                                          // XMLID
    "typecode" : "VPHW50",                                // データ種類コード
    "title" : "神奈川県竜巻注意情報",                     // 標題
    "controlstatus" : "通常",                             // 運用種別
    "controlstatuscode" : "0",                            // 運用種別コード
    "editorial_office" : "横浜地方気象台",                // 編集官署名
    "publishing_office" : "横浜地方気象台",               // 発表官署名
    "officecode" : "JPTF",                                // 発信官署コード
    "eventid" : "",                                       // 識別情報
    "serial" : "1",                                       // 識別番号

    "headline" : "【目撃情報あり】神奈川県西部で竜巻などの激しい突風が発生したとみられます。神奈川県は、竜巻などの激しい突風が発生するおそれが非常に高まっています。空の様子に注意してください。雷や急な風の変化など積乱雲が近づく兆しがある場合には、頑丈な建物内に移動するなど、安全確保に努めてください。落雷、ひょう、急な強い雨にも注意してください。",
                                                          // 見出し文
    "send_datetime" : "2015-02-13T06:42:00Z",             // 発信時刻
    "report_datetime" : "2015-02-13T15:42:00+09:00",      // 発表時刻
    "target_datetime" : "2015-02-13T15:42:00+09:00",      // 基点時刻
    "valid_datetime" : "2015-02-13T15:50:00+09:00",       // 失効時刻
    "prefname" : "神奈川県",                              // 対象都道府県名称
    "prefcode" : "14",                                    // 対象都道府県コード
    "cityname" : "愛川町",                                // 対象市町村名称
    "citycode" : "1440100",                               // 対象市町村コード
    "infoname" : "竜巻注意情報",                          // 情報名
    "infocode" : "1",                                     // 情報コード
    "status" : "発表",                                    // 発表状況
    "statuscode" : "1",                                   // 発表状況コード
  },
  (略)
]