JMAEEW API 文件
介紹
Project BS JMAEEW API 提供來自日本氣象廳發布的「緊急地震速報」資訊的原電文和經解析後的 JSON 資料。同時支援 HTTP 和 WebSocket 通訊協定調用。
HTTP API
未解析原電文
https://telegram-cf.projectbs.cn/jmaeew/解析後 JSON
https://telegram-cf.projectbs.cn/jmaeewjson/WebSocket API
伺服器端收到 EEW 後將自動向所有 Client 廣播經解析後的 JSON 資料。
wss://telegram-cf.projectbs.cn/jmaeewws/可用命令
| 命令 | 回應 |
|---|---|
| ping | pong |
| querytelegram | 最新未解析原電文 |
| queryjson | 最新解析後 JSON 資料 |
JSON 資料結構說明
| 鍵 | 類型 | 描述 | 提供時機 |
|---|---|---|---|
| parse | object | 解析相關 | 始終 |
| parse.status | 'success' | 'error' | 解析狀態 | 始終 |
| parse.version | string | 解析器版本 | 始終 |
| title | object | 標題相關 | 始終 |
| title.code | number | 標題代碼 | 始終 |
| title.string | string | 標題 | 始終 |
| title.detail | string | 標題詳情 | 始終 |
| issue | object | 發布相關 | 始終 |
| issue.type | object | 發布類型相關 | 始終 |
| issue.type.code | number | 發布類型代碼 | 始終 |
| issue.type.string | string | 發布類型 | 始終 |
| issue.agency | object | 發布機構相關 | 始終 |
| issue.agency.code | number | 發布機構代碼 | 始終 |
| issue.agency.string | string | 發布機構 | 始終 |
| issue.time | string | 發布時間 | 始終 |
| originTime | string | 地震發生時間 / 地震檢測時間 / 由 PLUM 法計算出的地震發生時間（仮定震源要素時） | 始終 |
| eventID | string | 緊急地震速報用地震 ID | 始終 |
| type | object | 類型相關 | 始終 |
| type.code | number | 類型代碼 | 始終 |
| type.string | string | 類型 | 始終 |
| serial | number | 緊急地震速報序號 | 始終 |
| isCancel | boolean | 是否為取消報 | 始終 |
| isWarn | boolean | 是否為警報 | 始終 |
| isFinal | boolean | 是否為最終報 | 始終 |
| hypocenter | object | 震源相關 | 除取消報外 |
| hypocenter.code | number | 震源代碼 | 除取消報外 |
| hypocenter.name | string | 震中名稱 | 除取消報外 |
| hypocenter.isEstimate | boolean | 是否為仮定震源要素 | 除取消報外 |
| hypocenter.location | object | 震源位置相關 | 除取消報外 |
| hypocenter.location.lng | number | 震源經度 | 除取消報外 |
| hypocenter.location.lat | number | 震源緯度 | 除取消報外 |
| hypocenter.location.depth | number | 震源深度 | 除取消報外 |
| hypocenter.magnitude | number | 規模 | 除取消報外 |
| hypocenter.accuracy | object | 精度相關 | 除取消報外 |
| hypocenter.accuracy.epicenter | object | 震中精度相關 | 除取消報外 |
| hypocenter.accuracy.epicenter.code | number | 震中精度代碼 | 除取消報外 |
| hypocenter.accuracy.epicenter.string | string | 震中精度 | 除取消報外 |
| hypocenter.accuracy.depth | object | 震源深度精度相關 | 除取消報外 |
| hypocenter.accuracy.depth.code | number | 震源深度精度代碼 | 除取消報外 |
| hypocenter.accuracy.depth.string | string | 震源深度精度 | 除取消報外 |
| hypocenter.accuracy.magnitude | object | 規模精度相關 | 除取消報外 |
| hypocenter.accuracy.magnitude.code | number | 規模精度代碼 | 除取消報外 |
| hypocenter.accuracy.magnitude.string | string | 規模精度 | 除取消報外 |
| hypocenter.landOrSea | '陸域' | '海域' | '不明' | 震源位置分類 | 除取消報外 |
| maxIntensity | '不明' | '1' | '2' | '3' | '4' | '5弱' | '5強' | '6弱' | '6強' | '7' | 最大震度相關 | 除取消報外 |
| estIntensity | object[] | 地區最大預測震度和主要地震動預測抵達時刻相關 | 除僅預測最大震度的緊急地震速報和取消報外 |
| warnArea | string[] | 警報地區 | 為警報時 |
| originalTelegram | string | 原電文（取消換行後） | 始終 |
範例
注意事項
- API 所提供的資訊均由日本氣象廳發布，由 Project BS JMAEEW API 進行解析和二次轉發。
- API 盡最大努力提供 SLA 保證，但不排除出現無法存取或資料延遲甚至回溯等情況的可能。
文件版本：1.0.3
© 2026 Project BS JMAEEW API
