用途:访问美国国家气象局(NWS)的公开天气数据,覆盖预报、警报、观测、雷达、航空天气与文本产品,数据属公有领域,无需 API Key 或账号。
主要能力:基础地址为 https://api.weather.gov。核心流程为两步:先用 GET /points/{lat},{lon} 将经纬度解析为网格与区域信息,再用返回的 URL 获取预报,如 GET /gridpoints/{wfo}/{x},{y}/forecast(12 小时分段、7 天)或 /forecast/hourly(逐小时)。警报接口包括 /alerts、/alerts/active 及按区域、州、海洋区查询。观测接口含 /stations/{stationId}/observations/latest 等。另有区域(/zones)、航空(TAF、SIGMET/AIRMET、CWSU)、雷达(/radar/servers、/radar/stations)、文本产品(/products)与办公室(/offices)等端点。
使用方式:每个请求必须携带 User-Agent 头,例如 User-Agent: (myweatherapp.com, contact@myweatherapp.com),否则可能被拦截。默认返回 GeoJSON,可用 Accept 头切换 JSON-LD、DWML、CAP、OXML、ATOM。时间均为 ISO-8601。可选 Feature-Flags 头启用温度/风速的 QuantitativeValue 表示等特性。
限制:仅覆盖美国。速率限制未公开,官方称对常规使用较宽松,超限后约 5 秒重试;建议缓存 /points 响应。已知问题包括 /radar/queues 结果较大时可能返回 503、部分时区外站点 24 小时最高/最低温为 null、观测数据可能延迟约 20 分钟、/icons 端点已弃用。错误响应含 type、title、status、detail、correlationId 字段。
适用场景:需要美国天气数据的应用、脚本与数据分析。具体收费、价格与平台支持信息暂未提供。