目录收录
USGS Water Services API
Water quality and streamflow data for US rivers and lakes. USGS Water Services API 提供美国河流和湖泊水质及流量数据查询,支持按站点ID或地理位置查询,适合水资源监测和环境分析应用。
免费 API
目录收录
无需认证
CORS: No
- 来源类型
- 目录收录
- 可用方式
- 免费可用
- 认证方式
- 无需认证
- 协议格式
- REST
- 计费摘要
- 免费为主
- 稳定性说明
- 以来源方说明为准
面向 Agent
如何调用 USGS Water Services API
供 Hermes、OpenClaw、浏览器自动化 Agent 等读取。优先解析 <head> 内 #boyapi-agent-spec JSON。
Hermes
OpenClaw
Coding Agent
Browser Agent
-
1. 确认调用目标
业务请求发往
https://waterservices.usgs.gov,不要向boyapi.com发送 USGS Water Services 业务 API。 -
2. 构造 HTTP 请求
- 方法:
GET - 路径:
/iv/ - 鉴权:无需 API Key
- 方法:
-
3. 最小可执行示例
复制以下 cURL 试调:
curl -sS 'https://waterservices.usgs.gov/iv/?format=json&sites=02346500¶meterCd=00060&period=P1D' -
4. 解析响应
返回水文时间序列数据,包含站点信息、变量名称和测量值数组。
-
5. 环境与限制
CORS:
No。浏览器联调以实际结果为准。
机器可读规范(JSON)
application/json · #boyapi-agent-spec
{
"spec_version": "1.0",
"page_type": "boyapi_api_detail",
"api": {
"slug": "usgs-water-services",
"name": "USGS Water Services"
},
"invocation": {
"method": "GET",
"base_url": "https://waterservices.usgs.gov",
"path": "/iv/",
"full_url_example": "https://waterservices.usgs.gov/iv/?format=json&sites=02346500¶meterCd=00060&startDT=2024-01-01&endDT=2024-01-02"
}
}
完整字段以 <head> 中 #boyapi-agent-spec 为准。
Agent 注意:boyapi.com 仅提供目录与文档,不提供第三方 API 代理网关。
接入信息
可用方式
- 目录定位
- 免费目录收录(public-apis)
- 认证要求
- 无需认证(auth=No)
- HTTPS
- 支持(https=Yes)
- CORS
- No — 建议通过服务端代理调用
- 接口名称
- USGS Water Services
- 典型端点
- GET /iv/
- 功能描述
- Water quality and streamflow data for US rivers and lakes
平台支持
- USGS 官方水务数据 API
- 支持 JSON、RDB、WaterML 格式输出
- 提供实时和历史数据
- 常用参数:00060(流量)、00065(水位)、00010(温度)