REST API仕様(台風情報：全般台風情報・発達する熱帯低気圧に関する情報)¶
目次
台風情報について¶
- 台風情報は、台風が発生または台風になると予想される熱帯低気圧があるなどの場合に、気象庁が発生・上陸・位置などを発表する情報のことです。
- 詳しくは、 気象庁のwebサイト をご参照ください。
注意事項¶
- 本サービスは、台風の発生を予知するものではありません。
- 本サービスは、気象庁が発表する『台風情報』に含まれる情報（上陸情報、発生情報など）を用いて、台風に関する情報の登録および閲覧をするものです。
- 台風情報についての詳細は、 気象庁のwebサイト でご確認ください。
- 台風情報：全般台風情報・発達する熱帯低気圧に関する情報のデータには、「通常」「訓練」「試験」のモードが存在しており、データを利用する際にはこれらのモードに対して適切な処理を行ってください。
- 例えば「訓練」「試験」モードのデータは利用しない、利用する場合は明らかに 訓練 や 試験 であることが分かるようにするなど、利用者の混乱を避けてください。
- 「訓練」「試験」モードのデータを、「通常」データであるかのような処理は 行わない でください。
- モードの誤用によるトラブルについては、弊社は一切の責任を負わないものとします。
台風情報：全般台風情報・発達する熱帯低気圧に関する情報のデータについて¶
- 気象庁発表の台風情報の内、全般台風情報(総合情報・上陸等情報)、全般台風情報(位置・発生情報)、発達する熱帯低気圧に関する情報を元に、台風関連情報をREST API経由で登録/検索します。
- 台風情報：全般台風情報(総合情報・上陸等情報)、全般台風情報(位置・発生情報)、発達する熱帯低気圧に関する情報のXML電文仕様は、 気象庁防災情報XMLフォーマット | 技術資料 の電文毎の解説資料:解説資料セット[zip形式]に含まれる、『一般報_解説資料.pdf』に記載されています。
- XML電文は、上記サイト内のサンプルデータで確認できます。
- 本サービスでは、気象庁定義のTC番号(台風識別番号)・運用種別ごとに気象情報を保持します。
- 1つのTC番号(台風識別番号)毎に、運用種別:「通常」「訓練」「試験」の3レコードを最大で保持します。
サービス仕様変更のお知らせ¶
2026年5月28日に予定される気象庁による新たな防災気象情報の運用開始に伴う、本データタイプで利用する気象庁XML電文の変更について¶
- 2026年5月28日に予定される気象庁による新たな防災気象情報の運用開始により、本データタイプで利用する気象庁XML電文の「全般台風情報(総合情報・上陸等情報)」（VPTI50）及び「全般台風情報(位置・発生情報)」（VPTI51）の運用が終了される予定です。
- それに伴い、本サービスではその後継となる気象庁XML電文「全般気象解説情報」（VPZJ51）に含まれる以下の台風関連情報を元に本データタイプの情報を配信するように変更いたします。
- 台風に関する気象情報
- 発達する熱帯低気圧に関する気象情報
- 台風から変わった温帯低気圧又は熱帯低気圧に関する情報
- 本件によるデータタイプ名、データ構造の変更はございません。
- ただし、文章形式の値が設定される標題（title）、見出し文（headline）及び内容（comment）パラメータについては、従前のフォーマットやパターンと異なる値が設定される場合や文字列の長さが変わる場合がございます。
- パラメータの設定値の詳細につきましては、以下のデータ仕様をご参照ください。
- 2026年5月28日に予定される気象庁による新しい防災気象情報システムへの切り替えが完了し次第、弊社サービスの本番系システム及びトライアル／開発系システムから配信する電文にその内容が反映されます。
- 気象庁による新たな防災気象情報の運用開始の詳細につきましては 気象庁のwebサイト をご参照ください。
REST API 台風情報：全般台風情報・発達する熱帯低気圧に関する情報のデータ仕様¶
- 台風情報：全般台風情報・発達する熱帯低気圧に関する情報をREST APIから取得する際、APIパラメータのqueryセクションのdatatypenameには、"jmatyphoon"を設定します。
- REST APIで取得できるデータはバージョンにより異なります。