Dark mode
/v1/global-storm.json
GET
/v1/global-storm.json
Global tropical storm track and intensity data in JSON format.
| Item | Value |
|---|---|
| Format | JSON |
| 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/json
JSON
{
"tropCount": "1",
"updateTime": "2016-06-05T20:59:53",
"tropInfo": [
{
"tropName": "string",
"tropID": "string",
"tropType": "string",
"issueTime": "string",
"analysisInfolist": {
"analysisInfo": [
{
"class": "string",
"validTime": "string",
"point": {
"lat": 0,
"lon": 0
},
"windspeed_10min_max": 0,
"pressure": 0,
"gusts": 0,
"galeForceWindArea": {
},
"stormForceWindArea": {
},
"tropSpeed": 0,
"tropHeading": 0
}
]
},
"forecastInfolist": {
"forecastInfo": [
{
"class": "string",
"validTime": "string",
"point": {
"lat": 0,
"lon": 0
},
"windspeed_10min_max": 0,
"pressure": 0,
"gusts": 0,
"galeForceWindArea": {
},
"stormForceWindArea": {
},
"tropSpeed": 0,
"tropHeading": 0
}
]
},
"trackInfolist": {
"trackInfo": [
{
"class": "string",
"validTime": "string",
"point": {
"lat": 0,
"lon": 0
},
"windspeed_10min_max": 0,
"pressure": 0,
"gusts": 0,
"galeForceWindArea": {
},
"stormForceWindArea": {
},
"tropSpeed": 0,
"tropHeading": 0
}
]
}
}
]
}