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

目次

パラメータ一覧表
パラメータ詳細
REST APIで取得できるデータ例(JSON)

パラメータ一覧表 ¶

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	"通常"、 "訓練"、 "試験"	発表された竜巻注意情報の運用種別	気象庁
5	運用種別コード	controlstatuscode	"0"、 "1"、 "2"	運用種別をコード化した情報	アプリケーション独自定義	複合キー	0 - 通常 1 - 訓練 2 - 試験「18:市町村コード」との組み合わせで一意なレコードとなる
6	編集官署名	editorial_office	XML電文記載値	実際に発表作業を行った官署名	気象庁
7	発表官署名	publishing_office	XML電文記載値	業務的に発表した官署名	気象庁
8	識別情報	eventid	""	識別情報	気象庁		常に空文字
9	情報番号	serial	1～	情報の発表番号	気象庁		竜巻注意情報の発表内容の有効時間（1時間）内に続報発表があった場合に値を加算
10	見出し文	headline	XML電文記載値	見出し文	気象庁
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"	竜巻注意情報発令対象の都道府県コード(全国地方公共団体コード)	アプリケーション独自定義		総務省定義の「全国地方公共団体コード」に準ずる areacode値の先頭2桁を設定
17	市町村名称	cityname	XML電文記載値	竜巻注意情報発令対象の市町村名称	気象庁		名称定義はパラメータ詳細を参照
18	市町村コード	citycode	XML電文記載値	竜巻注意情報発令対象の市町村コード	気象庁	複合キー	コード定義はパラメータ詳細を参照「5:運用種別コード」との組み合わせで一意なレコードとなる
19	情報名	infoname	"竜巻注意情報"、 "なし"	情報名	気象庁
20	情報コード	infocode	"1"、 "0"	情報名をコード化した情報	気象庁		1 - 竜巻注意情報 0 - なし
21	発表状況	status	"発表"、 "なし"	発表状況	気象庁
22	発表状況コード	statuscode	"1"、"0"	発表状況をコード化した情報	気象庁		1 - 発表 0 - なし
23	発信官署コード	officecode	XML電文記載値	発信官署コード	気象庁		コード定義はパラメータ詳細を参照

パラメータ詳細 ¶

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")

備考総務省定義の全国地方公共団体コードに準ずる。

cityname:市町村名称

説明竜巻注意情報の対象となる市町村名称を設定。

情報定義元気象庁XML電文(竜巻注意情報)内：<Report><Body><Warning type="竜巻注意情報（市町村等）"><Item><Area><Name>タグ

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

備考

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

上記サイトのコード管理表及び個別コード表の『個別コード表[zip形式]』内の、「YYYYMMDD_AreaInformationCity-AreaForecastLocalM.xls」のAreaInformationCityシートC列の定義を参照。

citycode:市町村コード

説明竜巻注意情報の対象となる市町村コードを設定。

情報定義元気象庁XML電文(竜巻注意情報)内：<Report><Body><Warning type="竜巻注意情報（市町村等）"><Item><Area><Code>タグ

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

備考

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

上記サイトのコード管理表及び個別コード表の『個別コード表[zip形式]』内の、「YYYYMMDD_AreaInformationCity-AreaForecastLocalM.xls」のAreaInformationCityシートA列の定義を参照。

総務省で定義された「全国地方公共団体コード」の市町村コードではありません。

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",                                   // 発表状況コード
  },
  (略)
]