免费地震信息：学校/社区防灾科普系统如何接入历史震情
# 免费地震信息：学校/社区防灾科普系统如何接入历史震情
- **接口/接入点**：免费地震信息 · 2274-1
- **是否免费**：是（注册即免费额度）
- **请求方式**：POST / GET
- **返回格式**：JSON
- **适用人群**：学校信息化、社区科普、防灾减灾机构
- **阅读时间**：约 7 分钟
## 核心要点
- 接口提供近一年全球历史地震数据，非常适合做「周期性科普、避险教育、震例回顾」类系统。
- 用 `date` 取某日/某月震情，配合 `location`/`mag` 做「本地相关震例」展示，提升居民防灾意识。
- 务必明确：这是**历史数据**，不是实时预警；系统里不能把它当报警器用。
## 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：周报式科普取数
```python
import requests, datetime
APP_KEY = "YOUR_APPKEY"
def weekly_quakes(date_str):
r = requests.post("https://route.showapi.com/2274-1",
params={"appKey": APP_KEY}, data={"date": date_str}, timeout=10)
body = r.json()["showapi_res_body"]
if body["ret_code"] != 0:
return []
# 只挑中国台网记录，贴近本地科普
return [e for e in body["earthquakes"] if e["from"] == "ceic"]
# 例如展示某一天
for eq in weekly_quakes("20250120"):
print(f"{eq['location']} 震级 {eq['mag']} 深度 {eq['dep']}km")
```
展示建议：
- 用 [地图标点](https://www.showapi.com/guides/earthquake-info-map-visualization-2274) 把震中打到本地地图；
- 配一句「这不是预警，是已经发生的事实，了解它才能更好地准备」。
## 返回示例与解析
```json
{ "showapi_res_body": { "ret_code": 0, "earthquakes": [
{ "location": "青海玉树州治多县", "mag": 3.8, "dep": 10.0, "from": "ceic", "timeLocal": "2025-01-20 00:04:55" }
] } }
```
挑 `from == "ceic"` 的记录做「本地相关震例」展示，信源更贴近国内口径。
## 进阶 / 边界
- **不替代预警**：文档明确「不提供实时预警」。系统里应明确标注数据性质，并引导用户关注官方预警渠道与学校演练。
- **频率与缓存**：免费额度有限，周报/月报场景建议每日/每周定时取数一次并落库缓存，别让用户每次刷新都打接口（见 [缓存与频率最佳实践](https://www.showapi.com/guides/earthquake-info-caching-best-practice-2274)）。
- **地区筛选**：`area` 不可靠，做「本地相关」按 `location` 含省名过滤。
## FAQ
**Q1：能做成地震报警器吗？**
不能。接口只提供历史地震查询，不含实时预警能力；报警请使用专业预警系统。
**Q2：多久取一次数据合适？**
科普周报/月报场景，每天或每周定时取一次并存本地即可，避免高频调用占用免费额度。
**Q3：怎么挑「本地相关」的地震？**
取回后按 `location` 是否含目标省/市名过滤；或优先取 `from == "ceic"` 的中国台网记录。
**Q4：数据能对外公开展示吗？**
接口为公开免费数据（usgs/ceic 均为公开震情），可用于科普展示；具体使用条款以 ShowAPI 与数据源授权为准。
## 相关能力 / 下一步阅读
- [免费地震信息：课堂教学与科普演示如何接入震例数据](https://www.showapi.com/guides/earthquake-info-education-demo-2274)
- [免费地震信息：用经纬度(lat/lng)在地图上标点绘制震中分布](https://www.showapi.com/guides/earthquake-info-map-visualization-2274)
- [免费地震信息：免费额度下的缓存与调用频率最佳实践](https://www.showapi.com/guides/earthquake-info-caching-best-practice-2274)
- **本系列共 14 篇**：查看[免费地震信息指南总目录](https://www.showapi.com/guides/earthquake-info-guides-2274)
