跳转到内容
ZGI Services

地震查询

按时间窗口（最多 31 天）查询 USGS 地震目录，可按最小震级和圆形区域筛选，返回时间、震级、地点、坐标、深度和海啸标记。
接口 POST /v1/earthquake-queries
所需权限 earthquake:query
MCP 工具 earthquake
计量单位 events

计量单位出现在 execution.usage.units 中，用于对账和计费。

请求字段

Section titled “请求字段”
字段 类型 必填 说明
invocation_id string 是 调用方（市场）生成的调用 ID：同一个 ID 在同一操作上只执行一次，用同一 ID 重试会被拒绝而不会重复计费。1–128 个字符，可用 A-Z a-z 0-9 . _ : -。
provider string 是 处理本次请求的数据源，按下方数据源表的覆盖范围选择。 可选值：usgs
end_time string 是 窗口结束时间，RFC 3339 格式，晚于 start_time 且最多相差 31 天。
start_time string 是 窗口开始时间，RFC 3339 格式，例如 2024-01-01T00:00:00Z，不能是未来时间。
latitude number 否 可选，圆形区域中心纬度，-90 到 90；latitude、longitude、radius_km 必须同时提供。
longitude number 否 可选，圆形区域中心经度，-180 到 180；latitude、longitude、radius_km 必须同时提供。
max_results integer 否 返回的事件数量，1–200，默认 50。
min_magnitude number 否 可选，最小震级，-1 到 10。
radius_km number 否 可选，圆形区域半径（公里），大于 0 且不超过 20001.6；latitude、longitude、radius_km 必须同时提供。

数据源

Section titled “数据源”
数据源 区域 说明 限制
usgs US 美国地质调查局（USGS）地震目录 max_results: 200, max_window_days: 31, timeout_seconds: 30

示例

Section titled “示例”
终端窗口
curl -sS https://services.zgi.im/v1/earthquake-queries \
  -H "Authorization: Bearer $ZGI_SERVICES_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"invocation_id": "docs-1791778521-earthquake", "provider": "usgs", "start_time": "2026-10-01T00:00:00Z", "end_time": "2026-10-10T00:00:00Z", "min_magnitude": 5, "max_results": 2}'

返回

Section titled “返回”

以下为一次真实调用的返回，列表只保留前两项，长文本已截断。

{
  "code": 0,
  "message": "success",
  "data": {
    "execution": {
      "id": "exe_01a12e529e7b7e20b4a720035d89ea42",
      "invocation_id": "docs-1791778521-earthquake",
      "capability": "earthquake",
      "operation": "earthquake.query",
      "provider": "usgs",
      "outcome": "succeeded",
      "error_category": null,
      "error_code": null,
      "usage": {
        "provider_requests": 1,
        "units": [
          {
            "name": "events",
            "value": 2,
            "source": "measured"
          }
        ]
      },
      "upstream_ref": null,
      "request_id": "req_7278bd84a77ced9d025064b3",
      "started_at": "2026-10-12T04:15:28.891923377Z",
      "finished_at": "2026-10-12T04:15:28.988018613Z",
      "duration_ms": 96
    },
    "result": {
      "events": [
        {
          "id": "us6000u1ay",
          "time": "2026-10-09T23:12:37.79Z",
          "magnitude": 5.4,
          "magnitude_type": "mb",
          "place": "9 km SSE of Los Asientos, Panama",
          "latitude": 7.4366,
          "longitude": -80.0968,
          "depth_km": 10,
          "tsunami_flag": false,
          "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000u1ay"
        },
        {
          "id": "us6000u1ax",
          "time": "2026-10-09T23:10:02.875Z",
          "magnitude": 5,
          "magnitude_type": "mb",
          "place": "8 km ESE of La Tronosa, Panama",
          "latitude": 7.3962,
          "longitude": -80.5284,
          "depth_km": 10,
          "tsunami_flag": false,
          "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000u1ax"
        }
      ],
      "source": {
        "name": "USGS Earthquake Hazards Program",
        "license": "US public domain",
        "url": "https://earthquake.usgs.gov"
      }
    }
  }
}