Tropical cyclone

For iOS SDK v4.6+

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 Atlantic
  • EP Eastern Pacific
  • NP NorthWest Pacific
  • SP SouthWestern Pacific
  • NI North Indian North Indian Ocean
  • SI 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

API last update time

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?
1 Active
0 Stopped

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

API last update time

fxLink

Responsive web page of this data, for embedded in website or APP

isActive

Is it an active storm?
1 Active
0 Stopped

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

API last update time

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