关于HikiMu-EEW
HikiMu-EEW地震预警系统，依托于福建地震局提供的API，致力于为用户提供及时、准确的地震预警服务。该系统通过实时监测地震局发布的数据，检测到地震活动时，便会立即启动预警机制
根据假设 利用哈弗辛公式（Haversine formula）距离 = 2R × arcsin(√(sin²(Δφ/2) + cosφ1·cosφ2·sin²(Δλ/2)))结合预设的6.8km/s波速，推算出剩余避险时间。由于计算本地预估烈度的算法比较复杂，故预览图的"[颜色]"仅代表"震源"级别[蓝色]、[黄色]、[橙色]、[红色]。
由于沿海地震速报主要用于中国台湾和大陆华南沿海地带，速报平台由CWA(台湾气象署)和FJEA(福建地震局)提供不同地区的地震速报内容；目前大陆地区虽然可以采用地牛Wake Up!、DPIP、TREM等。台湾本地地震的响应速度通常较快。而福建地震局自主研发的速报系统，虽然也在台湾地区部署了观测站，但因地震活动的复杂性和地域差异，对台湾地震的监测效果与本地系统存在一定差距。
在实际应用中，我们观察到福建地震局系统对大陆地区的地震预警表现较为稳定。为平衡不同区域的监测需求，采用双API接入策略：
*大陆近海地震：优先采用福建地震局数据
*台湾地区地震：同步接入台湾气象署数据
这种互补设计既保留福建系统对大陆地震的监测优势，又通过台湾数据源弥补区域盲区，使预警覆盖更全面。
此项目开始的时间是2024年03月04日
钉钉和飞书地震预警推送预览图
预览图(图片仅供参考)
如何获取速报信息
ESP32地震观测站
加速度监测器和地震预警系统
HikiMu地震预警系统 | HikiMu-EEW (福建地震预警)(台湾气象署)(硬件版)(此图为福州晋安观测站)
HikiMu地震预警终端 申请表
- **核心组件**
ESP32 (ESP-WROOM-32) 23.84
MPU6050(加速度传感器) 19.4
若干跳线
有源蜂鸣器 2.62
- **扩展模块**
若干LED(具有红、黄、橙、蓝)
开发成本 35(根据需求)
需要说明的是，以上价格仅供参考，实际价格可能会有所波动。
API接口方面
访问规范与前提条件
HikiMu-EEW 地震预警系统提供了 API 接口，用户可以通过这些接口获取实时的地震速报信息。使用前请确保 API 监控转发程序状态 正常。
1. 访问端口
API 需通过 8266 端口 以 HTTP GET 方式访问，地址格式为：http://*.*.*.*:8266/{name.json}。请勿使用 80 或 443 端口，以免在周审时被误判为异常流量。
WebSocket 端口提供两种传输方式：
- 8201 端口：明文传输
- 8200 端口：数据加密传输
2. WebSocket 连接规则
- 连接限制：此 WebSocket 不能使用域名连接，仅支持 IP 连接。
- 证书要求：使用 8200 加密端口连接时，需先信任相关证书。服务器默认使用 IP 自签名证书，浏览器或 WebSocket 客户端会提示证书不受信任，需手动接受证书（或配置客户端忽略证书验证），否则连接会被阻止。
3. 请求频率限制
- API 抓包（如 Python 抓包）：请求频率不得超过 1 秒 5 次，否则可能被封禁 IP。
- WebSocket 连接：每个 IP 每秒最多 10 次请求，超出后 IP 会被封禁 10 分钟。请控制请求频率，不要短时间内大量请求。
4. 连接超时与活性检测
- 请求超时：每个请求 30 秒内必须完成（读取 + 发送），超时则自动断开连接。
- 活性检测：服务器会定期发送 Ping 包检测连接活性，若 15 秒内无响应则断开连接。
- 闲置断开：若 300 秒（5 分钟）内没有任何数据收发，连接会被服务器主动关闭，建议客户端实现自动重连机制。
5. 封禁规则
若因频率过高或异常行为被封禁，IP 会被暂时加入黑名单（时长 10 分钟）。封禁期间无法建立任何连接，所有请求会被拒绝。被封禁后请等待自动解封，不要反复尝试重连，否则可能延长封禁时间。
6. 访问验证与权限
服务器不要求任何 API Key、Token 或用户名密码（未来若有调整将另行通知）。服务器仅允许访问 api 目录下的文件，非 api 目录文件无法访问。
注：使用 User-Agent（用户标识）伪装时，请确保您所添加的域名或 IP 是经过授权或是合法的，境外域名或 IP 会被重点关注。若使用带域名的用户标识时，经核查后发现使用伪官方域名或 IP 来获取数据，您的 IP 或域名可能会被列入黑名单，后续将无法获取数据。
地震预警核心 API
1. 地震触发检测接口
http://119.29.227.6:8266/wake_up.json
说明：任意地区发生地震时触发。
返回格式：
- 触发时：{"ring": true}
- 2 分钟后或无地震：{"ring": false}
2. 福建地震局地震速报 API（HikiMu-EEW 中转）
http://119.29.227.6:8266/fjea_list.json
刷新频率：约 2 秒刷新一次，数据来源：福建省地震局。若无新数据，3 分钟后恢复为空数组 []。
http://119.29.227.6:8266/moinc.json
刷新频率：约 2 秒刷新一次。
3. TREM 地震速报 API（HikiMu-EEW 中转）
http://119.29.227.6:8266/trem-eew.json
刷新频率：约 2 秒刷新一次，数据来源：ExptechTW。默认返回空数组，地震发生时返回数据。
author 字段说明：
- cwa：台湾气象署
- fjdzj：福建地震局
- scdzj：四川地震局
返回示例：
[
{
"author": "cwa",
"eq": {
"depth": 10,
"lat": 23.45,
"loc": "花蓮縣卓溪鄉",
"lon": 121.34,
"mag": 4.7,
"max": 4,
"time": 1741793261000
},
"final": 0,
"id": "1140871",
"serial": 4,
"status": 0,
"time": 1741793288000
}
]测站数据 API
测站数据 API 提供了实时的地震观测站数据，用户可以通过这些接口获取各个观测站的实时数据。需要说明的是，部分测站可能因固件开发测试需要，存在数据不准确的情况，因此请谨慎使用。
请勿将接口数据用于非法用途，支持合法二次开发。
可用测站接口（目前）
hikimu_QZHG_LED_V2.json - 泉州惠安洛阳大道华光部
hikimu_Fuzhou_ChangLe.json - 福州长乐观测站
hikimu_FZJA_LED_V2.json - 福州晋安观测站
（更多测站请参阅相关文档）
测站 JSON 字段说明
{
"id": "TEST", // 测站ID
"name": "test", // 测站名称
"time": "00:00:00", // 测站时间
"timestamp": 000000000, // 测站时间戳（毫秒）
"X": 0, // X轴加速度，单位 m/s²
"Y": 0, // Y轴加速度，单位 m/s²
"Z": 0, // Z轴加速度，单位 m/s²
"earthquake_intensity": 0, // 测站烈度
"mercalli_intensity": 0, // 麦加利烈度
"pga": 0, // PGA值（gal）
"pgv": 0.078, // PGV值（cm/s）
"ns": 2.457, // NS方向PGA（gal）
"ew": 2.51, // EW方向PGA（gal）
"ud": 5.482, // UD方向PGA（gal）
"online": true // 测站在线状态
"last_update":"2026-04-01T00:00:00.000000" // 服务器时间（ISO 8601格式）
}使用注意事项
- 测站数据仅供参考，部分测站因固件测试可能存在数据不准确，实际数据以官方发布为准。
- 部分接口存在延迟，请结合实际场景判断。
- WebSocket 连接需严格遵循端口、证书及频率要求，避免因违规操作导致 IP 封禁。
- 使用前请熟悉 HikiMu 地震预警系统整体操作。
- websocket 随时可能维护或调整，若遇到连接问题请先检查服务器状态
- 请不要在公共网络环境下使用
关于HikiMu地震预警网页版
HikiMu 地震预警系统网页版提供主题模式选择，满足不同环境下的浏览需求；用户可设置地震预警的震级阈值，避免低震级地震的频繁预警干扰；还能够显示地震波形图，并允许用户选择不同的波形图数据源，但波形图仅供参考且占用的数据量较大；因此在日志中用户的 IP 信息和设备 User Agent 会比较明显，用户可查看隐私政策了解具体收集类别。
戳我可前往 WEB版本 >> HikiMu地震预警网页版
