Tropical cyclone
For iOS SDK v4.9+Tropical cyclone SDK provides tropical cyclones (typhoon) information in major ocean basins around the world, including real-time typhoon location, level, pressure, wind and etc., as well as typhoon path and typhoon forecast information.
Storm List
Get storem ID and list of tropical cyclones (typhoons) in the world’s major ocean basins.
Only the coastal areas of China are supported now, i.e.
basin=NP
Interface code (Enum) | Interface | Class |
---|---|---|
INQUIRE_TYPE_STORM_LIST | Storm list and IDs | StormListBaseClass |
Request Parameters
If no optional parameters are set, the default value will be used.
basin
The basin where the storm needs to be queried. For now, only support NP
.
AL
North AtlanticEP
Eastern PacificNP
NorthWest PacificSP
SouthWestern PacificNI
North Indian North Indian OceanSI
South Indian South Indian Ocean
year
Support to query storm of this year and last year, e.g., year=2020
appKey
API authentication key, please refer to How To Get Your Key.
For example: appKey=12334567890ABC
Sample Code
QWeatherConfigInstance.publicID = @"publicID";
QWeatherConfigInstance.appKey = @"key";
QWeatherConfigInstance.appType = APP_TYPE_BIZ;
QWeatherConfigInstance.basin = BASIN_TYPE_NP;
QWeatherConfigInstance.year = @"2021";
[QWeatherConfigInstance weatherWithInquireType:INQUIRE_TYPE_STORM_LIST WithSuccess:^(StormListBaseClass *responseObject) {
NSLog(@"描述->%@",[responseObject description]);
} faileureForError:^(NSError *error) {
NSLog(@"error->%@",error);
}];
Response
Parameters | Description |
---|---|
code |
API status code, please refer to Status Code |
updateTime |
|
fxLink |
Responsive web page of this data, for embedded in website or APP |
storm.stormId |
Storm ID |
storm.name |
Storm name |
storm.basin |
The basin of the storm |
storm.year |
Year of the storm |
storm.isActive |
Is it an active storm? |
refer.sources |
Data source and other statements, may be null |
refer.license |
Data license, may be null |
Storm Track
Storm Track provides tropical cyclones real-time information, including real-time tropical cyclones location, level, pressure, wind and etc., as well as historical position.
Interface code (Enum) | Interface | Class |
---|---|---|
INQUIRE_TYPE_STORM_TRACK | Real-time storm data and storm track data | StormNowTrackBaseClass |
Request Parameters
If no optional parameters are set, the default value will be used.
stormid
The storm ID that needs to be queried, StormID can be obtained by Storm List, e.g., stormid=NP2018
appKey
API authentication key, please refer to How To Get Your Key.
For example: appKey=12334567890ABC
Sample Code
QWeatherConfigInstance.publicID = @"publicID";
QWeatherConfigInstance.appKey = @"key";
QWeatherConfigInstance.appType = APP_TYPE_BIZ;
QWeatherConfigInstance.stormID = @"NP_2102";
[QWeatherConfigInstance weatherWithInquireType: INQUIRE_TYPE_STORM_TRACK WithSuccess:^(StormNowTrackBaseClass *responseObject) {
NSLog(@"描述->%@",[responseObject description]);
} faileureForError:^(NSError *error) {
NSLog(@"error->%@",error);
}];
Response
Parameters | Description |
---|---|
code |
API status code, please refer to Status Code |
updateTime |
|
fxLink |
Responsive web page of this data, for embedded in website or APP |
isActive |
Is it an active storm? |
now.pubTime |
The data release time from the data source |
now.lat |
Storm latitude |
now.lon |
Storm longitude |
now.type |
Storm type |
now.pressure |
Center pressure of the storm |
now.windSpeed |
Maximum wind speed near the strom |
now.moveSpeed |
Storm moving speed |
now.moveDir |
Storm moving direction |
now.move360 |
Storm movement direction in azimuth degre |
now.windRadius30.neRadius |
The northeast wind radius quadrants of the strom with level 7 wind circle, may be null |
now.windRadius30.seRadius |
The southeast wind radius quadrants of the strom with level 7 wind circle, may be null |
now.windRadius30.swRadius |
The southwest wind radius quadrants of the strom with level 7 wind circle, may be null |
now.windRadius30.nwRadius |
The northwest wind radius quadrants of the strom with level 7 wind circle, may be null |
now.windRadius50.neRadius |
The northeast wind radius quadrants of the strom with level 10 wind circle, may be null |
now.windRadius50.seRadius |
The southeast wind radius quadrants of the strom with level 10 wind circle, may be null |
now.windRadius50.swRadius |
The southwest wind radius quadrants of the strom with level 10 wind circle, may be null |
now.windRadius50.nwRadius |
The northwest wind radius quadrants of the strom with level 10 wind circle, may be null |
now.windRadius64.neRadius |
The northeast wind radius quadrants of the strom with level 12 wind circle, may be null |
now.windRadius64.seRadius |
The southeast wind radius quadrants of the strom with level 12 wind circle, may be null |
now.windRadius64.swRadius |
The southwest wind radius quadrants of the strom with level 12 wind circle, may be null |
now.windRadius64.nwRadius |
The northwest wind radius quadrants of the strom with level 12 wind circle, may be null |
track.time |
Storm information release time |
track.lat |
Storm latitude |
track.lon |
Storm longitude |
track.type |
Storm type |
track.pressure |
Center pressure of the storm |
track.windSpeed |
Maximum wind speed near the strom |
track.moveSpeed |
Storm moving speed |
track.moveDir |
Storm moving direction |
track.move360 |
Storm movement direction in azimuth degre |
track.windRadius30.neRadius |
The northeast wind radius quadrants of the strom with level 7 wind circle, may be null |
track.windRadius30.seRadius |
The southeast wind radius quadrants of the strom with level 7 wind circle, may be null |
track.windRadius30.swRadius |
The southwest wind radius quadrants of the strom with level 7 wind circle, may be null |
track.windRadius30.nwRadius |
The northwest wind radius quadrants of the strom with level 7 wind circle, may be null |
track.windRadius50.neRadius |
The northeast wind radius quadrants of the strom with level 10 wind circle, may be null |
track.windRadius50.seRadius |
The southeast wind radius quadrants of the strom with level 10 wind circle, may be null |
track.windRadius50.swRadius |
The southwest wind radius quadrants of the strom with level 10 wind circle, may be null |
track.windRadius50.nwRadius |
The northwest wind radius quadrants of the strom with level 10 wind circle, may be null |
track.windRadius64.neRadius |
The northeast wind radius quadrants of the strom with level 12 wind circle, may be null |
track.windRadius64.seRadius |
The southeast wind radius quadrants of the strom with level 12 wind circle, may be null |
track.windRadius64.swRadius |
The southwest wind radius quadrants of the strom with level 12 wind circle, may be null |
track.windRadius64.nwRadius |
The northwest wind radius quadrants of the strom with level 12 wind circle, may be null |
refer.sources |
Data source and other statements, may be null |
refer.license |
Data license, may be null |
Storm Forecast
Storm Forecast provides tropical cyclones information for a specific tropical cyclone, the data including forecast tropical cyclones location, level, pressure, wind and etc.
For historical storms, the returned data is NULL, please get the storms status by Storm List first.
Interface code (Enum) | Interface | Class |
---|---|---|
INQUIRE_TYPE_STORM_FORECAST | Storm forecast data | StormForecastBaseClass |
Request Parameters
If no optional parameters are set, the default value will be used.
stormid
The storm ID that needs to be queried, StormID can be obtained by Storm List, e.g., stormid=NP2018
appKey
API authentication key, please refer to How To Get Your Key.
For example: appKey=12334567890ABC
Sample Code
QWeatherConfigInstance.publicID = @"publicID";
QWeatherConfigInstance.appKey = @"key";
QWeatherConfigInstance.appType = APP_TYPE_BIZ;
QWeatherConfigInstance.stormID = @"NP_2102";
[QWeatherConfigInstance weatherWithInquireType: INQUIRE_TYPE_STORM_FORECAST WithSuccess:^(StormForecastBaseClass *responseObject) {
NSLog(@"描述->%@",[responseObject description]);
} faileureForError:^(NSError *error) {
NSLog(@"error->%@",error);
}];
Response
Parameters | Description |
---|---|
code |
API status code, please refer to Status Code |
updateTime |
|
fxLink |
Responsive web page of this data, for embedded in website or APP |
forecast.fxTime |
Storm forecast time |
forecast.lat |
Storm latitude |
forecast.lon |
Storm longitude |
forecast.type |
Storm type |
forecast.pressure |
Center pressure of the storm |
forecast.windSpeed |
Maximum wind speed near the strom |
forecast.moveSpeed |
Storm moving speed |
forecast.moveDir |
Storm moving direction |
forecast.move360 |
Storm movement direction in azimuth degre |
refer.sources |
Data source and other statements, may be null |
refer.license |
Data license, may be null |
Typhoon level
GBT 19201-2006
Tropical cyclone level | Maximum average wind speed near the bottom center (m/s) | Maximum wind near the bottom center (level) |
---|---|---|
Tropical pressure (TD) | 10.8-17.1 | 6-7 |
Tropical Storm (TS) | 17.2-24.4 | 8-9 |
Severe Tropical Storm (STS) | 24.5-32.6 | 10-11 |
Typhoon (TY) | 32.7-41.4 | 12-13 |
Severe Typhoon (STY) | 41.5-50.9 | 14-15 |
Super Typhoon (SuperTY) | ≥51.0 | 16 or above |