PSC uses Coordinated Universal Time (UTC) as its standard time zone. All timestamps follow the ISO 8601 format:
PSC 使用协调世界时（UTC）作为标准时间。时间字符串遵循 ISO 8601 格式：
YYYY-MM-DDThh:mm:ssZ
(e.g., 2024-08-24T11:45:14Z for 11:45:14 UTC on August 24, 2024)
（示例：2024 年 8 月 24 日 11:45:14 UTC 记为 2024-08-24T11:45:14Z）PSC represents geographic coordinates as a two-element float array, with latitude followed by longitude. Precision and coordinate system vary by the reporting agency.
PSC 使用包含两个浮点数的列表表示地理坐标，纬度在前，经度在后。具体精度与坐标系因情报来源机构而异。
PSC expresses hypocentral depth in kilometers as an integer. A value of 0 indicates an extremely shallow source.
PSC 以千米为单位表示震源深度，类型为整数。0 表示极浅。
PSC expresses seismic intensity as a float, with the type indicated by an uppercase English string.
PSC 以浮点数表示地震烈度，类型以大写英文字母字符串标识。
PSC currently uses the following intensity scales:
PSC 当前采用的地震烈度标准如下：
- CSIS: The Chinese Seismic Intensity Scale. This national standard qualitatively classifies ground vibration and damage severity based on macroscopic phenomena, comprising 12 levels from Ⅰ to Ⅻ.
中国地震烈度表。本标准是通过宏观现象定性划分地面振动及破坏程度的国家标准，分为Ⅰ至Ⅻ共12个等级。 - JMA: The Japan Meteorological Agency Seismic Intensity Scale. Based on seismometer observations at ground level or low-rise building first floors, it classifies seismic intensity into 10 levels: 0, 1, 2, 3, 4, 5-, 5+, 6-, 6+, and 7. The scale characterizes ground motion through human perception, building damage, and ground deformation, with distinctions made for structures of varying seismic resistance.
日本气象厅震度等级。基于地表或低层建筑一层震度计的观测值，分为 0、1、2、3、4、5弱、5强、6弱、6强、7 共 10 个等级。该标准通过人的体感、建筑物受损及地表变化等现象描述地震动强度，并区分了不同耐震性建筑物的受损差异。 - MMI: Modified Mercalli Intensity Scale. Developed by American seismologists Wood and Neumann in 1931, this scale rates earthquakes based on their observed effects on the Earth’s surface. It uses Roman numerals from I to XII, ranging from imperceptible shaking (I) to catastrophic destruction (XII). Lower values reflect human perception, while higher values reflect structural and ground damage.
修正麦卡利烈度等级。该标准由美国地震学家 Wood 与 Neumann 于 1931 年制定，基于地震对地表的实际影响进行评定，以罗马数字 I 至 XII 表示，从几乎无感（I）到毁灭性破坏（XII），低等级侧重人的体感，高等级侧重建筑物及地表损坏程度。 - CWASIS: The Central Weather Administration Seismic Intensity Scale.
类似于日本气象厅震度等级，细节待补充。
For Shindo-type intensity scales such as JMA and CWASIS, the levels from 5 Lower through 6 Upper are represented in PSC as the following decimal values:
JMA 与 CWASIS 等”震度”类烈度标准，其五弱至六强在 PSC 中以如下浮点数表示：
- 5- / 5 Lower / 五弱 ===> 4.75
- 5+ / 5 Upper / 五强 ===> 5.25
- 6- / 6 Lower / 六弱 ===> 5.75
- 6+ / 6 Upper / 六强 ===> 6.25
| Field 字段 | Type 类型 | Description 描述 |
|---|---|---|
| timestamp | Integer | PSC standard Unix timestamp PSC 标准 Unix 时间戳 |
| version | String | PSC service version PSC 服务版本 |
| channel | String | Current channel 当前所处频道 |
| active_events | List[Dict, …] | Currently active events (e.g., ongoing earthquake warnings, active typhoon updates) 当前活跃事件列表（如：正在进行的地震预警、活跃台风情报） |
| ip | String | Client public IP address 客户端公网 IP 地址 |
| last_used_at | String | Last time the token was used. 上一次令牌使用时间 |
| last_used_ip | String | IP address from which the token was last used. 上一次使用令牌的 IP |
| ip_region | List[String, String] | Client IP geolocation as [English name, Chinese name].Both may be empty strings. 客户端 IP 归属地，列表中含两个字符串，分别是英文地名和中文地名，均可能为空字符串。 |
| ip_location | List[Float, Float] | Client IP geolocation coordinates. Maybe [0.0, 0.0] if geolocation fails. 客户端 IP 属地坐标。定位失败可能为 [0.0, 0.0]。 |
PSC locates client IPs locally using the MaxMind GeoIP2 offline database. Results are for reference only.
PSC 使用 MaxMind GeoIP2 离线数据库在服务器本地定位客户端 IP，结果仅供参考。
Example 示例
{}
The event identifier (event_id) is a globally unique integer assigned by PSC to each independent disaster event, consistent across channels. A single event may generate multiple messages—such as reports from different agencies, multiple updates to an earthquake early warning, or subsequent cancellation notices. While the md5 of these messages differs, their event_id remains the same, enabling clients to correlate and track the full lifecycle of an event.
事件编号（event_id）是 PSC 为每个独立灾害事件分配的全局唯一整数标识，跨频道互通。同一事件可能产生多条情报——例如不同机构的测定报告、同一地震预警的多次更新，乃至后续的取消报。这些消息的 md5 各不相同，但 event_id 保持一致，便于客户端关联并追踪同一事件的完整生命周期。
| Field 字段 | Type 类型 | Description 描述 |
|---|---|---|
| md5 | String | Last 7 characters of the intelligence message MD5 hash 该情报消息 MD5 值的末七位 |
| eid | Integer | Unique identifier of the event this message refers to 该请报消息对应的事件编号 |
| type | String | Type of this intelligence message 该请报消息的类型 |
| source | String | Name of the agency that published this intelligence message 该请报消息的来源机构名称 |
| qualifier | String | Additional qualifier from the source (e.g., measurement status, sub-agency). May be an empty string. 来源附加的限定信息，如测定状态或子机构名称。可能为空字符串。 |
The following sections describe the body field structure for each intelligence message type.
下文将按情报消息类型分节介绍各类型消息的报体字段构成。
Earthquake Early Warning. An urgent alert sent to regions not yet reached by seismic waves after an earthquake occurs.
地震预警（Earthquake Early Warning）。地震发生后，向地震波尚未到达区域发出的紧急警报。
ATTENTION 注意
When displaying warning information, clearly inform users that automated early warning systems involve estimation uncertainty and false alarm risks. Final determinations are subject to authoritative agencies.
展示预警信息时，应明确告知用户：自动预警系统存在预估误差及误报可能，最终结果以权威机构测定为准。
| Field 字段 | Type 类型 | Description 描述 |
|---|---|---|
| time | String | Seismic origin time 地震发生时刻 |
| region | String | Epicenter region 震中地点名称 |
| fe_region | String | Flinn-Engdahl region of the epicenter. Empty string if not applicable. 震中所在的 Flinn-Engdahl 区域。若震中不在任何 F-E 区域内，则为空字符串。 |
| location | List[Float, Float] | Epicenter coordinates 震中坐标 |
| depth | Integer | Hypocentral depth 震源深度 |
| magnitude | Float | Earthquake magnitude 地震震级 |
| mag_type | String | Magnitude type 震级单位 |
| intensity | Float | Estimated maximum intensity 预估最大烈度 |
| int_type | String | Estimated maximum intensity type 预估最大烈度的类型 |
| area_intensities | List[Dict, …] | Estimated intensity in surrounding areas 周边地区预估烈度 |
| radius | Integer | Estimated impact radius in kilometers 预估震动影响半径，单位为千米。 |
| revision | Integer | Revision number. Indicates the Nth parameter revision for this warning. 预警更新编号。表示本次地震预警的第几次参数修订。 |
| definitive | Boolean | Whether this update is final. If true, this is the best estimate without further updates. 本次预警的修正是否结束。为 真 时，该报即为最终的最佳估计，不再更新。 |
| history | List[Dict, …] | Historical updates, present only if definitive is true. Excludes final report; may be empty.本次预警的历史修正列表。仅当 definitive 为 真 时存在，不含最终修正报，可能为空列表。 |
Earthquake Report. Official parameter determination released by monitoring agencies after an earthquake, typically serving as the event’s definitive confirmation.
地震报告（Earthquake Report）。地震发生后，由监测机构发布的正式参数测定结果，通常作为该事件的最终确认。
| Field 字段 | Type 类型 | Description 描述 |
|---|---|---|
| time | String | Seismic origin time 地震发生时刻 |
| region | String | Epicenter region 震中地点名称 |
| fe_region | String | Flinn-Engdahl region of the epicenter. Empty string if not applicable. 震中所在的 Flinn-Engdahl 区域。若震中不在任何 F-E 区域内，则为空字符串。 |
| location | List[Float, Float] | Epicenter coordinates 震中坐标 |
| depth | Integer | Hypocentral depth 震源深度 |
| magnitude | Float | Earthquake magnitude 地震震级 |
| mag_type | String | Magnitude type 震级单位 |
| intensity | Float | Maximum intensity 最大烈度 |
| int_type | String | Maximum intensity type 最大烈度的类型 |
| estimated | Boolean | Whether the maximum intensity is estimated. False means instrumentally measured. 最大烈度是否为估计值。若为假，则表示该烈度为仪器实测结果。 |
| area_intensities | List[Dict, …] | Intensity in surrounding areas 周边地区烈度 |
| area_estimated | Boolean | Whether the area intensities are estimated. False means instrumentally measured. 周边地区烈度是否为估计值。若为假，则表示均为仪器实测结果。 |
| radius | Integer | Estimated impact radius in kilometers 预估震动影响半径，单位为千米。 |
| automated | Boolean | Null | Whether auto-generated. False means manually reviewed. 是否为自动系统测定。若为 假，则表示经人工复核。 Some agencies issue an automated preliminary report followed by a manual final report. 部分机构可能先由自动系统发布初报，再经人工复核后发布正式报告。 When this field is null, the source agency has not specified its determination method. 该字段为 null 时，表示来源机构未明确其测定方式。 When this field is true, this determination is excluded from PSC’s earthquake history. 该字段为 真 时，本次测定结果不计入 PSC 地震历史。 |
| link | String | Detail URL of the earthquake report 该地震报告的详情页面 URL |
Focal Mechanism Solution. A seismological method describing earthquake fault geometry and slip direction via nodal planes.
震源机制解（Focal Mechanism Solution）。一种描述地震断层破裂面几何形态与滑动方向的地震学方法。
| Field 字段 | Type 类型 | Description 描述 |
|---|---|---|
| time | String | Centroid time (some agencies may provide origin time instead). 矩心时刻。部分机构可能以发震时间代替。 |
| region | String | Epicenter region 震中地点名称 |
| fe_region | String | Flinn-Engdahl region of the epicenter. Empty string if not applicable. 震中所在的 Flinn-Engdahl 区域，若其不在任何 F-E 区域内，则为空字符串。 |
| location | List[Float, Float] | Centroid coordinates (some agencies may provide epicenter location instead). 矩心经纬度。部分机构可能以震中坐标代替。 |
| depth | Integer | Centroid depth 矩心深度 |
| magnitude | Float | Moment Magnitude (Mw) 矩震级（Mw） |
| plane_1 | List[Integer, …] | Parameters of nodal plane 1 第一节面参数 A list of three integers representing the strike, dip, and rake angles. 一个包含三个整数的列表，分别对应走向（strike）、倾角（dip）和滑动角（rake）。 In degrees. The plane_2 field follows the same format.单位为度。 plane_2 字段同理。 |
| plane_2 | List[Integer, …] | Parameters of nodal plane 2 第二节面参数 |
| fault | String | Fault type determined from the nodal plane rake angle. 基于节面滑动角判定的断层运动类型。 This field is restricted to the following five values: 该字段的取值仅限以下五种： normal | reverse | strike-slip | normal-oblique | reverse-oblique Corresponding to different fault types. 分别对应：正断层、逆断层、走滑断层、正斜滑断层、逆斜滑断层。 |
| link | String | Detail URL of the focal mechanism solution 该震源机制解的详情页面 URL |
Tropical Cyclone Bulletin. A periodic meteorological product containing a tropical cyclone’s current position, intensity, and projected path.
热带气旋公报（Tropical Cyclone Bulletin）。气象部门发布的一种周期性通报，包含热带气旋当前位置、强度及路径预报。
| Field 字段 | Type 类型 | Description 描述 |
|---|---|---|
| time | String | Bulletin time 发布时间 |
| name | List[String, String] | Tropical cyclone name. A two-element list containing the English and Chinese names. 热带气旋名称，列表中含两个字符串，分别是其英文名和中文名。 |
| location | List[Float, Float] | Center position 中心位置 |
| pressure | Integer | Central pressure, in hectopascals (hPa). 中心气压，单位为百帕（hPa）。 |
| wind | Integer | Maximum sustained wind speed near the center, in meters per second (m/s). 近中心最大风速，单位为米每秒（m/s）。 |
| move | Integer | Movement speed, in kilometers per hour (km/h). 移动速度，单位为千米每小时（km/h）。 |
| radius_7 | List | Radius of force 7 wind circle 七级风圈半径 A list of four integers representing wind radii for the NE, SE, NW, SW quadrants. 一个包含四个整数的列表，依次对应东北、东南、西北、西南四个象限的风圈半径。 In kilometers. May be an empty list. The same format applies to radius_10 and radius_12. 单位为千米，可能为空列表。radius_10 与 radius_12 字段同理。 |
| radius_10 | List | Radius of force 10 wind circle 十级风圈半径 |
| radius_12 | List | Radius of force 12 wind circle 十二级风圈半径 |
| forecast | List[Dict, …] | Track forecast 未来路径预报 |
| history | List[Dict, …] | Track History 历史实况路径 |
Track forecasts and historical records are both presented as lists. Forecasts are sorted chronologically from earliest to latest; historical records are sorted in reverse chronological order. Each track entry is a dictionary, formatted as follows:
路径预报与历史记录均以列表形式呈现。预报按时间从早到晚排列，历史记录按时间从晚到早排列。每个路径项为一个字典，格式如下：
| Field 字段 | Type 类型 | Description 描述 |
|---|---|---|
| time | String | Record time / Forecast time 记录时间 / 预报时间 |
| location | List[Float, Float] | Center position 中心位置 |
| pressure | Integer | Central pressure, in hectopascals (hPa). 中心气压，单位为百帕（hPa）。 |
| wind | Integer | Maximum sustained wind speed near the center, in meters per second (m/s). 近中心最大风速，单位为米每秒（m/s）。 |
| move | Integer | Movement speed, in kilometers per hour (km/h). 移动速度，单位为千米每小时（km/h）。 |
The following sections describe request formats and responses by command.
下文将按命令分节介绍请求格式与响应内容。
Retrieve paginated latest earthquake intelligence.
获取指定分页的最新地震情报。
Request 请求
get eqlist <offset>:<limit>
| Field 字段 | Required 必填 | Type 类型 | Description 描述 |
|---|---|---|---|
| offset | True / 是 | Integer | Zero-based offset. 0 is the most recent record. 偏移量 — 从 0 开始计数。0 表示从最新记录起始。 |
| limit | True / 是 | Integer | Number of records to return. Max 100. 返回数量 — 单次请求返回的记录数，上限为 100。 |
Response 响应
Response is a JSON array sorted by publication time from newest to oldest. Elements are EEW final reports, original EQR reports (official determinations only, where automated is false), or original CMT reports, each parseable using the corresponding intelligence type’s field definitions.
响应为一个 JSON 数组，按发布时间从新到旧排列。数组元素为 EEW 最终报、EQR 原情报（仅包含 automated 为 false 的正式测定报告）或 CMT 原情报，可直接按对应情报类型的字段定义进行解析。
Example 示例
[
{
"md5": "73f8677",
"eid": 514,
"type": "EQR",
"source": "SOURCE_NAME",
"qualifier": "Reviewed",
"time": "2025-01-07T01:05:16Z",
"region": "REGION NAME",
"fe_region": "F-E REGION NAME",
"location": [28.50, 87.45],
"depth": 10,
"magnitude": 4.5,
"mag_type": "Mw",
"intensity": 5.0,
"int_type": "CSIS",
"estimated": true,
"area_intensities": [],
"area_estimated": true,
"radius": 1145,
"automated": false,
"detail_link": "https://example.com/"
},
{
"md5": "a1b2c3d",
"event_id": 513,
"event_type": "CMT",
...
}
]