Tropical cyclone

For iOS SDK v4.4+

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