台风实时路径

API

台风实时路径：西北太平洋 / 南海台风实时监测，返回活跃台风列表、单个台风完整移动路径（实况点 + 官方预报点）及风云卫星云图。数据含台风编号、中英文名、等级、经纬度、中心气压、最大风速、移动方向与逐时路径点； action=all 一次取活跃台风 + 最新云图。适用于防灾预警…

接入文档

由极数本源提供·更新于今天

先试用，再接接口

不用写代码。打开工具页跑一遍台风实时路径，看清结果再来订阅。

打开台风实时路径

2.6万

累计调用

102ms

平均响应

100.00%

服务可用性

1,000 次/日

免费额度

访问限制

查看更多方案 →

我的方案免费方案升级套餐

QPS 3

今日已用 … / 1,000 次/日…

登录并携带 API Key 可使用上方免费额度；会员额度见下方各档

无 Key 调用

每日 500 次 · QPS 2

登录免费

当前方案

每日 1,000 次 · QPS 3

黄金会员

每日 50,000 次 · QPS 10

钻石会员

每日 100,000 次 · QPS 30

企业会员

企业接口额度 · QPS 120

AI 文档

把这个地址发给 AI，就能生成调用代码

https://apizero.cn/aidocs/typhoon/raw.md

打开文档

接入文档

打开

在线工具

打开台风实时路径

接口请求地址

https://v1.apizero.cn/api/typhoon

接口请求方式

POST

请求参数格式

APPLICATION/JSON

接口返回格式

APPLICATION/JSON

接口请求示例

https://v1.apizero.cn/api/typhoon

接口信息备注

公开数据，支持匿名调用（匿名 500 次/日），登录后 1000 次/日。

请求参数说明

名称	类型	说明
action（操作）	string	可选 · 操作类型：list 活跃台风列表 / detail 单台风详情+路径 / images 卫星云图 / all 综合 · 默认 list
id	string	可选 · 台风 ID（action=detail 必填，从 list 获取） · 示例：3257931
status	string	可选 · list 用：active 仅活跃 / all 含停编 · 默认 active
limit（条数）	int	可选 · images 用：云图数量（1-50） · 默认 10

请求头说明

名称	类型	说明
Authorization	string	可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

返回字段说明

名称

类型

说明

typhoons

array

台风列表（list/all）：每项含 id/tc_num/name_cn/name_en/description/state/is_active

typhoons[]

string

typhoons 的一项

active_count

number

活跃台风数量（list）

points

array

路径点（detail）：time_utc/time_cst/grade/longitude/latitude/pressure/wind_speed/wind_dir/type（analysis 实况 / forecast 预报）

time_cst	string	time_cst
grade	string	grade
longitude	number	经度
latitude	number	纬度
pressure	number	pressure
wind_speed	number	wind_speed
type	string	类型

current

object

最新实况点（detail）

time_cst	string	time_cst
grade	string	grade
longitude	number	经度
latitude	number	纬度
pressure	number	pressure
wind_speed	number	wind_speed
wind_dir	string	wind_dir
type	string	类型

images

array

卫星云图（images/all）：每项含 time/time_str/url

images[]

string

单张图片 URL

tips

string

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "id": "3257931",
    "tc_num": "2609",
    "name_cn": "巴威",
    "name_en": "BAVI",
    "is_active": true,
    "current": {
      "time_cst": "2026-07-02 08:00",
      "grade": "热带风暴",
      "longitude": 118.5,
      "latitude": 14.2,
      "pressure": 1002,
      "wind_speed": 18,
      "wind_dir": "西西北",
      "type": "analysis"
    },
    "point_count": 15,
    "points": [
      {
        "time_cst": "2026-07-02 08:00",
        "grade": "热带风暴",
        "longitude": 118.5,
        "latitude": 14.2,
        "pressure": 1002,
        "wind_speed": 18,
        "type": "analysis"
      }
    ]
  },
  "request_id": "abc123",
  "tips": "极数本源 · https://apizero.cn"
}

免责声明

台风数据来源于官方公开发布，仅供参考；实际以气象主管部门权威预报为准，请勿仅依据本接口做防灾决策。

加载接口文档…

名称

类型

说明

action（操作）

string

可选 · 操作类型：list 活跃台风列表 / detail 单台风详情+路径 / images 卫星云图 / all 综合 · 默认 list

string

可选 · 台风 ID（action=detail 必填，从 list 获取） · 示例：3257931

status

string

可选 · list 用：active 仅活跃 / all 含停编 · 默认 active

limit（条数）

int

可选 · images 用：云图数量（1-50） · 默认 10

名称

类型

说明

Authorization

string

可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

{ "code": 0, "msg": "成功", "data": { "id": "3257931", "tc_num": "2609", "name_cn": "巴威", "name_en": "BAVI", "is_active": true, "current": { "time_cst": "2026-07-02 08:00", "grade": "热带风暴", "longitude": 118.5, "latitude": 14.2, "pressure": 1002, "wind_speed": 18, "wind_dir": "西西北", "type": "analysis" }, "point_count": 15, "points": [ { "time_cst": "2026-07-02 08:00", "grade": "热带风暴", "longitude": 118.5, "latitude": 14.2, "pressure": 1002, "wind_speed": 18, "type": "analysis" } ] }, "request_id": "abc123", "tips": "极数本源 · https://apizero.cn" }