USGS 地震与水文数据
美国地质调查局（USGS）发布全球地震目录，以及美国各地监测站点的水文观测。通过 ScholarMuse，agent 可以按区域、震级和日期检索世界各地的地震，也可以列出美国某个州或某个经纬度范围内的 USGS 水文站点，并取回它们的逐日平均值。
对应的 ScholarMuse 工具：search_earthquakes、get_water_data。每次成功调用都会扣积分。
可以这样问你的 agent
你的 agent 会拿到什么
每条记录都带有 id、source、title、url、license、attribution 和 retrievedAt。下面是来自 USGS 的数据字段。
search_earthquakes
每次地震一条记录，并附上对应的 USGS 事件页面链接。
- magnitude
- 震级
- magnitudeType
- USGS 给出的震级类型
- place
- 地点的文字描述
- time
- 发震时间（UTC，ISO 8601）
- latitude
- 震中纬度
- longitude
- 震中经度
- depthKm
- 震源深度（公里）
- feltReports
- 有感报告数量
- maxIntensityMmi
- 估计的最大烈度（MMI）
- pagerAlert
- PAGER 警报级别（如有）
- tsunamiFlag
- USGS 标记了海啸时为 true
- reviewStatus
- 事件是自动生成还是已人工审核
get_water_data
给出站点编号时，返回一条序列记录（下面从 parameter 到 observations 的字段）。不给站点编号时返回站点列表，每个站点带 siteNumber、name、state、county、latitude、longitude、recordStart 和 recordEnd。
- site
- 站点编号、名称、州、县、坐标和流域面积
- parameter
- streamflow、gage_height 或 water_temperature
- parameterCode
- USGS 参数代码，如 00060
- statistic
- 固定为 daily mean（日平均）
- unit
- USGS 给出的计量单位
- count
- 返回的逐日值数量
- min
- 时段内最小值
- max
- 时段内最大值
- mean
- 时段内平均值
- provisionalDays
- 数值尚未审定的天数
- observations
- 日期、数值和审定状态的行
覆盖范围
- 全球地震：可以按中心点加半径检索，不给位置则全球检索。
- 水文数据只来自 USGS 监测站点。州筛选只接受美国 50 个州、哥伦比亚特区和波多黎各。
- 三种水文量的日平均值：流量、水位和水温。
限制
- 水文数据只覆盖美国，没有其他国家的河流或地下水读数。
- 地震检索每次最多返回 200 个事件（默认 20 个）；不给日期时默认查最近 30 天。
- 水文序列每次最多 2,000 天，站点列表最多 50 个；只返回日平均值，不返回 15 分钟一次的读数。
- 近期的水文值可能是临时数据；请求可能要等 30 到 40 秒才超时。
ScholarMuse 怎么访问 USGS
地震检索直接调用 earthquake.usgs.gov 的 USGS FDSN event 服务，不带 key。水文请求调用 api.waterdata.usgs.gov 的 USGS Water Data OGC API；配置了 api.data.gov key 时会带上，没有 key 也能正常返回。
地震检索缓存 10 分钟（结束日期在 30 天以前的缓存 1 天）；逐日水文值缓存 1 小时（结束于 400 天以前的时段缓存 7 天），站点列表缓存 1 天。
API key：上游 API 不用 key 也能调用，你不用申请。
许可与署名
许可：Public domain (US Government work)
Data from the U.S. Geological Survey (earthquake.usgs.gov, waterdata.usgs.gov). Recent water data may be provisional.
来自 USGS 的记录都带这段许可和署名。 在论文里引用时，请按 USGS 自己的引用要求来写。
