全球地震历史数据查询API集成指南
引言
地震研究、灾害预防和应急响应等领域都需要可靠的地震历史数据作为参考。全球地震历史数据查询API提供了标准化的接口,让开发者能够快速获取全球范围内的地震记录,包括时间、地点、震级等关键信息。无论是学术研究还是商业应用,都可以通过该API高效地访问权威地震数据。
快速开始
注册与认证
1.注册起零数据平台
2.登录控制台,右上角--获取API的TOKEN密钥即可
接口地址
https://api.istero.com/resource/v1/earthquak/data
请求参数
请求头部 | 必填 | 值 | 说明 | 示例 |
---|---|---|---|---|
Authorization | 可选 | TOKEN | 用户中心获取到的TOKEN,格式:Bearer <token> | Bearer 89defae676abd3e3a42b41df17c40096 |
参数 | 类型 | 必填 | 默认 | 描述 | 示例 |
---|---|---|---|---|---|
token | string | 可选 | 无 | 如传入Authorization,此参数可以忽略 | 89defae676abd3e3a42b41df17c40096 |
m | string | 否 | 无 | 震级 | 3.1 |
startTime | string | 否 | 无 | 发生时间(区间开始) | 2024-01-01 00:00:00 |
endTime | string | 否 | 无 | 发生时间(区间结束) | 2024-02-01 00:00:00 |
page | int | 否 | 1 | 页数 | 1 |
deph | int | 否 | 无 | 深度 | 5 |
location | string | 否 | 无 | 位置 | 美国 |
GET请求实例
https://api.istero.com/resource/v1/earthquak/data?token=TOKEN&m=3.1&startTime=2024-01-01 00:00:00&endTime=2024-02-01 00:00:00&page=1&deph=5&location=美国
响应数据
{
"code": 200,
"data": {
"total": 95,
"pageCount": 10,
"currentPage": 1,
"lists": [
{
"m": "5.8",
"time": "2025-02-14 07:59:26",
"lat": "55.80",
"long": "-155.20",
"deph": 10,
"location": "美国阿拉斯加州以南"
},
{
"m": "5.5",
"time": "2024-12-22 11:55:59",
"lat": "55.95",
"long": "-154.15",
"deph": 10,
"location": "美国阿拉斯加州以南海域"
},
{
"m": "5.7",
"time": "2024-12-10 07:08:35",
"lat": "39.05",
"long": "-118.85",
"deph": 10,
"location": "美国内华达州"
},
{
"m": "7.0",
"time": "2024-12-06 02:44:26",
"lat": "40.40",
"long": "-125.00",
"deph": 10,
"location": "美国加利福尼亚州北部沿岸近海"
},
{
"m": "6.0",
"time": "2024-10-31 04:15:21",
"lat": "43.65",
"long": "-127.75",
"deph": 10,
"location": "美国俄勒冈州沿岸远海"
},
{
"m": "5.1",
"time": "2024-09-17 08:49:43",
"lat": "32.40",
"long": "-102.05",
"deph": 10,
"location": "美国得克萨斯州"
},
{
"m": "5.4",
"time": "2024-08-07 12:09:57",
"lat": "35.00",
"long": "-119.10",
"deph": 10,
"location": "美国加利福尼亚州"
},
{
"m": "5.3",
"time": "2024-08-01 18:03:18",
"lat": "54.50",
"long": "-159.60",
"deph": 30,
"location": "美国阿拉斯加州以南"
},
{
"m": "5.5",
"time": "2024-03-27 11:23:05",
"lat": "42.45",
"long": "-126.80",
"deph": 10,
"location": "美国俄勒冈州沿岸远海"
},
{
"m": "6.0",
"time": "2024-01-12 15:46:21",
"lat": "56.60",
"long": "-135.75",
"deph": 10,
"location": "美国阿拉斯加州东南部附近海域"
}
]
},
"message": "",
"elapsedTime": "28.58ms",
"providerName": "ISAS起零API:https://api.istero.com"
}
响应数据说明
参数 | 描述 |
---|---|
code | 响应码 |
data | 响应数据 |
total | 总数 |
pageCount | 总页数 |
currentPage | 当前页数 |
lists | |
m | 震级 |
time | 发生时间 |
lat | 纬度 |
long | 经度 |
deph | 深度 |
location | 地震位置 |
message | 返回信息 |
elapsedTime | 响应耗时(ms) |
响应码参照
代码 | 描述 |
---|---|
200 | 数据返回成功 |
202 | 余额不足,仅付费接口会出现此状态码 |
302 | 接口维护/停止服务 |
400 | 请求失败,“message”显示错误信息 |
403 | TOKEN鉴权失败 |
404 | 接口不存在 |
429 | 超出会籍QPS限制 |
500 | 接口服务器错误 |
502 | 账号被封锁/冻结 |
应用案例与使用场景
- 科研机构与大学:研究人员可通过API批量获取历史地震数据,用于地质活动分析、地震带研究或灾害预测模型的训练。
- 应急管理平台:政府或非营利组织在构建灾害预警系统时,可集成该API,结合历史地震数据评估区域风险等级,优化应急预案。
- 新闻媒体与数据可视化:记者或数据分析师可以调用API获取特定时间段内的地震记录,生成交互式地图或时间线,帮助公众更直观地理解地震活动趋势。
结论
全球地震历史数据查询API为开发者提供了便捷的途径,使其无需手动收集和整理庞杂的地震记录,即可直接获取结构化数据。无论是用于科学研究、灾害管理,还是公众信息传播,该API都能显著提升数据获取效率。建议开发者根据实际需求,合理设置查询参数(如时间范围、地理区域、震级阈值等),以优化数据检索性能。