Dark mode
/v1/global-storm.xml
GET
/v1/global-storm.xml
Global tropical storm track and intensity data in XML format.
| Item | Value |
|---|---|
| Format | XML |
| Region | Global |
| Forecast Base Time | 02:00, 08:00, 14:00, 20:00 UTC |
| Forecast Duration | Based on storm lifetime |
| Average Size | ~44 KB |
Notes
- When no tropical storms are active,
tropCountis"0"andtropInfois an empty array.
This is a normal response — it simply means no storms exist at the requested time. tropCountreflects the number of active storms in the dataset, not a forecast count.analysisInfocontains the current position;forecastInfocontains predicted positions;
trackInfocontains the historical track.- Coordinates (
lat,lon) are in arc-minutes. Divide by 60 to convert to decimal degrees.
Field Definitions
| Item Name | Full Name | Unit/Format | Value Type |
|---|---|---|---|
| tropCount | Total Tropical Storms in Data | - | Int |
| updateTime | Update Date of Data (UTC) | datetime (yyyy-mm-ddThh:mm:ss) | string |
| tropInfo | Tropical Storm Information | - | - |
| tropName | Tropical Name | [A-Z]-[A-Z] | string |
| tropType | Kind of Tropical Storm | TY, HUR, CYC | string |
| issueTime | Announcement Time of the File | datetime (yyyy-mm-ddThh:mm:ss) | string |
| analysisInfo | Analysis Information | - | - |
| forecastInfo | Forecast Information | - | - |
| trackInfo | Tropical Storm Track Information | - | - |
| class | State of Tropical Storm | TD, TS, STS, TY, XT, HUR | string |
| validTime | Target Time | datetime (yyyy-mm-ddThh:mm:ss) | string |
| point | Position (latitude, longitude) | - | - |
| lat | Position Latitude | min | float |
| lon | Position Longitude | min | float |
| windspeed_10min_max | Maximum Wind Speed | kts | float |
| pressure | Atmospheric Pressure | hPa | float |
| gusts | Gust | kts | float |
| galeForceWindArea | Gale Force Wind Area | - | - |
| stormForceWindArea | The Quadrant Strong Wind Range | - | - |
| radii_1 | 1st Quadrant Strong Wind Range | distance [nm]: start orientation | string |
| radii_2 | 2nd Quadrant Strong Wind Range | distance [nm] | string |
| radii_3 | 3rd Quadrant Strong Wind Range | distance [nm] | string |
| radii_4 | 4th Quadrant Strong Wind Range | distance [nm] | string |
| tropSpeed | Speed of Tropical Storm | kts | float |
| tropHeading | Heading/Direction of Tropical Storm | direction 0-360 | float |
Parameters
Header Parameters
Authorization*
"WniWebApi " + Token ID
Typestring
RequiredQuery Parameters
date
Forecast base time (Optional).
Format: YYYYMMDDHH — HH must be 02, 08, 14, or 20.
If omitted, returns the latest available data.
Typenumber
pattern
^\d{10}$format
yyyymmddhhResponses
application/xml
JSON
"<?xml version="1.0"?>
<tropCount>string</tropCount>
<updateTime>string</updateTime>
<tropInfo>
<tropName>string</tropName>
<tropID>string</tropID>
<JMA_TD_id>string</JMA_TD_id>
<JTWC_TD_id>string</JTWC_TD_id>
<TYPHN_number>string</TYPHN_number>
<tropType>string</tropType>
<issueTime>string</issueTime>
<analysisInfolist>
<analysisInfo>
<class>string</class>
<validTime>string</validTime>
<point>
<lat>0</lat>
<lon>0</lon>
</point>
<windspeed_10min_max>0</windspeed_10min_max>
<pressure>0</pressure>
<gusts>0</gusts>
<galeForceWindArea>
<radii_1>string</radii_1>
<radii_2>string</radii_2>
<radii_3>string</radii_3>
<radii_4>string</radii_4>
</galeForceWindArea>
<stormForceWindArea>
<radii_1>string</radii_1>
<radii_2>string</radii_2>
<radii_3>string</radii_3>
<radii_4>string</radii_4>
</stormForceWindArea>
<tropSpeed>0</tropSpeed>
<tropHeading>0</tropHeading>
</analysisInfo>
</analysisInfolist>
<forecastInfolist>
<forecastInfo>
<class>string</class>
<validTime>string</validTime>
<point>
<lat>0</lat>
<lon>0</lon>
</point>
<windspeed_10min_max>0</windspeed_10min_max>
<pressure>0</pressure>
<gusts>0</gusts>
<galeForceWindArea>
<radii_1>string</radii_1>
<radii_2>string</radii_2>
<radii_3>string</radii_3>
<radii_4>string</radii_4>
</galeForceWindArea>
<stormForceWindArea>
<radii_1>string</radii_1>
<radii_2>string</radii_2>
<radii_3>string</radii_3>
<radii_4>string</radii_4>
</stormForceWindArea>
<tropSpeed>0</tropSpeed>
<tropHeading>0</tropHeading>
</forecastInfo>
</forecastInfolist>
<trackInfolist>
<trackInfo>
<class>string</class>
<validTime>string</validTime>
<point>
<lat>0</lat>
<lon>0</lon>
</point>
<windspeed_10min_max>0</windspeed_10min_max>
<pressure>0</pressure>
<gusts>0</gusts>
<galeForceWindArea>
<radii_1>string</radii_1>
<radii_2>string</radii_2>
<radii_3>string</radii_3>
<radii_4>string</radii_4>
</galeForceWindArea>
<stormForceWindArea>
<radii_1>string</radii_1>
<radii_2>string</radii_2>
<radii_3>string</radii_3>
<radii_4>string</radii_4>
</stormForceWindArea>
<tropSpeed>0</tropSpeed>
<tropHeading>0</tropHeading>
</trackInfo>
</trackInfolist>
</tropInfo>
"