台风最新坐标轨迹接口：按年份查询台风历史列表（342-3）
# 台风最新坐标轨迹接口：按年份查询台风历史列表（342-3）
> 接入点 342-3 · 免费 · POST/GET · 适用气象分析/研究者 · 阅读约 5 分钟
## 核心要点
- 342-3 可选参数 year（yyyy，不填默认当前年份），返回 showapi_res_body.typhoon_list。
- typhoon_list 每项仅 4 字段：tfid / name(中文名) / en(英文名) / explain(名字来源)。
- 注意：本接入点返回字段比其描述文字精简，不含坐标，以实际返回为准。
## Why：这跟我有关系吗
做年度台风统计、科普「这个台风名字什么意思」时很实用；但别指望它直接给轨迹坐标。
## What：接口速览
| 项目 | 说明 |
|------|------|
| 接入点 | 342-3 台风历史列表 |
| 可选参数 | `year`（字符串，格式 yyyy，默认当前年份） |
| 返回数组 | `showapi_res_body.typhoon_list` |
| 每条字段 | 4 个：tfid / name / en / explain |
## How：一步步调用
### Python
```python
import requests
resp = requests.post(
"https://route.showapi.com/342-3",
params={"appKey": "YOUR_APPKEY"},
data={"year": "2024"}, # 可选，不传默认当前年份
headers={"content-type": "application/x-www-form-urlencoded"},
timeout=10,
)
data = resp.json()
for t in data["showapi_res_body"]["typhoon_list"]:
print(t["tfid"], t["name"], t["en"], t.get("explain", ""))
```
### cURL
```bash
curl -X POST "https://route.showapi.com/342-3?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "year=2024"
```
## 返回示例与解析
```json
{
"showapi_res_code": 0,
"showapi_res_body": {
"typhoon_list": [
{"tfid": "201509", "name": "灿鸿", "en": "Chan-hom", "explain": "一种花"},
{"tfid": "201511", "name": "浪卡", "en": "Nangka", "explain": "一种水果"}
],
"ret_code": 0
}
}
```
## 进阶与边界
文档对 342-3 的描述称「可形成轨迹数据线」，但 OpenAPI 实际 schema 仅含 id/名称/英文名/来源，疑似描述偏差；如需要轨迹请用 342-2。
## FAQ
**Q：year 不传会怎样？**
默认查询当前年份。
**Q：为什么 342-3 没有坐标？**
其返回 schema 仅含 tfid/name/en/explain，接口描述与结构不一致，以实际返回为准；要坐标请用 342-2。
**Q：能查到某台风的命名来源吗？**
可以，explain 字段即名字来源。
## 相关能力 / 下一步阅读
- [台风最新坐标轨迹接口：如何调用当前台风列表（342-1）](https://www.showapi.com/guides/typhoon-track-current-list-342)
- [台风最新坐标轨迹接口返回字段全解：list/obj/typhoon_list 与 14 项坐标强度字段](https://www.showapi.com/guides/typhoon-track-response-fields-342)
- [台风最新坐标轨迹接口：坐标、风力等级与影响半径如何驱动业务判断](https://www.showapi.com/guides/typhoon-track-data-model-342)
- **本系列共 13 篇**：查看[台风最新坐标轨迹接口官方指南总目录](https://www.showapi.com/guides/typhoon-track-guides-342)
