国家气象局 (NWS)

nws 平台使用 国家气象局 的网络 API 作为您当前位置气象数据的来源。

配置

要将 国家气象局 (NWS) integration 添加到您的 Home Assistant 实例中,请使用此 My 按钮:

手动配置步骤

如果上述 My 按钮不起作用,您也可以手动执行以下步骤:

  • 浏览到您的 Home Assistant 实例。

  • 转到 设置 > 设备与服务

  • 在右下角,选择 Add Integration 按钮。

  • 从列表中选择 国家气象局 (NWS)

  • 按照屏幕上的说明完成设置。

根据 API 文档,需要提供一个字符串作为 API 密钥,并建议在该字符串中包含一个电子邮件地址。

提供 METAR 站代码是可选的,如果不提供,将选择与给定纬度和经度最接近的站点。如果没有站点提供,附近站点的列表将以 DEBUG 级别打印到日志中。站点也可以在 NOAA 网站 上找到。仅有三个字符的代码,例如 ADW 应该前缀为字母 K,即 KADW

每个配置中的条目都会创建一个天气实体。通过 weather.get_forecasts 操作 提供每小时和昼夜的预报。每个预报的时间是预报的开始时间。传感器在配置后也会作为禁用实体创建,用户可以启用它们。

操作 nws.get_forecasts_extra

nws.get_forecasts_extra 提供与 weather.get_forecasts 类似的额外数据。请参见 weather.get_forecasts 文档

数据属性 可选 描述 示例
type 预报的类型,必须是 twice_dailyhourly twice_daily
action: nws.get_forecasts_extra
target:
  entity_id:
    - weather.khou
data:
  type: twice_daily
response_variable: weather_forecast

响应数据字段是调用目标实体的映射,每个实体都包含 forecast 字段。 forecast 是在给定时间点预测的条件列表,这些条件不是通过 weather.get_forecasts 返回的。仍然提供 datetimeis_daytime 属性以供参考。

响应数据 描述 示例
datetime 预测条件的时间。 2023-02-17T14:00:00+00:00
is_daytime 仅针对 twice_daily 预测设置。 True
detailed_description 仅针对 twice_daily 预测设置。 50% 降雨机会,否则局部多云,最高温度 75°F。
short_description 短天气条件 部分阳光,稍有降雨和雷暴的机会

详细信息

有关 API 的详细信息,请参见 NWS API 文档。使用 pynws 库来检索数据。