WeatherForensics-REST-API

Connects to the Forever Free subscription tier to WeatherForensics. NOAA historical weather.

原始信息汇总

WeatherForensics-REST-API 数据集概述

数据集基本信息

• 数据集名称: WeatherForensics-REST-API
• 类别: 天气
• 提供商: Mark Kiehl (Mechatronic Solutions LLC)
• 访问方式: REST API
• 定价: 免费（提供付费订阅计划）

核心功能与服务描述

WeatherForensics 是一项数据即服务（DaaS），提供全面的历史天气数据，包括标准天气条件和恶劣天气事件，数据关联到指定的目标位置和时间戳。其专有引擎计算历史天气事件（从局部龙卷风到区域飓风）在特定坐标和日期时间内的本地化影响。

数据源与范围

• 标准天气数据: 源自美国国家海洋和大气管理局（NOAA）国家环境信息中心（NCEI）。
• 恶劣天气数据: 源自 NOAA NCEI 恶劣天气数据清单（SWDI）。
• 热带气旋数据: 源自 NOAA 国家飓风中心（NHC）HURDAT2 数据库。

API 端点

标准天气端点

• POST /api/noaa_ncei_monthly_weather
• POST /api/noaa_ncei_daily_weather
• POST /api/noaa_ncei_hourly_weather

恶劣天气端点

• POST /api/noaa_swdi_nx3tvs_tornado_impact_to_location
• POST /api/noaa_swdi_supercell_storm_nx3mda_impact_to_location
• POST /api/noaa_swdi_nx3hail_impact_to_location
• POST /api/noaa_swdi_nx3structure_impact_to_location

热带气旋端点

• POST /api/noaa_nhc_tropical_cyclone/impact_to_location

主要特性

• 开发者就绪格式: 所有端点的响应均以干净的 JSON 数据结构提供，便于人类和人工智能代理直接使用。
• 透明的数据溯源: 每个 JSON 负载都明确标识数据内容类别及其权威源数据集。
• 智能数据集路由: API 根据请求的目标年份，自动选择最合适的数据集（传统的 NOAA NCEI ISD 小时数据集或现代的 GHCNh 数据集）。
• 精确空间查询: 对于标准和恶劣天气请求，引擎自动识别目标坐标最近、数据集最全的活动站点。
• 高级气旋影响分析: 对于热带气旋追踪，API 计算风暴质心与目标之间的最小距离，并使用标准的 34、50 和 64 节风半径模型评估最大风力。
• 跨平台兼容性: 完全支持 Linux、macOS 和 Windows 环境。

服务层级与速率限制

所有层级均包含对 MCP 服务器和 REST API 的访问。

层级	价格	速率限制与配额	基础设施
永远免费	$0/月	10-15 RPM，500 请求/天，1 并发	共享社区资源
专业版	$29/月	60 RPM，10,000 请求/天，5 并发	专用端点，零冷启动
企业版	$279/月	500+ RPM，无限并发	专用实例，自定义批量负载

注意: 免费层用户不需要 API 密钥。免费层上的过量请求可能导致 IP 限制或严重延迟。超出层级速率限制将返回 HTTP 429 状态码。

请求与响应格式

• 请求方法: 所有端点均需使用 POST 方法。

• 请求负载: 必须为 JSON 格式，包含目标坐标和本地 ISO 格式的日期时间。 json { "latitude": 40.4407, "longitude": -76.12267, "local_datetime_iso": "2025-07-10T00:00:00" }

• 响应格式: 成功响应返回 HTTP 200 状态码及 JSON 格式的数据负载。

错误处理与 HTTP 状态码

• 200 OK: 请求成功，返回 JSON 负载。
• 400 Bad Request: 请求负载格式错误、缺少必填字段或包含无效坐标/日期。
• 401 Unauthorized: 为专业版/企业版端点提供了无效或缺失的 API 密钥。
• 429 Too Many Requests: 超出订阅层级的速率限制。
• 500 Internal Server Error: 服务器发生意外错误（例如上游 NOAA API 超时）。

使用条款与归属要求

• 使用权利与限制:
  • 允许: 可将数据用于内部分析、商业应用以及为 AI 模型提供真实背景。
  • 限制: 不得系统性地抓取、批量下载、转售或重新分发原始 API/MCP 响应作为竞争的独立天气数据服务。
• 最终用户归属要求: 任何展示此数据的公开应用程序或 AI 代理界面必须向最终用户显著包含以下归属声明：

  "Weather data derived from NOAA National Centers for Environmental Information (NCEI) and the National Hurricane Center (NHC). This application and its data are not official NOAA products and do not represent any agency determination, view, or policy."

• 免责声明: 服务按“原样”和“可用”提供。数据不应作为生命安全决策、金融交易或法律认定的唯一依据。

技术配置与安装

• 前提条件: 示例脚本 rest_api_noaa_client.py 需要 Python 3.7+ 及以下包： bash pip install httpx asyncio python-json-logger

• 基础 URL 配置:

  • 永远免费层: BASE_URL = "https://api-noaa-free-pnu3qtlxoa-uk.a.run.app"，API_KEY = None
  • 专业版: BASE_URL = "https://weatherforensics.dev/api/pro"，并设置您的 39 字符密钥
  • 企业版: 更新 BASE_URL 为您的自定义网关 URL，并设置您的 39 字符密钥