适用场景地震速报数据在防灾减灾、科研分析、媒体播报等领域有广泛应用。例如地震监测大屏实时展示区域近期地震事件红色高亮显著地震。新闻推送自动抓取震级≥4.5的地震事件生成播报稿件。科研数据采集按小时或天批量下载地震参数用于统计建模。全球地震速报API提供分钟级更新的结构化数据支持按时间范围、震级档位、最小震级多条件过滤并返回震源深度、经纬度、烈度、海啸提示等字段一条接口即可覆盖上述场景。接口能力边界数据来源汇聚全球多个监测机构USGS、EMSC等的实时数据经校验后入库。更新频率数据每分钟同步一次API网关缓存60秒即数据延迟不超过2分钟。QPS限制10次/秒超出会返回429状态码。单次请求建议通过limit参数控制返回条数最大500避免频繁分页。时间范围支持 hour1小时、day1天、week7天、month30天。震级档位all全部、significant显著地震、4.5M4.5、2.5M2.5、1.0M1.0。注意level参数是预定义档位min_magnitude是附加过滤两者可同时使用以获得更精细控制。鉴权与请求参数鉴权方式在Header中传入Authorization格式为Bearer 你的API Key。示例Authorization: Bearer YOUR_API_KEY若使用X-API-Key部分版本兼容也要确保Key有效。请求体参数详解参数名类型必填说明periodstring否时间范围hour/day/week/month默认daylevelstring否震级档位all/significant/4.5/2.5/1.0默认allmin_magnitudenumber否最小震级过滤0表示不过滤若传4.5则只返回震级≥4.5的事件orderstring否排序方向time按时间降序或 magnitude按震级降序默认timelimitnumber否返回条数上限取值1~500默认100参数均为可选但实际使用中建议至少指定period和level否则默认返回一天内全部地震数据量较大。curl 请求示例以下命令查询最近1周内震级≥2.5的地震按时间排序返回前50条curl -sS \ -X POST \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json \ -d { period: week, level: 2.5, min_magnitude: 2.5, order: time, limit: 50 } \ https://v1.apizero.cn/api/earthquake替换YOUR_API_KEY为实际Key后将返回JSON数据。若需要查询最近1小时内所有地震不论震级可改为-d {period: hour, level: all, min_magnitude: 0, order: time, limit: 500}返回值解读成功响应HTTP状态码200JSON结构如下{ code: 0, msg: 成功, request_id: abc123, data: { earthquakes: [ { id: us7000abcd, magnitude: 6.5, magnitude_type: mww, depth_km: 42.3, latitude: 5.62, longitude: 125.11, place: 34 km WSW of Sarangani, Philippines, time: 2026-07-01 09:12:30, timestamp: 1782877783910, alert: green, tsunami: false, intensity_mmi: 5.2, felt: 49, significance: 650, status: 人工复核, event_type: 地震 } ], summary: { count: 100, total: 240, max_magnitude: 6.5, period: week, level: 2.5, generated_at: 2026-07-01 12:45:33 } } }主要字段说明code0表示成功非0请参考msg描述。earthquakes[]地震事件列表每个对象包含id地震事件唯一标识如USGS编号。magnitude震级浮点数。magnitude_type震级类型mww面波震级、mb体波震级等。depth_km震源深度千米。latitude/longitude震中经纬度。place地名英文国际标准描述。time发生时间北京时间 UTC8。timestampUnix毫秒时间戳。alert警报级别green/yellow/orange/redgreen表示无需预警。tsunami是否触发海啸预警。intensity_mmi修正麦加利烈度MMI估计值。felt有震感报告数量。significance地震显著性评分USGS指标。status数据状态自动/人工复核。event_type事件类型地震/爆炸等。summary本次请求的汇总信息包括返回条数count、总数total、最大震级等。错误码示例状态码msg示例说明200(code-1)参数校验失败请检查必填参数类型401鉴权失败Authorization无效或过期429请求频率过高超过QPS限制需降低并发500服务器内部错误可稍后重试常见错误排查始终返回空列表检查min_magnitude是否设得过高或者所选时间范围内确实无地震可以先用levelallmin_magnitude0periodday测试确保有数据。鉴权失败确认Authorization格式为Bearer开头Key未过期。返回数据不完整limit参数最大500若需要更多请拉长period或分多次请求。响应慢如果一次性请求month范围全震级数据量较大历史可达数万条响应时间可能超过1秒。建议适当限制limit。工程化注意事项1. 数据去重与增量拉取由于网关缓存60秒多次请求可能返回重复事件。建议在本地以id为主键去重并记录最新一条事件的timestamp下次请求时通过参数组合缩小时间窗口实现增量更新。例如每5分钟请求一次periodhour本地只保存新出现的id。2. 请求限速与重试策略API QPS上限10建议客户端控制并发数在8以下并用指数退避重试如遇到429等待1秒再试。可以使用信号量或异步队列限制请求速率。3. 国际化地名的处理place字段为英文描述可配合latitude/longitude反向地理编码得到中文地名文中避免直接依赖机器翻译接口。建议存储原始英文名作为备用。4. 异常天气与海啸标志若应用需播报海啸预警应关注tsunamitrue且alert为orange/red的事件单独触发告警流。5. 地震烈度与影响评估intensity_mmi为估计值实际有震感范围需结合人口密度。可配合地图服务可视化显示。参考文档全球地震速报API原始文档接口调试与参数说明
