台風情報(全般台風情報・発達する熱帯低気圧に関する情報)パラメータ(バージョン1)¶
パラメータ一覧表¶
| No | 項目名 | <固有名称>key名 | 設定値 | 意味 | データ定義元 | ユニーク | 備考 |
|---|---|---|---|---|---|---|---|
|
XML電文ID | xmlid | 【YYYYMMDDHHmmSS】-【XML電文データハッシュ値】 | 気象庁XML電文ごとに割り振るユニークID | アプリケーション独自定義 | YYYYMMDDHHmmSS値は電文発信時刻(send_datetime値(UTC))で算出。
XML電文データは、気象庁から配信されるデータ内の気象バイナリデータ本文(XMLのgzip圧縮データ)を指す。
|
|
|
データ種類コード | typecode | "VPTI50"または"VPTI51"
※2026年5月28日に予定される気象庁による新たな防災気象情報の運用開始後は以下に変更予定。
"VPZJ51"
|
気象庁XML電文データ種類コード | 気象庁 | VPTI50は「全般台風情報(総合情報・上陸情報)」を示す。
VPTI51は「全般台風情報(位置・発生情報)」または「発達する熱帯低気圧に関する情報」を示す。
VPZJ51は「全般気象解説情報」を示す。
|
|
|
運用種別 | controlstatus | "通常", "訓練", "試験" | 発表された台風情報の運用種別 | 気象庁 | ||
|
運用種別コード | controlstatuscode | "0", "1", "2" | 運用種別をコード化した情報 | アプリケーション独自定義 | 複合キー | 0 - 通常
1 - 訓練
2 - 試験
「8：TC番号(台風識別番号)」との組み合わせで一意なレコードとなる。
|
|
発表形態 | infotype | "発表", "訂正", "取消" | 情報の発表形態 | 気象庁 | ||
|
発表形態コード | infotypecode | "1", "2", "3" | 発表形態をコード化した情報 | アプリケーション独自定義 | 1 - 発表
2 - 訂正
3 - 取消
|
|
|
発表情報種別 | reporttype | "0", "1" | 発表された情報の種別 | アプリケーション独自定義 | 0 - 熱帯低気圧に関する情報
1 - 台風に関する情報
※2026年5月28日に予定される気象庁による新たな防災気象情報の運用開始後は以下に変更予定。
0 - 温帯低気圧又は熱帯低気圧に関する情報
1 - 台風に関する情報
|
|
|
TC番号(台風識別番号) | eventid | XML電文記載値 | 特定の台風を識別するための番号 | 気象庁 | 複合キー | 「4：運用種別コード」」との組み合わせで一意なレコードとなる。 |
|
情報番号 | serial | XML電文記載値 | 情報の発表番号 | 気象庁 | 情報更新ごとに値を加算。 | |
|
標題 | title | XML電文記載値 | 標題 | 気象庁 | ||
|
見出し文 | headline | XML電文記載値 | 見出し文 | 気象庁 | ||
|
内容 | comment | XML電文記載値 | 一般報(台風情報)の内容
※2026年5月28日に予定される気象庁による新たな防災気象情報の運用開始後は以下に変更予定。
気象概況(台風情報)の本文
|
気象庁 | ||
|
発信時刻 | 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電文のデータ種類コード値部 設定値 備考
説明 発表された台風情報(全般台風情報・発達する熱帯低気圧に関する情報)の運用種別を設定。 情報定義元 気象庁XML電文(台風情報)内：<Report><Control><Status>タグ 設定値 備考
説明 controlstatusをコード化した文字列を設定。 情報定義元 気象庁XML電文データを基にアプリケーションで独自定義 設定値 controlstatus値により下表の条件で設定。 備考
運用種別: controlstatus 運用種別コード: controlstatuscode 通常 0 訓練 1 試験 2
説明 情報の発表形態を設定。 情報定義元 気象庁XML電文(台風情報)内：<Report><Head><InfoType>タグ 設定値 備考
説明 infotypeをコード化した文字列を設定。 情報定義元 気象庁XML電文データを基にアプリケーションで独自定義 設定値 infotype値により下表の条件で設定。 備考
発表形態: infotype 発表形態コード: infotypecode 発表 1 訂正 2 取消 3
説明 気象庁の発表した情報の種別を設定。 情報定義元 気象庁XML電文データを基にアプリケーションで独自定義 設定値 備考
説明 台風情報(全般台風情報・発達する熱帯低気圧に関する情報)の台風を識別するための情報を設定。 情報定義元 気象庁XML電文(台風情報)内：<Report><Head><EventID>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 情報の発表番号を設定。 情報定義元 気象庁XML電文(台風情報)内：<Report><Head><Serial>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 本情報の具体的な内容を示す値を設定。 情報定義元 気象庁XML電文(台風情報)内：<Report><Head><Title>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 見出しの内容を設定。 情報定義元 気象庁XML電文(台風情報)内：<Report><Head><Headline><Text>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 情報定義元 設定値 情報定義元の値をそのまま設定。 備考
説明 気象庁システムからの発信時刻を設定。 情報定義元 気象庁XML電文(台風情報)内：<Report><Control><DateTime>タグ 設定値 情報定義元の値をそのまま設定。 備考 UTC表記のDateTime型
説明 発表官署が台風情報(全般台風情報・発達する熱帯低気圧に関する情報)を発表した時刻を設定 情報定義元 気象庁XML電文(台風情報)内：<Report><Head><ReportDateTime>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 実際に発表作業を行った官署名を設定。 情報定義元 気象庁XML電文(台風情報)内：<Report><Control><EditorialOffice>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 業務的に発表した官署名を設定。 情報定義元 気象庁XML電文(台風情報)内：<Report><Control><PublishingOffice>タグ 設定値 情報定義元の値をそのまま設定。 備考
説明 電文の発信を行った官署コード値を設定。 情報定義元 気象庁通知電文ヘッダ: 発信官署コード値部 設定値 備考
JPSP 札幌管区気象台 JPSA 稚内地方気象台 JPSB 網走地方気象台 JPSC 旭川地方気象台 JPSD 釧路地方気象台 JPSJ 帯広測候所 JPSE 室蘭地方気象台 JPSF 函館海洋気象台 JPSN 仙台管区気象台 JPDA 青森地方気象台 JPDB 秋田地方気象台 JPDC 盛岡地方気象台 JPDD 山形地方気象台 JPDE 福島地方気象台 JPTK 東京管区気象台 RJTD 気象庁本庁 JPTA 宇都宮地方気象台 JPTB 前橋地方気象台 JPTC 熊谷地方気象台 JPTD 水戸地方気象台 JPTE 銚子地方気象台 JPTF 横浜地方気象台 JPTG 長野地方気象台 JPTH 甲府地方気象台 JPGY 名古屋地方気象台 JPGA 静岡地方気象台 JPGB 岐阜地方気象台 JPGC 津地方気象台 JPNI 新潟地方気象台 JPNA 富山地方気象台 JPNB 金沢地方気象台 JPNC 福井地方気象台 JPOS 大阪管区気象台 JPOA 京都地方気象台 JPOF 舞鶴海洋気象台 JPOB 神戸海洋気象台 JPOC 奈良地方気象台 JPOD 彦根地方気象台 JPOE 和歌山地方気象台 JPHR 広島地方気象台 JPHA 鳥取地方気象台 JPHB 松江地方気象台 JPHC 岡山地方気象台 JPMT 高松地方気象台 JPMA 松山地方気象台 JPMB 徳島地方気象台 JPMC 高知地方気象台 JPFK 福岡地方気象台 JPFA 下関地方気象台 JPFB 大分地方気象台 JPFC 佐賀地方気象台 JPFD 熊本地方気象台 JPFE 長崎海洋気象台 JPKG 鹿児島地方気象台 JPKC 名瀬測候所 JPKA 宮崎地方気象台 JPOK 沖縄気象台 JPWA 南大東島地方気象台 JPWB 宮古島地方気象台 JPWC 石垣島地方気象台
REST APIで取得できるデータ例(JSON)¶
2026年5月28日に予定される気象庁による新たな防災気象情報の運用開始前のデータ例¶
"code" : "200", // REST API実行結果コード "message" : "success.", // REST API実行結果メッセージ "datalist" : [ // REST API取得データ(配列) { "id" : "1243648", // システムで採番されたユニークID "datatypename" : "jmatyphoon", // データタイプ名(台風情報(全般台風情報・発達する熱帯低気圧に関する情報)=jmatyphoon) "dataversion" : 1, // データバージョン "create_date" : "2016-09-19T14:18:38.341966+09:00", // システム登録日時 "update_date" : "2016-09-20T01:45:29.211226+09:00", // システム更新日時 "expire_date" : "", // 保存期限日時 // 以下、データタイプ固有パラメータ "xmlid" : "20160919164345-57e2a99d00dcd92cc91729683879962dccecfa78c88f5511306c21fb01f994f4", // XMLID "typecode" : "VPTI51", // データ種類コード "controlstatus" : "通常", // 運用種別 "controlstatuscode" : "0", // 運用種別コード "infotype" : "発表", // 発表形態 "infotypecode" : "1", // 発表形態コード "reporttype" : "1", // 発表情報種別 "eventid" : "TC1623", // TC番号(台風識別番号) "serial" : "91", // 情報番号 "title" : "平成２８年 台風第１６号に関する情報 第９１号 （位置）", // 標題 "headline" : " 非常に強い台風第１６号は、鹿屋市付近を １時間におよそ３０キロの速さで東北東へ進んでいます。", // 見出し文 "comment" : " 非常に強い台風第１６号は、２０日１時には 鹿屋市付近の 北緯３１度１０分、東経１３０度５５分にあって、 １時間におよそ３０キロの速さで東北東へ進んでいます。 中心の気圧は９４５ヘクトパスカル 中心付近の最大風速は４５メートル、 最大瞬間風速は６０メートルで 中心から半径１１０キロ以内では 風速２５メートル以上の暴風となっています。 また、中心の北西側４４０キロ以内と南東側２８０キロ以内では 風速１５メートル以上の強い風が吹いています。 この台風は２０日２時には、串間市付近の 北緯３１度２０分、東経１３１度１０分にあって、 １時間におよそ３０キロの速さで東北東へ進んで いるものと推定されます。 中心の気圧は９４５ヘクトパスカル 中心付近の最大風速は４５メートル、 最大瞬間風速は６０メートルで 中心から半径１１０キロ以内では 風速２５メートル以上の暴風が また、中心の北西側４４０キロ以内と南東側２８０キロ以内では 風速１５メートル以上の強い風が吹いているものと推定されます。 今後の台風情報にご注意下さい。", // 情報内容 "send_datetime" : "2016-09-19T16:43:45Z", // 発信時刻 "report_datetime" : "2016-09-20T01:45:00+09:00", // 発表時刻 "editorial_office" : "気象庁本庁", // 編集官署名 "publishing_office" : "気象庁予報部", // 発表官署名 "officecode" : "RJTD", // 発信官署コード } ]
2026年5月28日に予定される気象庁による新たな防災気象情報の運用開始後のデータ例¶
"code" : "200", // REST API実行結果コード "message" : "success.", // REST API実行結果メッセージ "datalist" : [ // REST API取得データ(配列) { "id" : "1243648", // システムで採番されたユニークID "datatypename" : "jmatyphoon", // データタイプ名(台風情報(全般台風情報・発達する熱帯低気圧に関する情報)=jmatyphoon) "dataversion" : 1, // データバージョン "create_date" : "2016-09-19T14:18:38.341966+09:00", // システム登録日時 "update_date" : "2016-09-20T01:45:29.211226+09:00", // システム更新日時 "expire_date" : "", // 保存期限日時 // 以下、データタイプ固有パラメータ "xmlid" : "20160919164345-57e2a99d00dcd92cc91729683879962dccecfa78c88f5511306c21fb01f994f4", // XMLID "typecode" : "VPZJ51", // データ種類コード "controlstatus" : "通常", // 運用種別 "controlstatuscode" : "0", // 運用種別コード "infotype" : "発表", // 発表形態 "infotypecode" : "1", // 発表形態コード "reporttype" : "1", // 発表情報種別 "eventid" : "TC1623", // TC番号(台風識別番号) "serial" : "91", // 情報番号 "title" : "全般気象解説情報（台風第１０号）", // 標題 "headline" : "鹿児島県に暴風、波浪、高潮特別警報を発表中です。鹿児島県では暴風や高波、高潮に、九州南部では土砂災害、低い土地の浸水、河川の増水や氾濫に最大級の警戒をしてください。また、西日本と奄美地方では、２９日にかけて線状降水帯が発生して大雨災害発生の危険度が急激に高まる可能性があります。", // 見出し文 "comment" : "非常に強い台風第１０号は、２８日２２時には屋久島の北西約５０キロにあって、１時間におよそ１０キロの速さで北へ進んでいます。中心の気圧は９３５ヘクトパスカル、中心付近の最大風速は５０メートル、最大瞬間風速は７０メートルで、中心から半径１１０キロ以内では風速２５メートル以上の暴風となっています。 台風は、今後、非常に強い勢力を維持したまま北上し、３０日にかけて九州に上陸するおそれがあります。九州南部では記録的な暴風や高波、高潮、大雨となるおそれがあります。台風の動きが遅いため、西日本を中心に長い時間にわたって、猛烈な風や猛烈なしけが続き、総雨量が多くなる見込みです。 また、西日本と東日本太平洋側を中心に、台風本体から離れた地域でも、台風周辺や太平洋高気圧の縁を回る暖かく湿った空気が流れ込んで大気の状態が非常に不安定となっており、断続的に雷を伴った激しい雨や非常に激しい雨が降っている所があります。", // 情報内容 "send_datetime" : "2016-09-19T16:43:45Z", // 発信時刻 "report_datetime" : "2016-09-20T01:45:00+09:00", // 発表時刻 "editorial_office" : "気象庁本庁", // 編集官署名 "publishing_office" : "気象庁予報部", // 発表官署名 "officecode" : "RJTD", // 発信官署コード } ]