PTWC 海啸预警 · WebSocket 数据接口文档

概述

通过 WebSocket 连接 wss://sismotide.top/Ptwc，可实时接收 PTWC 推送的海啸相关信息。服务会在事件产生时推送 initial 初报，若有更新则推送 update 消息，并定期发送 heartbeat 心跳包以维持连接。初报与更新包含地震基本参数以及海啸信息声明（headline、event、severity、certainty、urgency、description、onset、expires 等）。

消息类型

📦 Initial 初报

海啸信息声明首次发布，含地震参数与海啸影响说明、生效与过期时间等。

🔄 Update 更新

对已有海啸信息进行修正的后续报告，字段结构与 initial 完全一致。

💓 Heartbeat 心跳

定期发送的心跳包，用于检测连接是否仍然存活。

详细字段说明

Initial 消息

Update 消息

Heartbeat 消息

Initial 初报消息

示例

{
  "type": "initial",
  "data": {
    "eventId": "PHEB-1-26072050",
    "shockTime": "2026-03-13 03:16:18",
    "longitude": -155.369,
    "latitude": 19.127,
    "placeName": "OFF THE KAU COAST OF THE BIG ISLAND",
    "magnitude": 4.2,
    "depth": 31,
    "headline": "LOCAL TSUNAMI INFORMATION STATEMENT",
    "event": "Tsunami Information",
    "severity": "Minor",
    "certainty": "Unlikely",
    "urgency": "Unknown",
    "description": "LOCAL TSUNAMI INFORMATION STATEMENT - Event details: Preliminary magnitude 4.2 (Ml) earthquake / Lat: 19.127, Lon: -155.369 at 2026-03-13T03:16:18Z",
    "onset": "2026-03-13 03:19:21",
    "expires": "2026-03-13 04:19:21",
    "web": "http://www.tsunami.gov/events/PHEB/2026/03/13/26072050/1/WEHW42/WEHW42.txt",
    "senderName": "NWS PACIFIC TSUNAMI WARNING CENTER HONOLULU HI",
    "magnitudeType": "Ml"
  },
  "md5": "972d364a7cc29a662fe50d1490b21320"
}

外层字段

字段	类型	必填	说明
`type`	string	是	消息类型，此处为 `"initial"`
`data`	object	是	海啸信息与地震参数的详细对象
`md5`	string	是	消息内容校验 MD5 值，用于去重或校验

`data` 对象字段

字段	类型	必填	说明
`eventId`	string	是	事件唯一标识符，如 `PHEB-1-26072050`
`shockTime`	string	是	发震时间，格式如 `YYYY-MM-DD HH:MM:SS`
`longitude`	number	是	震中经度（十进制度），西经为负
`latitude`	number	是	震中纬度（十进制度），南纬为负
`placeName`	string	是	震中地点描述（英文）
`magnitude`	number	是	震级
`depth`	number	是	震源深度（公里）
`headline`	string	否	海啸信息标题，如 `LOCAL TSUNAMI INFORMATION STATEMENT`
`event`	string	否	事件类型描述，如 `Tsunami Information`
`severity`	string	否	严重程度，如 `Minor`
`certainty`	string	否	确定性，如 `Unlikely`
`urgency`	string	否	紧急程度，如 `Unknown`
`description`	string	否	详细描述文本，含事件摘要
`onset`	string	否	海啸影响开始时间（或信息生效时间）
`expires`	string	否	本则信息过期时间
`web`	string	否	官方全文链接（tsunami.gov）
`senderName`	string	否	发布机构名称，如 `NWS PACIFIC TSUNAMI WARNING CENTER HONOLULU HI`
`magnitudeType`	string	否	震级类型，如 `Ml`（近震震级）

Update 更新消息

触发时机：对已有海啸信息进行修正或更新时推送，用于替代或补充之前的 initial。

示例

{
  "type": "update",
  "data": {
    "eventId": "PHEB-1-26072050",
    "shockTime": "2026-03-13 03:16:18",
    "longitude": -155.37,
    "latitude": 19.13,
    "placeName": "OFF THE KAU COAST OF THE BIG ISLAND",
    "magnitude": 4.3,
    "depth": 31,
    "headline": "LOCAL TSUNAMI INFORMATION STATEMENT",
    "event": "Tsunami Information",
    "severity": "Minor",
    "certainty": "Unlikely",
    "urgency": "Unknown",
    "description": "...",
    "onset": "2026-03-13 03:19:21",
    "expires": "2026-03-13 04:19:21",
    "web": "http://www.tsunami.gov/events/PHEB/2026/03/13/26072050/1/WEHW42/WEHW42.txt",
    "senderName": "NWS PACIFIC TSUNAMI WARNING CENTER HONOLULU HI",
    "magnitudeType": "Ml"
  },
  "md5": "a1b2c3d4e5f6789012345678901234ab"
}

字段结构与 initial 完全一致，仅 type 为 "update"，data 为修正后的参数。

Heartbeat 心跳消息

触发时机：服务端周期性发送，用于维持连接与健康检测。

示例

{
  "type": "heartbeat",
  "id": "08299f21e5b249ea9721718678c688a8",
  "timestamp": 1630000000000
}

字段说明

字段	类型	必填	说明
`type`	string	是	固定值 `"heartbeat"`
`id`	string	是	本次心跳的唯一标识（如 UUID 或 32 位十六进制）
`timestamp`	number	是	Unix 时间戳，毫秒

注意事项

时间字段（shockTime、onset、expires）一般为 UTC，请根据需要转换为本地时间。
若当前服务仅推送 initial，则 update / heartbeat 为预留格式，待服务端支持后即可生效。
服务仅作为学习与技术研究用途，勿用于正式防灾减灾业务决策；海啸预警请以各国官方发布为准。

PTWC 海啸预警 WebSocket 数据

概述