台风详情
查询台风详细路径数据,包含实时位置、预报路径、风圈半径、移动方向等
GET
https://api.tinyaii.cn/v1/typhoon/view
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| id | integer | 必填 | 台风ID(从台风列表接口获取) | — |
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| data.info.name_cn | string | 中文名 |
| data.info.status | string | 状态:活跃/已停止 |
| data.track_count | integer | 路径点数量 |
| data.tracks[].time | string | 观测时间 |
| data.tracks[].lng | number | 经度 |
| data.tracks[].lat | number | 纬度 |
| data.tracks[].pressure | integer | 中心气压(hPa) |
| data.tracks[].wind_speed | integer | 最大风速(m/s) |
| data.tracks[].level | string | 强度等级(中文) |
| data.tracks[].move_direction | string | 移动方向(中文) |
| data.tracks[].move_speed | integer | 移动速度(km/h) |
| data.tracks[].wind_radius | array | 风圈半径数据 |
| data.tracks[].forecast | object | 各机构预报路径(中央气象台/日本气象厅等) |
返回示例
{
"code": 200,
"data": {
"info": {
"id": 3257931,
"name_cn": "巴威",
"name_en": "BAVI",
"number": "2609",
"status": "活跃"
},
"track_count": 49,
"tracks": [
{
"time": "202607080000",
"lng": 134.1,
"lat": 16.9,
"pressure": 915,
"wind_speed": 62,
"level": "超强台风",
"move_direction": "西西北",
"move_speed": 15,
"wind_radius": [
{
"level": "7级风圈",
"radius_ne": 500,
"radius_se": 350,
"radius_sw": 400,
"radius_nw": 500
}
],
"forecast": {
"中央气象台": [
{
"hour": 24,
"lng": 131.5,
"lat": 18.2,
"pressure": 930,
"wind_speed": 55,
"level": "强台风"
}
]
}
}
]
},
"message": "success"
}
调用示例
curl "https://api.tinyaii.cn/v1/typhoon/view?id=1" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch("https://api.tinyaii.cn/v1/typhoon/view?id=1", {
headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await res.json());import requests
resp = requests.get(
"https://api.tinyaii.cn/v1/typhoon/view",
params={"id": "1"},
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=10,
)
print(resp.json())把 YOUR_API_KEY 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。