返回 Skill 列表
extension
分类: 数据与分析无需 API Key

台风实时查询

台风实时查询是一款面向台风季的实用技能,数据源为中央气象台官方接口(typhoon.nmc.cn),权威、实时、免密钥。 查台风:一句话问「现在有几个台风」「白海豚到哪了」「台风最新强度和移动方向」,技能即列出当前活动台风或单个台风的最新定位、强度、气压、风速与移动趋势。 画地图:一句「画一张台风轨迹图」,技能在本地服务端抓取数据并生成自包含的中文交互地图(Leaflet),路径按强度分段着色,预报用虚线延伸,并叠加 7/10/12 级风圈、24/48 小时登陆预警警戒线、中文城市/港口标注。 看回放:底部时间轴支持滑块拖拽与「播放」按钮,按时间回放台风的移动过程;点击任意路径点弹出完整气象卡片。

person作者: user_31264f55hubcommunity

台风实时查询(中央气象台 nmc.cn)

Overview

提供基于中央气象台官方接口的台风实时查询与轨迹可视化能力,覆盖西北太平洋与南海海域。 技能聚焦当前活动台风,可列出正在活动的台风、按编号/英文名/中文名查询单个台风的最新定位、强度、 移动方向/速度、路径统计及近期路径点,并能一键生成带中文底图的交互轨迹地图。数据权威、免密钥、实时。

When to Use

  • 用户询问「现在有几个台风」「当前活动台风」「正在生成的台风」
  • 用户想知道某个台风「到哪了」「最新位置」「强度多少」「往哪移动」
  • 用户要求查询台风路径、命名含义、编号(如 2613 / DOLPHIN / 白海豚)
  • 用户提到台风预警、台风动态、西北太平洋/南海热带气旋
  • 用户要求「画一张台风轨迹图」「把路径画出来」「生成台风地图」

How to Use

脚本位于 scripts/,仅依赖 Python 标准库(urllib),无需安装第三方包。所有调用通过 Bash 工具执行。 使用前设定两个变量(按本机情况替换):

PY=python3                                  # 或指向本机 Python 3 可执行文件(绝对路径)
SKILL=<技能安装目录>/typhoon-query          # 例如 ~/.workbuddy/skills/typhoon-query

说明:本环境使用托管 Python,路径形如 C:/Users/18339/.workbuddy/binaries/python/versions/3.13.12/python.exe(Windows) 或 ~/.workbuddy/binaries/python/versions/3.13.12/python.exe(macOS/Linux)。 发布版不依赖固定路径,直接用 python3 即可。

命令模式(scripts/typhoon.py)

| 调用方式 | 作用 | |---------|------| | python $SKILL/scripts/typhoon.py | 默认:列出当前正在活动的台风(status=start) | | python $SKILL/scripts/typhoon.py --all | 列出本年度全部台风及状态(活动/停止) | | python $SKILL/scripts/typhoon.py --id <ID> | 按台风 ID 查询完整详情 | | python $SKILL/scripts/typhoon.py --name <编号/英文名/中文名> | 按名称匹配查询详情 | | 上述任意命令加 --json | 输出原始 JSON 数据(便于二次处理/绘图) |

典型执行示例

# 1) 当前有没有活动的台风?
$PY $SKILL/scripts/typhoon.py

# 2) 今年所有台风一览
$PY $SKILL/scripts/typhoon.py --all

# 3) 查白海豚(DOLPHIN / 2613)最新位置与路径
$PY $SKILL/scripts/typhoon.py --name DOLPHIN
$PY $SKILL/scripts/typhoon.py --id 3279904

# 4) 取原始 JSON(用于画路径图、接入其他工具)
$PY $SKILL/scripts/typhoon.py --name 白海豚 --json

画实时轨迹图(交互地图,scripts/build_map.py)

脚本在服务端抓取数据并渲染为自包含 Leaflet HTML(避开浏览器 CORS), 路径按强度分段着色、标注最新位置、黄色虚线为官方 BABJ 预报。生成后用 present_files 打开预览。

# 默认取当前活动台风,输出到 ./typhoon-track-map/index.html
$PY $SKILL/scripts/build_map.py

# 指定台风(编号/英文名/中文名)与输出路径
$PY $SKILL/scripts/build_map.py --name DOLPHIN
$PY $SKILL/scripts/build_map.py --name 2613 --out C:/path/to/map.html

地图特性:

  • 高德中文瓦片底图(国家/城市/海洋均为中文注记),离线时仍显示轨迹线与标注,仅缺背景地图。
  • 路径点 + 预报点做 WGS-84 → GCJ-02 纠偏,与高德底图对齐(百米级偏移,海域内可忽略)。
  • 7/10/12 级风圈(nmc 真实数据)+ 14/17 级风圈(按 12 级经验估算,未达等级不画)。
  • 24 小时 / 48 小时登陆预警警戒线(东经 124° / 132°)。
  • 时间轴滑块 + 播放/暂停,按时间回放台风移动。
  • 路径点/预报点点击弹出完整气象卡片(风力等级、气压、风速、移动方向/速度)。
  • 中文城市/港口 POI 标注层(右上角图层开关可显隐)。

输出字段说明(详情模式)

  • 最新定位:时间、经纬度、强度等级(中文+代码)、中心气压(hPa)、最大风速(m/s)、移动方向/速度
  • 路径统计:定位点数量、时间跨度、经纬度范围、最低气压、最高风速
  • 最近路径点:近 8 个定位点的时间/经纬度/强度/气压/风速表格

强度等级映射

TD=热带低压 · TS=热带风暴 · STS=强热带风暴 · TY=台风 · STY=强台风 · SuperTY=超强台风

失败处理

  • 若出现「获取台风列表失败 / 详情失败」,多为网络或接口临时不可用: 重试一次;仍失败则如实告知用户当前无法获取实时数据。
  • 「未找到匹配」说明名称/编号不正确,建议先运行默认或 --all 查看可用台风。
  • 数据为 UTC+8 时间,定位经纬度为北纬(N)/东经(E)。

Notes

  • 接口地址:http://typhoon.nmc.cn/weatherservice/typhoon/jsons/{list_default | view_<id>} (JSONP 包裹,脚本已自动剥离)。
  • 本技能定位「当前活动」查询;如需历史台风归档(按年份回溯),应扩展脚本或另建技能。
  • 请勿将接口用作高频轮询,避免给官方服务器造成压力;按需查询即可。
  • 许可证:MIT(可免费用于任何用途)。