BMKG 速报 · WebSocket 数据接口文档

概述

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

消息类型

📦 Initial 初报

地震事件首次上报时的参数，包括震中、时间、震级、深度及是否具海啸潜力。

🔄 Update 更新

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

💓 Heartbeat 心跳

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

详细字段说明

Initial 消息

Update 消息

Heartbeat 消息

Initial 初报消息

示例

{
  "type": "initial",
  "data": {
    "eventId": "BMKG_4952583fb92ec16d",
    "shockTime": "2026-03-12 20:04:04",
    "longitude": 111.9,
    "latitude": -0.01,
    "placeName": "80 km TimurLaut MELAWI-KALBAR",
    "magnitude": 5.3,
    "depth": 10,
    "potensi": "Tidak berpotensi tsunami"
  },
  "md5": "f96df81ad1f04a07ac3fc9a50406d195"
}

外层字段

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

`data` 对象字段

字段	类型	必填	说明
`eventId`	string	是	事件唯一标识符，如 `BMKG_4952583fb92ec16d`
`shockTime`	string	是	发震时间，格式如 `YYYY-MM-DD HH:MM:SS`
`longitude`	number	是	震中经度（十进制度），西经为负
`latitude`	number	是	震中纬度（十进制度），南纬为负
`placeName`	string	是	地点描述（印尼语），如相对某地的方位与距离
`magnitude`	number	是	震级
`depth`	number	是	震源深度（公里）
`potensi`	string	是	海啸潜力说明（印尼语），如 `Tidak berpotensi tsunami` 表示不具海啸潜力

Update 更新消息

触发时机：对已有事件参数进行修正时推送，用于替代或补充之前的 initial。

示例

{
  "type": "update",
  "data": {
    "eventId": "BMKG_4952583fb92ec16d",
    "shockTime": "2026-03-12 20:04:04",
    "longitude": 111.92,
    "latitude": -0.02,
    "placeName": "80 km TimurLaut MELAWI-KALBAR",
    "magnitude": 5.4,
    "depth": 10,
    "potensi": "Tidak berpotensi tsunami"
  },
  "md5": "a1b2c3d4e5f6789012345678901234ab"
}

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

Heartbeat 心跳消息

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

示例

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

字段说明

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

注意事项

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

BMKG 速报 WebSocket 数据

概述