Typhoon

Data availability

Currently limited to typhoons near the coast of China.

Access Restriction

This API is a premium service available only to enterprise tier developers. Please contact Caiyun Sales to purchase.

Request

• Errors

GET https://singer.caiyunhub.com/v3/typhoon/realtime

Query Parameters

Name	Required	Default	Range	Description
token	Yes	—	—	API token; see Authentication

Request Example

curl "https://singer.caiyunhub.com/v3/typhoon/realtime?token={token}"

Response Example

{
  "typhoons": [
    {
      "id": "202208",
      "name": "米雷",
      "enname": "Meari",
      "active": true,
      "history": [
        {
          "time": 1660240800,
          "longitude": 135.9,
          "latitude": 29.5,
          "radius7": [200, 200, 130, 150],
          "radius10": [],
          "radius12": [],
          "moveSpeed": 19,
          "moveDirection": "北",
          "strong": 2,
          "pressure": 1000,
          "speed": 18,
          "power": 8
        },
        // ...
        {
          "time": 1660284000,
          "longitude": 136.4,
          "latitude": 30.7,
          "radius7": [200, 200, 120, 150],
          "radius10": [],
          "radius12": [],
          "moveSpeed": 22,
          "moveDirection": "北",
          "strong": 2,
          "pressure": 1000,
          "speed": 18,
          "power": 8,
          "jl": " “米雷”将以每小时20公里左右的速度向偏北方向移动，强度有所增强 （下次更新时间为12日17时30分）",
          "ckposition": " 位于西北太平洋洋面，距离日本东京南偏西方向约630公里"
        }
      ],
      "forecast": [
        {
          "source": "中国",
          "points": [
            {
              "time": 1660284000,
              "longitude": 136.4,
              "latitude": 30.7,
              "radius7": [],
              "radius10": [],
              "radius12": [],
              "strong": 2,
              "pressure": 1000,
              "speed": 18,
              "power": 8
            },
            // ...
            {
              "time": 1660456800,
              "longitude": 147.4,
              "latitude": 40.9,
              "radius7": [],
              "radius10": [],
              "radius12": [],
              "strong": 2,
              "pressure": 990,
              "speed": 20,
              "power": 8
            }
          ]
        }
        // ...
      ],
      "name_info": {
        "country_region": "朝鲜",
        "meaning": "回波"
      }
    }
  ]
}

Response Fields

TyphoonInfo

Typhoon entries.

JSONPath	Type	Description
$.typhoons	array<TyphoonInfo>	Typhoon entries
$.typhoons[].id	string	ID
$.typhoons[].name	string	Name
$.typhoons[].enname	string	English name
$.typhoons[].active	boolean	Whether active
$.typhoons[].history	array<TyphoonInfo.PointInfo>	Historical track
$.typhoons[].forecast	array<TyphoonInfo.ForecastInfo>	Forecast track
$.typhoons[].land	array<TyphoonInfo.LandInfo>	Landfall data
$.typhoons[].name_info	TyphoonInfo.NameInfo	Name metadata

TyphoonInfo.ForecastInfo

JSONPath	Type	Description
$.typhoons[].forecast[].source	string	Forecast source country or region
$.typhoons[].forecast[].points	array<TyphoonInfo.PointInfo>	Forecast track points

TyphoonInfo.LandInfo

JSONPath	Type	Description
$.typhoons[].land[].time	number	Landfall timestamp
$.typhoons[].land[].longitude	number	Longitude
$.typhoons[].land[].latitude	number	Latitude
$.typhoons[].land[].strong	TropicalCycloneLevels	Tropical cyclone level
$.typhoons[].land[].info	string	Landfall description
$.typhoons[].land[].landaddress	string	Landfall location

TyphoonInfo.NameInfo

JSONPath	Type	Description
$.typhoons[].name_info.country_region	string	Country or region that provided the name
$.typhoons[].name_info.meaning	string	Name meaning

TyphoonInfo.PointInfo

The points JSONPaths below also apply to points in the history array.

JSONPath	Type	Description
$.typhoons[].forecast[].points[].time	number	Unix timestamp
$.typhoons[].forecast[].points[].longitude	number	Longitude
$.typhoons[].forecast[].points[].latitude	number	Latitude
$.typhoons[].forecast[].points[].radius7	array<number>	Force-7 wind radius in km, ordered NE, SE, NW, SW
$.typhoons[].forecast[].points[].radius10	array<number>	Force-10 wind radius in km, ordered NE, SE, NW, SW
$.typhoons[].forecast[].points[].radius12	array<number>	Force-12 wind radius in km, ordered NE, SE, NW, SW
$.typhoons[].forecast[].points[].moveSpeed	number	Movement speed, km/h
$.typhoons[].forecast[].points[].moveDirection	string	Movement direction
$.typhoons[].forecast[].points[].strong	TropicalCycloneLevels	Tropical cyclone level
$.typhoons[].forecast[].points[].pressure	number	Central pressure, hPa
$.typhoons[].forecast[].points[].speed	number	Wind speed, m/s
$.typhoons[].forecast[].points[].power	number	Wind force level

Optional fields

PointInfo may include jl (track description) and ckposition (position description). Treat both as optional.

TropicalCycloneLevels

Tropical cyclone levels.

Name	Number	Description
UNKNOWN_CYCLONE_LEVEL	0	Unknown
DEPRESSION	1	Tropical depression
STROM	2	Tropical storm
SEVERE_STORM	3	Severe tropical storm
TYPHOON	4	Typhoon
SEVERE_TYPHOON	5	Severe typhoon
SUPER_SEVERE_TYPHOON	6	Super typhoon