气旋

提示

数据限制 目前只支持中国近海台风

提示

访问限制 本部分 API 属于增值服务，开发者 Token 需要额外开通权限，请联系商务

API

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

返回结构

sample.json

{
  "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": "回波"
      }
    }
  ]
}

TyphoonInfo

台风返回结构

Field	Type	Label	Description
id	string		编号
name	string		名称
enname	string		英文名
active	bool		台风活跃
history	TyphoonInfo.PointInfo	repeated	历史路径
forecast	TyphoonInfo.ForecastInfo	repeated	预报路径
land	TyphoonInfo.LandInfo	repeated	登陆信息
name_info	TyphoonInfo.NameInfo

TyphoonInfo.ForecastInfo

Field	Type	Label	Description
source	string		预报的数据来源国家/地区
points	TyphoonInfo.PointInfo	repeated	预报的路径

TyphoonInfo.LandInfo

Field	Type	Label	Description
time	int64		登陆时间戳
longitude	float		纬度
latitude	float		经度
strong	TropicalCycloneLevels		气旋/飓风/台风等级
info	string		台风“暹芭”于 02 日 15 时在广东电白沿海登陆
landaddress	string		广东电白沿海

TyphoonInfo.NameInfo

Field	Type	Label	Description
country_region	string		提供这个名字的国家或地区
meaning	string		含义

TyphoonInfo.PointInfo

Field	Type	Label	Description
time	int64		时刻 Unix 时间戳
longitude	float		经度
latitude	float		纬度
radius7	int32	repeated	7 级风圈 km 半径, [东北, 东南, 西北, 西南]
radius10	int32	repeated	10 级风圈 km 半径, [东北, 东南, 西北, 西南]
radius12	int32	repeated	12 级风圈 km 半径, [东北, 东南, 西北, 西南]
moveSpeed	float		移动速度, km/h
moveDirection	string		移动方向
strong	TropicalCycloneLevels		气旋/飓风/台风等级
pressure	float		中心气压，百帕
speed	float		风速，m/s
power	int32		风力等级

TropicalCycloneLevels

TropicalCyclone 热带气旋

不同地方气旋的名字不一样，中国近海是台风(typhoon)，美国是飓风(hurricane)

Name	Number	Description
UNKNOWN_CYCLONE_LEVEL	0
DEPRESSION	1	热带低压
STROM	2	热带风暴
SEVERE_STORM	3	强热带风暴
TYPHOON	4	台风
SEVERE_TYPHOON	5	强台风
SUPER_SEVERE_TYPHOON	6	超强台风