免费地震信息：震级(mag)与烈度到底有什么区别？字段口径详解
# 免费地震信息：震级(mag)与烈度到底有什么区别？字段口径详解
- **接口/接入点**：免费地震信息 · 2274-1
- **是否免费**：是（注册即免费额度）
- **请求方式**：POST / GET
- **返回格式**：JSON
- **适用人群**：开发者、数据分析师、科普作者
- **阅读时间**：约 8 分钟
## 核心要点
- 接口返回的 `mag` 字段，文档标注为「烈度」，但从取值（小数 0.23~6.0+）与数据源（usgs/ceic）判断，它实际是**震级(magnitude)**，如里氏/矩震级。
- **震级**衡量地震本身释放的能量（一个地震只有一个值）；**烈度**衡量某一地点受到的地面影响（随距离衰减，同一地震不同地点烈度不同）。
- 写代码/做展示时，请把 `mag` 当作「震级」表述，避免把用户搞混。这是文档口径偏差，本文帮你厘清。
## Why：一个字段名错了，科普就错了
很多开发者照抄文档，把 `mag` 标成「烈度」展示给用户，结果出现「烈度 4.4」「烈度 0.39」这种在地震学上不成立的说法（烈度通常是整数罗马/度数，描述破坏程度）。厘清 `mag` 的真实含义，既是工程严谨，也避免传播错误常识。
## What：接口速览
| 项 | 值 |
|----|----|
| 接口地址 | `https://route.showapi.com/2274-1?appKey={your_appKey}` |
| 相关字段 | `mag`（文档称「烈度」，实为震级） |
| 计费 | 免费（档位限制见 [免费 API 说明](https://www.showapi.com/free-api)） |
## How：从数据反推 mag 的真相
返回示例（实测）：
```json
{ "showapi_res_body": { "ret_code": 0, "earthquakes": [
{ "location": "加利福尼亚间歇泉西北7 公里处", "mag": 1.02, "from": "usgs" },
{ "location": "四川内江市市中区", "mag": 4.4, "from": "ceic" },
{ "location": "台湾玉井北12 公里处", "mag": 6, "from": "usgs" }
] } }
```
判断依据：
1. **取值是小数**：1.02、4.4、6、0.39……烈度（如麦加利烈度）是描述「破坏程度」的整数等级（I~XII），不会是 0.39 这种值。
2. **来源是 usgs/ceic**：这两家机构对外发布的都是**震级（magnitude）**标量（Mw/Mb 等），并非烈度图。
3. **单一数值**：每条记录只有一个 `mag`，而烈度本应随观测点变化——单一标量更契合「震级」定义。
结论：`mag` = 震级(magnitude)。文档的「烈度」标注是口径偏差。
### 展示建议（正确写法）
```python
# 正确：标注为震级
print(f"{eq['location']} 发生地震，震级 M {eq['mag']}，震源深度 {eq['dep']} km")
# 错误：标注为烈度（会误导）
# print(f"烈度 {eq['mag']}") # ❌
```
## 返回示例与解析
字段含义对照：
| 文档标注 | 实测判定 | 正确表述 |
|---------|---------|---------|
| `mag` = 烈度 | 实为震级(magnitude) | 震级（如 M 4.4） |
## 进阶 / 边界
- **不要擅自标具体标度**：接口只给 `mag` 数值，未说明是里氏还是矩震级。展示时写「震级 X.X」即可，不要标注 Mw/Mb 等具体标度以免越界。
- **震级 vs 烈度一句话区别**：震级是「地震多大」（能量），烈度是「某地晃得多厉害」（破坏）。接口不提供烈度字段。
- **深度 dep 辅助判断**：`dep` 越小通常破坏越强，但这是经验关联，不是烈度；别把浅源直接等同于高烈度。
## FAQ
**Q1：mag 到底是里氏还是矩震级？**
接口未区分震级标度，只返回单一数值。展示时统一写「震级 X.X」最稳妥，不要标注具体标度。
**Q2：为什么文档写「烈度」？**
属于文档口径偏差。从取值（小数）与数据源（usgs/ceic 发布的是震级）可判定 `mag` 为震级。我们已在本指南中按真实含义标注，调用方请以「震级」理解。
**Q3：能不能拿到烈度数据？**
本接口不返回烈度字段，只有 `mag`（震级）、`dep`（深度）等。如业务需要烈度，需接入专门的烈度/烈度图数据源。
**Q4：mag 出现 0.39 这么小正常吗？**
正常。微小地震（如加州频繁发生的 0.x 级）震级本就很小，说明 `mag` 是连续的震级标量，而非整数烈度。
## 相关能力 / 下一步阅读
- [免费地震信息：返回字段全解（ret_code / mag / from 一文读懂）](https://www.showapi.com/guides/earthquake-info-response-fields-2274)
- [免费地震信息：数据来源 usgs / ceic 有什么区别？该怎么用](https://www.showapi.com/guides/earthquake-info-data-sources-2274)
- [免费地震信息：timeLocal / timestampLocal 时区口径与跨时区处理](https://www.showapi.com/guides/earthquake-info-time-local-utc-2274)
- **本系列共 14 篇**：查看[免费地震信息指南总目录](https://www.showapi.com/guides/earthquake-info-guides-2274)
