气旋
数据限制
目前只支持中国近海台风
访问限制
本部分 API 属于增值服务，开发者 Token 需要额外开通权限，请联系商务
API
bash
curl "https://singer.caiyunhub.com/v3/typhoon/realtime?token={token}"返回结构
jsonc
{
"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 | Wind Speed Range (m/s) | Wind Force Level |
|---|---|---|---|---|
| UNKNOWN_CYCLONE_LEVEL | 0 | |||
| DEPRESSION | 1 | 热带低压 | 10.8~17.1 | 6~7级 |
| STROM | 2 | 热带风暴 | 17.2~24.4 | 8~9级 |
| SEVERE_STORM | 3 | 强热带风暴 | 24.5~32.6 | 10~11级 |
| TYPHOON | 4 | 台风 | 32.7~41.4 | 12~13级 |
| SEVERE_TYPHOON | 5 | 强台风 | 41.5~50.9 | 14~15级 |
| SUPER_SEVERE_TYPHOON | 6 | 超强台风 | ≥51.0 | 16级或以上 |
台风风圈等级对比
| 风圈等级 | 主要意义 | 典型范围 | 出现条件 |
|---|---|---|---|
| 7级风圈 | 台风外围影响范围, 航运/防风预警常用 | 100-500 km | 热带风暴级及以上 |
| 10级风圈 | 强风区范围, 破坏力较大 | 50-200 km | 强热带风暴及以上 |
| 12级风圈 | 台风核心暴风圈, 灾害最重 | 30-100 km | 台风级及以上 |
- 低等级系统 (热带低压) → 没有风圈或没有7级风圈
- 热带风暴 → 基本都有7级风圈, 可能没有10级风圈
- 强热带风暴 → 可能有10级风圈, 但未必有12级
- 台风/强台风/超强台风 → 通常都有 7/10/12级风圈, 且半径范围随强度增强而扩大