GeoNet 速报 · WebSocket 数据接口文档

概述

通过 WebSocket 连接 wss://sismotide.top/Geonet，可实时接收 GeoNet 推送的地震速报数据。服务会在事件产生时推送 initial 初报，若有参数修正则推送 update 消息，并定期发送 heartbeat 心跳包以维持连接。初报与更新包含震中位置、发震时间、震级、深度、定位质量（quality）及仪器烈度（mmi）等字段。

消息类型

📦 Initial 初报

地震事件首次上报时的参数，包括震中、时间、震级、深度、定位质量与 MMI。

🔄 Update 更新

对已有事件参数进行修正的后续报告，字段结构与 initial 完全一致。

💓 Heartbeat 心跳

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

详细字段说明

Initial 消息

Update 消息

Heartbeat 消息

Initial 初报消息

示例

{
  "type": "initial",
  "data": {
    "eventId": "2026p199148",
    "shockTime": "2026-03-15 16:26:10",
    "longitude": 173.518432617,
    "latitude": -40.887195587,
    "placeName": "25 km west of French Pass",
    "magnitude": 2.028724015243006,
    "depth": 68.18079376220703,
    "quality": "best",
    "mmi": -1
  },
  "md5": "69f77f6851a9c7920629fd9510f94d65"
}

外层字段

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

`data` 对象字段

字段	类型	必填	说明
`eventId`	string	是	事件唯一标识符，如 `2026p199148`
`shockTime`	string	是	发震时间，格式如 `YYYY-MM-DD HH:MM:SS`
`longitude`	number	是	震中经度（十进制度），西经为负
`latitude`	number	是	震中纬度（十进制度），南纬为负
`placeName`	string	是	地点描述，如相对某地的方位与距离
`magnitude`	number	是	震级（可能为浮点数）
`depth`	number	是	震源深度（公里），可能为浮点数
`quality`	string	否	定位质量，如 `best` 表示最佳
`mmi`	number	否	仪器烈度（MMI），-1 表示暂无或无效

Update 更新消息

触发时机：对已有事件参数（震级、位置、深度等）进行修正时推送，用于替代或补充之前的 initial。

示例

{
  "type": "update",
  "data": {
    "eventId": "2026p199148",
    "shockTime": "2026-03-15 16:26:10",
    "longitude": 173.52,
    "latitude": -40.89,
    "placeName": "25 km west of French Pass",
    "magnitude": 2.1,
    "depth": 68,
    "quality": "best",
    "mmi": 2
  },
  "md5": "a1b2c3d4e5f6789012345678901234ab"
}

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

Heartbeat 心跳消息

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

示例

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

字段说明

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

注意事项

时间 shockTime 的具体时区请以 GeoNet 官方说明为准，必要时转换为本地时间。
若当前服务仅推送 initial，则 update / heartbeat 为预留格式，待服务端支持后即可生效。
服务仅作为学习与技术研究用途，勿用于正式防灾减灾业务决策。

GeoNet 速报 WebSocket 数据

概述