竜巻注意情報パラメータ(バージョン1)¶
パラメータ一覧表¶
| No | 項目名 | <固有名称>key名 | 設定値 | 意味 | データ定義元 | ユニーク | 備考 |
|---|---|---|---|---|---|---|---|
|
XML電文ID | xmlid | 【YYYYMMDDHHmmSS】-【XML電文データハッシュ値】 | 気象庁XML電文ごとに割り振るユニークID | アプリケーション独自定義 | YYYYMMDDHHmmSS値は電文発信時刻(send_datetime値(UTC))で算出。
XML電文データは、気象庁から配信されるデータ内の気象バイナリデータ本文(XMLのgzip圧縮データ)を指す。
|
|
|
データ種類コード | typecode | "VPHW50"固定 | 気象庁XML電文データ種類コード | 気象庁 | ||
|
標題 | title | 【対象地域名称】竜巻注意情報 | 標題 | 気象庁 | 対象地域名称はXML電文が対象とする地域の名称が設定 | |
|
運用種別 | controlstatus | "通常"、 "訓練"、 "試験" | 発表された竜巻注意情報の運用種別 | 気象庁 | ||
|
運用種別コード | controlstatuscode | "0"、 "1"、 "2" | 運用種別をコード化した情報 | アプリケーション独自定義 | 複合キー | 0 - 通常
1 - 訓練
2 - 試験
「18:市町村コード」との組み合わせで一意なレコードとなる
|
|
編集官署名 | editorial_office | XML電文記載値 | 実際に発表作業を行った官署名 | 気象庁 | ||
|
発表官署名 | publishing_office | XML電文記載値 | 業務的に発表した官署名 | 気象庁 | ||
|
識別情報 | eventid | "" | 識別情報 | 気象庁 | 常に空文字 | |
|
情報番号 | serial | 1～ | 情報の発表番号 | 気象庁 | 竜巻注意情報の発表内容の有効時間（1時間）内に
続報発表があった場合に値を加算
|
|
|
見出し文 | headline | XML電文記載値 | 見出し文 | 気象庁 | ||
|
発信時刻 | send_datetime | ISO8601形式
(例:YYYY-MM-DDTHH:mm:SSZ(UTC表記))
|
発信時刻 | 気象庁 | ||
|
発表時刻 | report_datetime | ISO8601形式
(例:YYYY-MM-DDTHH:mm:00+09:00(JST表記))
|
発表時刻 | 気象庁 | 時刻は分単位で刻み、秒は常に00が設定 | |
|
基点時刻 | target_datetime | ISO8601形式
(例:YYYY-MM-DDTHH:mm:00+09:00(JST表記))
|
基点時刻 | 気象庁 | 時刻は分単位で刻み、秒は常に00が設定 | |
|
失効時刻 | valid_datetime | ISO8601形式
(例:YYYY-MM-DDTHH:mm:00+09:00(JST表記))
|
失効時刻 | 気象庁 | 時刻は分単位で刻み、秒は常に00が設定 | |
|
都道府県名称 | prefname | 【都道府県名称】 または "不明" | 竜巻注意情報発令対象の都道府県名称 | アプリケーション独自定義 | prefcode値から都道府県名称を取得
都道府県が判別できない場合は「不明」を設定
|
|
|
都道府県コード | prefcode | "01" ～ "47" | 竜巻注意情報発令対象の都道府県コード(全国地方公共団体コード) | アプリケーション独自定義 | 総務省定義の「全国地方公共団体コード」 に準ずる
areacode値の先頭2桁を設定
|
|
|
市町村名称 | cityname | XML電文記載値 | 竜巻注意情報発令対象の市町村名称 | 気象庁 | 名称定義は パラメータ詳細 を参照 | |
|
市町村コード | citycode | XML電文記載値 | 竜巻注意情報発令対象の市町村コード | 気象庁 | 複合キー | コード定義は パラメータ詳細 を参照
「5:運用種別コード」との組み合わせで一意なレコードとなる
|
|
情報名 | infoname | "竜巻注意情報"、 "なし" | 情報名 | 気象庁 | ||
|
情報コード | infocode | "1"、 "0" | 情報名をコード化した情報 | 気象庁 | 1 - 竜巻注意情報
0 - なし
|
|
|
発表状況 | status | "発表"、 "なし" | 発表状況 | 気象庁 | ||
|
発表状況コード | statuscode | "1"、"0" | 発表状況をコード化した情報 | 気象庁 | 1 - 発表
0 - なし
|
|
|
発信官署コード | officecode | XML電文記載値 | 発信官署コード | 気象庁 | コード定義は パラメータ詳細 を参照 |
パラメータ詳細¶
説明 気象庁配信電文(XML)ごとのユニークな値を設定。 情報定義元 気象庁XML電文データを基にアプリケーションで独自定義 設定値 気象庁のXML電文の発信時刻(send_datetime値)とXML電文のハッシュ値(SHA256)を利用し、【YYYYMMDDHHmmSS】+【XML電文ハッシュ値】を設定。 備考
説明 XML電文のデータ種類コードを設定。 情報定義元 気象庁通知電文ヘッダ: XML電文のデータ種類コード値部 設定値 "VPHW50" 固定 備考 "VPHW50"は竜巻注意情報を示す。
説明 情報の標題を設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Head><Title>タグ 設定値 情報定義元の値をそのまま設定。 備考 基となる気象庁XML電文が対象とする地域の名称に続き、”竜巻注意情報”が付加された値を設定。
説明 発表された竜巻注意情報の運用種別を設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Control><Status>タグ 設定値 備考
説明 controlstatusをコード化した文字列を設定。 情報定義元 気象庁XML電文データを基にアプリケーションで独自定義 設定値 controlstatus値により下表の条件で設定。 備考
運用種別: controlstatus 運用種別コード: controlstatuscode 通常 0 訓練 1 試験 2
説明 実際に発表作業を行った官署名を設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Control><EditorialOffice>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 業務的に発表した官署名を設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Control><PublishingOffice>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 識別情報を設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Head><EventID>タグ 設定値 情報定義元の値をそのまま設定。 備考 常に空文字
説明 情報の発表番号を設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Head><Serial>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 警戒文を設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Head><Headline><Text>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 気象庁システムからの発信時刻を設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Control><DateTime>タグ 設定値 情報定義元の値をそのまま設定。 備考 UTC表記のDateTime型(ISO8601形式(YYYY-MM-DDTHH:mm:SS+09:00))で表記。
説明 発表官署が竜巻注意情報を発表した時刻を設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Head><ReportDateTime>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 基点時刻を設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Head><TargetDateTime>タグ 設定値 情報定義元の値をそのまま設定。 備考 UTC表記のDateTime型(ISO8601形式(YYYY-MM-DDTHH:mm:SS+09:00))で表記。
説明 竜巻注意情報の失効時刻を設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Head><ValidDateTime>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 竜巻注意情報の対象となる都道府県名称を設定。 情報定義元 気象庁XML電文データを基にアプリケーションで独自定義 設定値 【都道府県名称】または "不明" 備考
説明 竜巻注意情報の対象となる都道府県コードを設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Head><Headline><Information type="竜巻注意情報（発表細分"）><Item><Areas codeType="気象情報／府県予報区・細分区域等"><Area><Code>タグ 設定値 情報定義元値の先頭2桁("01" ～ "47") 備考 総務省定義の全国地方公共団体コード に準ずる。
説明 竜巻注意情報の対象となる市町村名称を設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Body><Warning type="竜巻注意情報（市町村等）"><Item><Area><Name>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 竜巻注意情報の対象となる市町村コードを設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Body><Warning type="竜巻注意情報（市町村等）"><Item><Area><Code>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 竜巻注意情報の情報名を設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Body><Warning type="竜巻注意情報（市町村等）"><Item><Kind><Name>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 竜巻注意情報の情報名をコード化した値を設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Body><Warning type="竜巻注意情報（市町村等）"><Item><Kind><Code>タグ 設定値 情報定義元の値をそのまま設定。 備考
"竜巻注意情報" 1 "なし" 0
説明 竜巻注意情報の発表状況を設定。 情報定義元 気象庁XML電文(竜巻注意情報)内：<Report><Body><Warning type="竜巻注意情報（市町村等）"><Item><Kind><Status>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 竜巻注意情報の発表状況をコード化した値を設定。 情報定義元 気象庁XML電文データを基にアプリケーションで独自定義 設定値 発表状況(status)により、以下の条件で設定。 備考
"発表" 1 "なし" 0
説明 電文の発信を行った官署コード値を設定。 情報定義元 気象庁通知電文ヘッダ: 発信官署コード値部 設定値 情報定義元の値をそのまま設定。 備考
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", // 発表状況コード }, (略) ]