Skip to content

/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, tropCount is "0" and tropInfo is an empty array.
    This is a normal response — it simply means no storms exist at the requested time.
  • tropCount reflects the number of active storms in the dataset, not a forecast count.
  • analysisInfo contains the current position; forecastInfo contains predicted positions;
    trackInfo contains 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
Required

Query Parameters

date

Forecast base time (Optional).
Format: YYYYMMDDHHHH must be 02, 08, 14, or 20.
If omitted, returns the latest available data.

Typenumber
pattern^\d{10}$
formatyyyymmddhh

Responses

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

Playground

Headers
Variables
Key
Value

Samples

All product names, trademarks and registered trademarks are property of their respective owners.