Jian Project GET 数据服务

HTTPS GET UTF-8 JSON 每 IP ≥1 次/秒

全国雷达、云图、未来降水、日本雷达、实时台风、全球风场与全国气象站快照。适合学习与对接调试。

基础地址：https://api.sismotide.top/get

请求方式：GET https://api.sismotide.top/get/[路径]，例如 https://api.sismotide.top/get/radar

鉴权：不需要访问令牌。防滥用见 频率限制。

编码：UTF-8 JSON

说明：本页为 GET API 字段说明；业务数据为 HTTPS GET JSON。WebSocket 文档见 /api/。

请求地址

类型 地址
单端点 https://api.sismotide.top/get/[路径]

可用路径

侧栏「GET 路径」为字段说明（本页 #hash）；JSON 接口路径与下表一致。

路径 source 说明 文档
/get/radar radar 全国雷达矢量图 查看
/get/radar-japan radar-japan 日本雷达矢量图 查看
/get/cloud cloud 实况云图 查看
/get/precip-forecast precip-forecast 未来降水图（period=1h/6h/24h） 查看
/get/typhoon typhoon 实时台风 查看
/get/wind wind 全球实时风场 查看
/get/station station 全国气象站（type 必填） 查看

基础瓦片地图

底图 XYZ 瓦片由独立域名提供（与 Fan Studio tilemap 用法兼容），不走本页 JSON /get/*。

基础地址：https://tilemap.sismotide.top/{source}/{z}/{x}/{y}

完整说明（左右分栏文档）：tilemap.sismotide.top

通用约定

  • 图片类响应常见结构为 status + time + size + image；无可靠地理边界时不返回 bounds（不编造）。日本雷达响应含 bounds。
  • size 为图像像素尺寸；time 为业务时次（北京时间）。
  • 缺失的字段省略，不用 0 或空串补全。
  • 响应格式细则见 消息协议；各路径字段见侧栏对应章节。
  • 本服务面向学习研究用途，不保证稳定性，不得替代官方渠道。

频率限制

GET 数据服务不需要访问令牌。为防滥用，按客户端真实 IP 做请求频率限制（经 CDN 时取 CDN / X-Forwarded-For 规则与站内一致）。

默认限额

项目 规则
最小间隔 同一客户端 IP 对业务路径至少间隔 1 秒 1 次
计入路径 /get/radar、/get/cloud、/get/precip-forecast、/get/typhoon、/get/wind、/get/station、/get/radar-japan 等业务 GET
不计频 /health 健康检查不计入上述间隔

超限响应

超过频率限制时返回 HTTP 429，正文为 JSON：

请求过于频繁
{
  "error": "请求过于频繁，请至少间隔 1 秒"
}

对接建议

  • 客户端应对图片 / 列表结果做本地缓存，避免无意义轮询。
  • 收到 429 后应退避重试，勿瞬时连打。
  • 更多说明见 服务条款 与 隐私政策。

消息协议

全部为 HTTPS GET，响应 Content-Type: application/json; charset=utf-8，UTF-8 JSON。

图片类

雷达 / 云图 / 降水：status + time + size + image

数组类

台风：顶级 JSON 数组

风场类

全球风场：status + time + source + data[u,v]

列表类

气象站：time + count + data[]

图片类成功示例

适用于 /get/radar、/get/cloud、/get/precip-forecast、/get/radar-japan（日本雷达另含 bounds）。

图片快照
{
  "status": "success",
  "time": "2026-09-22 10:36:00",
  "size": {
    "width": 1349,
    "height": 1208
  },
  "image": "data:image/png;base64,..."
}

错误响应

参数错误多为 HTTP 400；取数失败多为 502；频率超限为 429。正文统一为：

错误
{
  "error": "错误说明"
}

查询参数

路径 参数 说明
/get/precip-forecast period 1h / 6h / 24h，缺省 24h
/get/station type 必填；temperature 等要素或 all

各路径完整字段见侧栏对应章节。

全国雷达矢量图 GET API 字段说明文档

请求地址：https://api.sismotide.top/get/radar

数据范围：最新全国雷达矢量图（透明底图 Base64）

示例数据

{
  "status": "success",
  "time": "2026-09-22 10:36:00",
  "size": {
    "width": 1349,
    "height": 1208
  },
  "image": "data:image/png;base64,..."
}

字段说明

字段名类型必填说明
status string 是 成功时为 success
time string 是 雷达数据时间（北京时间，YYYY-MM-DD HH:mm:ss）
size object 是 图像像素尺寸
size.width integer 是 宽度（像素）
size.height integer 是 高度（像素）
image string 是 data URI（Base64 图片）
bounds object 否 地理边界；未提供时省略，不编造

注意事项

  • 请求方法 GET；无需访问令牌。
  • 同一客户端 IP 建议至少间隔 1 秒请求一次；超限返回 HTTP 429。
  • time 为业务时次（北京时间，YYYY-MM-DD HH:mm:ss）。
  • size 为图像像素尺寸。

日本雷达矢量图 GET API 字段说明文档

请求地址：https://api.sismotide.top/get/radar-japan

数据来源：日本气象厅（JMA）降水 nowcast

数据范围：日本附近高分辨率降水雷达最新实况帧

示例数据

{
  "status": "success",
  "time": "2026-09-22 10:25:00",
  "bounds": {
    "sw": [20.63, 118.13],
    "ne": [45.71, 153.28]
  },
  "size": {
    "width": 2304,
    "height": 2304
  },
  "image": "data:image/png;base64,..."
}

字段说明

字段名类型必填说明
status string 是 成功时为 success
time string 是 有效时刻转北京时间（YYYY-MM-DD HH:mm:ss）
bounds object 是 图像覆盖范围的地理边界
bounds.sw array 是 西南角 [纬度, 经度]
bounds.ne array 是 东北角 [纬度, 经度]
size object 是 图像像素尺寸
size.width integer 是 宽度（像素）
size.height integer 是 高度（像素）
image string 是 data URI（透明背景 PNG Base64）

注意事项

  • 请求方法 GET；无需访问令牌。
  • 同一客户端 IP 建议至少间隔 1 秒请求一次；超限返回 HTTP 429。
  • bounds 为图像地理覆盖范围，非人工编造。

实况云图 GET API 字段说明文档

请求地址：https://api.sismotide.top/get/cloud

数据范围：最新 FY4B 可见光全国实况云图（Base64）

示例数据

{
  "status": "success",
  "time": "2026-09-22 10:00:00",
  "size": {
    "width": 1200,
    "height": 900
  },
  "image": "data:image/jpeg;base64,..."
}

字段说明

字段名类型必填说明
status string 是 成功时为 success
time string 是 云图时间（北京时间，YYYY-MM-DD HH:mm:ss）
size object 是 图像像素尺寸
size.width integer 是 宽度（像素）
size.height integer 是 高度（像素）
image string 是 data URI（Base64 图片）
bounds object 否 地理边界；未提供时省略

注意事项

  • 请求方法 GET；无需访问令牌。
  • 同一客户端 IP 建议至少间隔 1 秒请求一次；超限返回 HTTP 429。

未来降水图 GET API 字段说明文档

请求地址：https://api.sismotide.top/get/precip-forecast?period=24h

数据范围：最新全国降水量预报图（Base64）；period=1h/6h/24h（1h 无对应预报产品时回落近 1 小时实况）

示例数据

{
  "status": "success",
  "time": "2026-09-22 08:00:00",
  "size": {
    "width": 860,
    "height": 662
  },
  "image": "data:image/jpeg;base64,..."
}

字段说明

字段名类型必填说明
status string 是 成功时为 success
time string 是 产品时间（北京时间，YYYY-MM-DD HH:mm:ss）
size object 是 图像像素尺寸
size.width integer 是 宽度（像素）
size.height integer 是 高度（像素）
image string 是 data URI（Base64 图片）
bounds object 否 地理边界；未提供时省略

注意事项

  • 请求方法 GET；查询参数 period：1h / 6h / 24h，缺省为 24h。
  • 6h、24h 为降水量预报最新帧；period=1h 在无对应预报产品时回落为近 1 小时降水实况图。
  • 无需访问令牌；同一客户端 IP 建议至少间隔 1 秒请求一次。

实时台风 GET API 字段说明文档

请求地址：https://api.sismotide.top/get/typhoon

数据范围：当前西太平洋及南海活跃台风实况

示例数据

[
  {
    "id": "202625",
    "name": "杜鹃",
    "name_en": "DUJUAN",
    "latitude": 38.2,
    "longitude": 147.4,
    "moveDirection": "东北东",
    "moveSpeed": 50,
    "power": 10,
    "pressure": 985,
    "windSpeed": 25,
    "type": "强热带风暴",
    "radius7": "400|300|300|300",
    "updateTime": "2026-09-22 08:00:00",
    "points": []
  }
]

字段说明

字段名类型必填说明
id string 是 台风编号（如 202625）
name string 否 中文名
name_en string 否 英文名
latitude number 否 中心纬度
longitude number 否 中心经度
moveDirection string 否 移向
moveSpeed number 否 移速 km/h
power integer 否 中心附近最大风力等级
pressure integer 否 中心气压 hPa
windSpeed number 否 中心附近最大风速 m/s
type string 否 强度等级文案
radius7 number|string 否 七级风圈；四象限时为原样字符串如 400|300|300|300
radius10 number|string 否 十级风圈；规则同 radius7
updateTime string 否 最新实况点时间（北京时间）
points array 否 完整实况路径点（有则保留）

注意事项

  • 响应体为 JSON 数组；无活跃台风时为 []。
  • 缺字段则省略，不填 0 或空串。
  • 四象限风圈不压成单个假半径。
  • 请求方法 GET；无需访问令牌；同一客户端 IP 建议至少间隔 1 秒。

全球实时风场 GET API 字段说明文档

请求地址：https://api.sismotide.top/get/wind

数据范围：全球近地面（约 10m）风场 U/V 分量格点

示例数据

{
  "status": "success",
  "time": "2026-09-22 15:00:00",
  "source": "gfs",
  "resolution_deg": 1,
  "level": "10m",
  "nx": 360,
  "ny": 181,
  "data": [
    {
      "header": {
        "parameterNumber": 2,
        "parameterNumberName": "U-component_of_wind",
        "nx": 360,
        "ny": 181,
        "lo1": 0,
        "la1": 90,
        "dx": 1,
        "dy": 1
      },
      "data": [-2.15, 0.3, "…"]
    },
    {
      "header": {
        "parameterNumber": 3,
        "parameterNumberName": "V-component_of_wind"
      },
      "data": [1.2, -0.5, "…"]
    }
  ]
}

字段说明

字段名类型必填说明
status string 是 成功时为 success
time string 是 风场有效时刻（北京时间）
source string 是 固定为 gfs
resolution_deg number 是 水平分辨率（度），当前为 1
level string 是 高度层，如 10m
nx integer 是 经向格点数
ny integer 是 纬向格点数
data array 是 长度 2：依次为 U、V 分量，形态兼容 leaflet-velocity / grib2json
data[].header object 是 格点头：nx/ny/lo1/la1/lo2/la2/dx/dy 等
data[].data array 是 按行主序展平的风速分量 m/s；缺测为 null

注意事项

  • 请求方法 GET；无需访问令牌。
  • 同一客户端 IP 建议至少间隔 1 秒请求一次；超限返回 HTTP 429。
  • 格点自北向南、自西向东（la1=90 → la2=-90，lo1=0 → lo2=359）。
  • 响应体积较大（约数 MB），请客户端本地缓存，勿高频轮询。
  • data 数组可直接交给 leaflet-velocity 等粒子风场组件

全国气象站 GET API 字段说明文档

请求地址：https://api.sismotide.top/get/station?type=temperature

数据范围：最新全国气象站指定要素实时数据（包含台湾省）；type 必填，type=all 返回该站全部可用要素

示例数据

{
  "time": "2026-09-22 11:00",
  "count": 3200,
  "data": [
    {
      "sta_name": "北京",
      "stationid": "54511",
      "lat": "39.8",
      "lon": "116.47",
      "val": "25.8"
    },
    {
      "sta_name": "臺北",
      "stationid": "466920",
      "lat": "25.039439",
      "lon": "121.506628",
      "val": "29.5"
    }
  ]
}

字段说明

字段名类型必填说明
time string 是 数据时次（北京时间）
count integer 是 本响应 data 条数
data array 是 站点数组
sta_name string 是 站名
stationid string 是 站号
lat string 是 纬度
lon string 是 经度
val string 条件 单要素查询时的数值；type=all 时不使用此字段
fx string 否 风向角度（风速类可能出现）
temperature string 否 type=all 时的气温
pressure string 否 type=all 时的气压
humidity string 否 type=all 时的相对湿度
windspeed string 否 type=all 时的风速
rain string 否 type=all 时的降水
visibility string 否 type=all 时的能见度

注意事项

  • 查询参数 type 必填：temperature / pressure / windspeed / maxwindspeed24h / humidity / visibility / rain / all。
  • type=all 时每站展开各要素字段；缺失的字段省略。
  • 覆盖范围含台湾省站点；同站号去重后保留一条。
  • 台湾站号示例：466920（臺北）、C0A530 等；缺测值（如 -99）不会出现在响应中。
  • maxwindspeed24h：当前无可靠 24 小时最大风速时 data 可能为空数组。
  • 请求方法 GET；无需访问令牌；同一客户端 IP 建议至少间隔 1 秒。