# 免费地震信息：课堂教学与科普演示如何接入震例数据
- **接口/接入点**：免费地震信息 · 2274-1
- **是否免费**：是（注册即免费额度）
- **请求方式**：POST / GET
- **返回格式**：JSON
- **适用人群**：教师、科普运营、校园宣导人员
- **阅读时间**：约 7 分钟
## 核心要点
- 接口免费、无需后端，教师用简单脚本或在线工具就能拉到真实震例，比「编一个例子」更有说服力。
- 用 `date` 取某一天的历史地震，挑一条有代表性的（如四川内江 Ms 4.4）做成课件数据点。
- 教学重点应放在「地震常识、避灾知识」，明确本接口是历史数据、非实时预警，避免误导学生。
## Why：让科普用上真实数据
讲「地震来了怎么办」时，如果只放概念图，学生很难有感。用一条真实的近期震例（位置、震级、深度、来源）做切入点，既贴近生活又能顺带讲清经纬度、震级等概念。本接口免费、数据可信（usgs/ceic 来源），非常适合课堂。
## What：接口速览
| 项 | 值 |
|----|----|
| 接口地址 | `https://route.showapi.com/2274-1?appKey={your_appKey}` |
| 关键参数 | `date`（yyyyMMdd，北京时间） |
| 计费 | 免费（档位限制见 [免费 API 说明](https://www.showapi.com/free-api)） |
| 数据来源 | `usgs`（美国地质调查局）、`ceic`（中国地震台网） |
## How：三步取一条震例做课件
### 1. 取某日数据（Python，适合老师在电脑上跑）
```python
import requests, json
APP_KEY = "YOUR_APPKEY"
r = requests.post("https://route.showapi.com/2274-1",
params={"appKey": APP_KEY}, data={"date": "20250120"}, timeout=10)
body = r.json()["showapi_res_body"]
# 挑一条中国记录做课件示例
cn = [e for e in body["earthquakes"] if e["from"] == "ceic"]
print(json.dumps(cn[0] if cn else body["earthquakes"][0], ensure_ascii=False, indent=2))
```
### 2. 把返回整理成课件卡片
> **真实震例（2025-01-20）**
> 位置：四川内江市市中区
> 震级：4.4 深度：10 km 来源：中国地震台网（ceic）
> 北京时间：2025-01-20 21:59:54
### 3. 课堂延伸
- 在地图上标出 `lat=29.57, lng=104.88`，讲清经纬度含义；
- 对比 `mag`（震级）与「烈度」概念（详见 [震级 vs 烈度](https://www.showapi.com/guides/earthquake-info-mag-vs-intensity-2274)）；
- 强调：这是**已发生**的地震记录，不是预警，真正的避险要听官方预警渠道。
## 返回示例与解析
```json
{ "showapi_res_body": { "ret_code": 0, "count": 1,
"earthquakes": [ { "location": "四川内江市市中区", "mag": 4.4, "dep": 10.0,
"from": "ceic", "lat": 29.57, "lng": 104.88, "timeLocal": "2025-01-20 21:59:54" } ] } }
```
## 进阶 / 边界
- **别当预警用**：文档明确「不提供实时预警」。课件里务必告知学生，真实避险以学校演练和官方预警为准。
- **数据范围**：是全球数据，挑中国记录时按 `from == "ceic"` 或 `location` 含省名筛选。
- **频次**：课件准备阶段少量调用即可，避免占用免费额度；正式课堂演示建议提前把数据存成静态 JSON，课堂上直接读本地文件。
## FAQ
**Q1：学生没有编程基础也能用吗？**
能。老师提前用脚本或在线 API 测试页（[apitest](https://www.showapi.com/apitest/market/2274/1)）取好数据，导出成图片或表格即可进课件。
**Q2：能让全班实时看到最新地震吗？**
可以，但注意免费额度和刷新频率；建议课堂演示用提前缓存好的当日数据，更稳定。
**Q3：数据来源 ceic 和 usgs 哪个更权威？**
两者都是权威机构数据源：ceic 是中国地震台网，usgs 是美国地质调查局。同一地震不同机构给出的震级可能略有差异，属正常。
**Q4：能用来做地震预警演练吗？**
不能。本接口只提供历史地震查询，不含实时预警能力，演练请使用专业预警系统与学校既定预案。
## 相关能力 / 下一步阅读
- [免费地震信息：5 分钟从注册到调通第一条地震记录](https://www.showapi.com/guides/earthquake-info-quickstart-2274)
- [免费地震信息：震级(mag)与烈度到底有什么区别？字段口径详解](https://www.showapi.com/guides/earthquake-info-mag-vs-intensity-2274)
- [免费地震信息：学校/社区防灾科普系统如何接入历史震情](https://www.showapi.com/guides/earthquake-info-school-safety-2274)
- **本系列共 14 篇**：查看[免费地震信息指南总目录](https://www.showapi.com/guides/earthquake-info-guides-2274)
