台风最新坐标轨迹接口返回字段全解：list/obj/typhoon_list 与 14 项坐标强度字段
# 台风最新坐标轨迹接口返回字段全解：list/obj/typhoon_list 与 14 项坐标强度字段
> 接口 342 · 免费 · 适用中高级开发者 · 阅读约 7 分钟
## 核心要点
- 三个接入点返回数组名不同：342-1 用 `list`、342-2 用 `obj`、342-3 用 `typhoon_list`，切勿混用。
- 342-1/342-2 每条记录 14 个字段（enname/lat/lng/movedirection/movespeed/name/power/pressure/radius10/radius7/speed/strong/tfid/time）。
- lat/lng 是字符串需转 float；strong 为风力等级描述文本；文档未声明坐标系，上图前需确认。
## Why：这跟我有关系吗
字段名相近、三个接入点数组名不同，是集成时最容易写错的地方。先把返回结构吃透，后面每篇实战都省力。
## What：接口速览
| 接入点 | 返回数组名 | 每条字段数 | 关键字段 |
|------|------|------|------|
| 342-1 当前台风列表 | `list` | 14 | name, enname, lat, lng, strong, tfid, time … |
| 342-2 单个台风详情 | `obj` | 14 | 同上（含连续时刻坐标点） |
| 342-3 台风历史列表 | `typhoon_list` | 4 | tfid, name, en, explain |
## How：一步步调用
```python
import requests
r = requests.post("https://route.showapi.com/342-1",
params={"appKey": "YOUR_APPKEY"},
headers={"content-type": "application/x-www-form-urlencoded"}, timeout=10).json()
rec = r["showapi_res_body"]["list"][0]
for k, v in rec.items():
print(k, type(v).__name__, v) # lat/lng 为 str
```
## 返回示例与解析
```json
{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_id": "ce135f6739294c63be0c021b76b6fbff",
"showapi_res_body": {
"list": [
{
"enname": "Chan-hom", "lat": "26.00", "lng": "125.10",
"movedirection": "北西", "movespeed": "20", "name": "灿鸿",
"power": "16", "pressure": "935", "radius10": "180", "radius7": "450",
"speed": "52", "strong": "超强台风", "tfid": "201509",
"time": "2015-07-10 11:00:00"
},
{
"enname": "Nangka", "lat": "18.30", "lng": "142.70",
"movedirection": "西北西", "movespeed": "10", "name": "浪卡",
"power": "17", "pressure": "920", "radius10": "180", "radius7": "400",
"speed": "60", "strong": "超强台风", "tfid": "201511",
"time": "2015-07-10 08:00:00"
}
],
"ret_code": 0
}
}
```
系统级包裹字段：`showapi_res_code`（整数）、`showapi_res_error`、`showapi_res_id`、`showapi_fee_num`（计费次数）；业务成功另看 `ret_code`。
## 进阶与边界
342-3 仅 4 字段（tfid/name/en/explain），其描述文字称「可形成轨迹数据线」但返回不含坐标，疑似文档描述偏差，以实际返回为准。文档字段描述写「维度」应为「纬度」笔误。
## FAQ
**Q：list、obj、typhoon_list 分别属于哪个接入点？**
342-1→list，342-2→obj，342-3→typhoon_list，三者不可混用。
**Q：lat/lng 是数字还是字符串？**
文档返回示例为字符串（如 "26.00"），使用前需 float() 转换。
**Q：strong 有哪些取值？**
文档仅示例「超强台风」，未给出完整枚举，具体取值以接口返回为准。
**Q：文档写「维度」是不是笔误？**
是，字段含义为纬度(latitude)，文档原词「维度」应为「纬度」笔误。
## 相关能力 / 下一步阅读
- [台风最新坐标轨迹接口：5 分钟接入，获取当前台风列表](https://www.showapi.com/guides/typhoon-track-quickstart-342)
- [台风最新坐标轨迹接口：如何调用当前台风列表（342-1）](https://www.showapi.com/guides/typhoon-track-current-list-342)
- [台风最新坐标轨迹接口：用 tfid 调用单个台风详情（342-2）拉取轨迹数据线](https://www.showapi.com/guides/typhoon-track-detail-342)
- [台风最新坐标轨迹接口：按年份查询台风历史列表（342-3）](https://www.showapi.com/guides/typhoon-track-history-342)
- **本系列共 13 篇**：查看[台风最新坐标轨迹接口官方指南总目录](https://www.showapi.com/guides/typhoon-track-guides-342)
