免费地震信息指南总目录（apiCode=2274）
# 免费地震信息指南总目录（apiCode=2274）
> 接口一句话速览：免费地震信息（apiCode=2274，接入点 2274-1）是易源（万维易源）官方自营的生活服务类接口，基于时间查询近一年的全球历史地震数据，用于教育研究、科普演示与防灾意识提升，**不提供实时预警**。注册即享免费额度（有档位限制），支持 MCP 与 OpenAPI 3.0 集成。
**接口地址**：`https://route.showapi.com/2274-1?appKey={your_appKey}` | **方式**：POST/GET | **返回**：JSON | **计费**：免费（档位限制详见 [免费 API 说明](https://www.showapi.com/free-api)）
本系列共 14 篇文章，按「入门 → 场景 → 技术深挖 → 行业 → 最佳实践 → 生态集成」分层，帮你从第一次调用到生产级集成一次看懂。
## 入门层
1. [免费地震信息：5 分钟从注册到调通第一条地震记录](https://www.showapi.com/guides/earthquake-info-quickstart-2274)
注册、拿 AppKey、发起第一次调用并解析返回，提供 Python / cURL / Node.js 三语言可运行代码。
2. [免费地震信息：返回字段全解（ret_code / mag / from 一文读懂）](https://www.showapi.com/guides/earthquake-info-response-fields-2274)
信封字段 + 业务字段对照表，讲清 ret_code 0/-1、earthquakes[] 每条 10 个字段的含义。
3. [免费地震信息：date 与 area 参数使用指南（含实测筛选坑）](https://www.showapi.com/guides/earthquake-info-params-guide-2274)
date 用法与 area 实测「未按省名过滤」的避坑说明，告诉你正确的筛选姿势。
## 场景实战层
4. [免费地震信息：做一个「全球近期地震」查询页（前端实战）](https://www.showapi.com/guides/earthquake-info-recent-quakes-app-2274)
日期选择 → 调用 → 列表/卡片渲染的完整前端示例。
5. [免费地震信息：用经纬度(lat/lng)在地图上标点绘制震中分布](https://www.showapi.com/guides/earthquake-info-map-visualization-2274)
用返回的经纬度在地图上标点并生成震中分布图，含坐标系说明。
6. [免费地震信息：课堂教学与科普演示如何接入震例数据](https://www.showapi.com/guides/earthquake-info-education-demo-2274)
教师与科普运营无代码基础也能用的取数思路，把真实震例做成课件。
## 技术深挖层
7. [免费地震信息：震级(mag)与烈度到底有什么区别？字段口径详解](https://www.showapi.com/guides/earthquake-info-mag-vs-intensity-2274)
纠偏文档把 mag 标为「烈度」——从取值与数据源判定其为震级，并解释两者差异。
8. [免费地震信息：数据来源 usgs / ceic 有什么区别？该怎么用](https://www.showapi.com/guides/earthquake-info-data-sources-2274)
实测来源 usgs（美国地质调查局）与 ceic（中国地震台网）的覆盖差异与用法。
9. [免费地震信息：timeLocal / timestampLocal 时区口径与跨时区处理](https://www.showapi.com/guides/earthquake-info-time-local-utc-2274)
实测 timeLocal 实为北京时间(UTC+8)而非震中当地时，给出跨时区处理建议。
## 行业方案层
10. [免费地震信息：学校/社区防灾科普系统如何接入历史震情](https://www.showapi.com/guides/earthquake-info-school-safety-2274)
周期性科普与避险教育如何接入历史震例，不夸大实时能力。
11. [免费地震信息：科研取数——按日期批量导出震情做统计](https://www.showapi.com/guides/earthquake-info-research-dataset-2274)
用 date 遍历 + 客户端聚合做频次/震级分布统计，说明无官方批量接口。
## 最佳实践层
12. [免费地震信息：免费额度下的缓存与调用频率最佳实践](https://www.showapi.com/guides/earthquake-info-caching-best-practice-2274)
免费档位下按「日期+地区」做本地缓存、控制查询频次、重试退避。
## 生态集成层
13. [免费地震信息：通过 MCP 在 AI 客户端直接查询地震数据](https://www.showapi.com/guides/earthquake-info-mcp-integration-2274)
基于官方 MCP 配置，在 Cherry Studio / ChatBox 等客户端直接调用。
14. [免费地震信息：导入 Postman / Swagger UI 用 OpenAPI 管理接口](https://www.showapi.com/guides/earthquake-info-openapi-import-2274)
下载 YAML → 导入 Postman / Swagger UI 自动生成请求模板与 Mock。
## 相关资源
- 接口详情页：[免费地震信息（apiCode=2274）](https://www.showapi.com/apiGateway/view/2274)
- 接入点详情：[地震信息 2274-1](https://www.showapi.com/apiGateway/view/2274/1)
- OpenAPI 文档：[YAML](https://www.showapi.com/openapi/market/2274.yaml) ｜ [JSON](https://www.showapi.com/openapi/market/2274.json)
- AppKey 管理：[控制台 → 我的应用](https://www.showapi.com/console#/myApp)
- 免费额度与档位：[免费 API 说明](https://www.showapi.com/free-api)
## 阅读建议
- **第一次用**：按 1 → 2 → 3 顺序，先把调用跑通、读懂字段、避开 area 坑。
- **要做可视化/页面**：看 4、5；**教学/科普**：看 6、10。
- **写生产代码前**：必看 7、8、9（震级口径、数据源、时区三个易错点）与 12（缓存与频率）。
- **接 AI / API 治理**：看 13、14。
