USGS Water Services

简介

USGS Water Services 通过 NWIS 即时值 API 提供美国监测站的实时和历史水数据——流量、水位、水温和水质。免密钥且免费（实测可用），是美国水文数据的权威来源。

快速开始

某站点的即时值（实测可用——波托马克河）：

curl "https://waterservices.usgs.gov/nwis/iv/?format=json&sites=01646500&period=P1D"

{
  "value": {
    "timeSeries": [
      {
        "sourceInfo": { "siteName": "POTOMAC RIVER NEAR WASH, DC", "siteCode": [{ "value": "01646500" }] },
        "variable": { "variableName": "Streamflow, ft\u00b3/s" },
        "values": [
          { "value": [{ "value": "5120", "dateTime": "2026-08-22T04:45:00.000-04:00" }] }
        ]
      }
    ]
  }
}

日值（历史）：

curl "https://waterservices.usgs.gov/nwis/dv/?format=json&sites=01646500&startDT=2026-08-01&endDT=2026-08-22"

认证方式

无需认证——免密钥。

速率限制与注意事项

• 免费、公开的美国政府数据——无密钥、配额宽松（批量查询有每 IP 上限）。
• 端点：/nwis/iv/（瞬时）、/nwis/dv/（日值）、/nwis/gwlevels/（地下水）。
• 参数：sites（逗号分隔 ID）、period=P1D/P7D/P30D、startDT/endDT（ISO 日期）、format=json|xml|waterml。
• 站点编号是 USGS 标识符——通过站点搜索或 /nwis/site/ 端点查找。

常见问题

USGS Water Services 免费吗？ 是的——免费、免密钥、公开政府数据。

如何找到站点 ID？ 用 USGS 水数据搜索，或查询 /nwis/site/?format=rdb&stateCd=VA。

支持什么格式？ JSON、XML 和 WaterML（用于水文软件）。