首页 ▸ Integrations ▸

OpenWeatherMap

OpenWeatherMap天气集成使用 OpenWeatherMap 作为您所在位置当前气象数据的来源。

目前在Home Assistant中支持以下设备类型：

传感器
天气

您需要一个API密钥，这需要一个订阅。该订阅有一个免费层，提供1000次调用/天。请考虑在OpenWeatherMap网站上设置限制，以保持在不会产生API使用费用的阈值以下。这个操作在计费计划页面的“每日调用”下完成。

⚠️ 重要弃用通知

OpenWeatherMap API V2.5弃用

OpenWeatherMap API V2.5将在2024年10月7日关闭。在此日期之后，您将需要使用API V3.0。

要继续使用该服务：

访问OpenWeatherMap网站并激活One Call订阅。
在激活过程中，您将被要求提供信用卡，但除非您超出免费层限制，否则不会收费。
配置您的OWM集成，选择模式v3.0。
注意：订阅激活可能需要长达2小时。

有关更多详情，请设定您的使用限制，以避免在OpenWeatherMap订阅上产生费用。

Important

如果您在OpenWeatherMap注册了新的API密钥，它将自动激活，这通常需要在您成功注册后10分钟到2小时之间。请记住在配置此集成时，您的新API密钥可能尚未激活。最近的政策变化限制了新注册用户的API访问，免费计划的用户应选择hourly模式。使用其他模式时可能会出现无效API密钥错误。

配置

要将 OpenWeatherMap integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

手动配置步骤

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

浏览到您的 Home Assistant 实例。
转到 设置 > 设备与服务。
在右下角，选择 Add Integration 按钮。
从列表中选择 OpenWeatherMap。
按照屏幕上的说明完成设置。

参数	值
API密钥	来自网站的API密钥
名称	集成的名称
纬度	气象预报和传感器的纬度
经度	气象预报和传感器的经度
模式	`v3.0`（新API版本），提供8天的每日预报和48小时的1小时步长 `v2.5`（弃用的One Call API版本），与`v3.0`相同的预报 `current`（仅当前天气数据，无预报） `forecast`（仅预报，5天3小时步长，无当前天气数据）
语言	接收数据的语言（仅适用于`sensor`）

将为每个支持的条件创建一个传感器实体。它们的ID将遵循以下格式：

sensor.<集成名称>_<监测条件>

传感器提供的数据使用配置集成时选择的语言。

Note

天气实体仅提供英语的数据。Home Assistant会自动将其翻译为为前端配置的语言。

支持的天气条件

当前天气条件

条件	描述
`cloud_coverage`	云量，%。
`condition`	天气条件。
`dew_point`	水滴开始凝结和露水形成的气温，ºC。
`feels_like_temperature`	考虑到人对天气的感知的温度，ºC。
`humidity`	湿度，%。
`precipitation_kind`	最近一小时降水的种类（雨、雪、雨雪、无）。
`pressure`	海平面上的大气压力，hPa。
`rain`	雨降水，mm/h。
`snow`	雪降水，mm/h。
`temperature`	温度，ºC。
`uv_index`	UV指数。
`visibility`	平均能见度，m。
`weather`	天气条件的人可读描述。
`weather_code`	天气条件的ID。
`wind_bearing`	风向，度（气象）。
`wind_speed`	风速，米/秒。

有关API的详细信息，请参见OpenWeatherMap文档。

动作 openweathermap.get_minute_forecast

此动作填充响应数据，映射了下一小时逐分钟的降水预报（雨或雪）。

注意： 仅当OWM集成模式设置为v3.0时，分钟预报才可用。如果模式设置为current、forecast或v2.5，该动作将失败。

action: openweathermap.get_minute_forecast
target:
  entity_id:
    - weather.openweathermap
response_variable: weather_forecast

响应数据字段是forecast字段的映射。 forecast是预测的60个降水级别的列表；每分钟一个，涵盖下一小时：

响应数据	描述	示例
`datetime`	预测条件的时间。	2024-10-19T18:59:00+00:00
`precipitation`	降水量，mm/h。	1.25

示例

示例动作响应

weather.openweathermap:
  forecast:
    - datetime: "2024-10-19T18:59:00+00:00"
      precipitation: 5.46
    - datetime: "2024-10-19T19:00:00+00:00"
      precipitation: 5.62
    - datetime: "2024-10-19T19:01:00+00:00"
      precipitation: 5.62
    - datetime: "2024-10-19T19:02:00+00:00"
      precipitation: 5.62
    - datetime: "2024-10-19T19:03:00+00:00"
      precipitation: 5.62
    - datetime: "2024-10-19T19:04:00+00:00"
      precipitation: 5.62
    - datetime: "2024-10-19T19:05:00+00:00"
      precipitation: 5.62
    - datetime: "2024-10-19T19:06:00+00:00"
      precipitation: 5.62
    - datetime: "2024-10-19T19:07:00+00:00"
      precipitation: 5.62
    - datetime: "2024-10-19T19:08:00+00:00"
      precipitation: 5.62
    - datetime: "2024-10-19T19:09:00+00:00"
      precipitation: 5.62
    - datetime: "2024-10-19T19:10:00+00:00"
      precipitation: 5.62
    - datetime: "2024-10-19T19:11:00+00:00"
      precipitation: 5.62
    - datetime: "2024-10-19T19:12:00+00:00"
      precipitation: 5.62
    - datetime: "2024-10-19T19:13:00+00:00"
      precipitation: 5.62
    - datetime: "2024-10-19T19:14:00+00:00"
      precipitation: 5.62
    - datetime: "2024-10-19T19:15:00+00:00"
      precipitation: 5.62
    - datetime: "2024-10-19T19:16:00+00:00"
      precipitation: 5.79
    - datetime: "2024-10-19T19:17:00+00:00"
      precipitation: 5.96
    - datetime: "2024-10-19T19:18:00+00:00"
      precipitation: 6.14
    - datetime: "2024-10-19T19:19:00+00:00"
      precipitation: 6.31
    - datetime: "2024-10-19T19:20:00+00:00"
      precipitation: 6.48
    - datetime: "2024-10-19T19:21:00+00:00"
      precipitation: 6.68
    - datetime: "2024-10-19T19:22:00+00:00"
      precipitation: 6.89
    - datetime: "2024-10-19T19:23:00+00:00"
      precipitation: 7.09
    - datetime: "2024-10-19T19:24:00+00:00"
      precipitation: 7.29
    - datetime: "2024-10-19T19:25:00+00:00"
      precipitation: 7.49
    - datetime: "2024-10-19T19:26:00+00:00"
      precipitation: 7.72
    - datetime: "2024-10-19T19:27:00+00:00"
      precipitation: 7.95
    - datetime: "2024-10-19T19:28:00+00:00"
      precipitation: 8.18
    - datetime: "2024-10-19T19:29:00+00:00"
      precipitation: 8.42
    - datetime: "2024-10-19T19:30:00+00:00"
      precipitation: 8.65
    - datetime: "2024-10-19T19:31:00+00:00"
      precipitation: 8.65
    - datetime: "2024-10-19T19:32:00+00:00"
      precipitation: 8.65
    - datetime: "2024-10-19T19:33:00+00:00"
      precipitation: 8.65
    - datetime: "2024-10-19T19:34:00+00:00"
      precipitation: 8.65
    - datetime: "2024-10-19T19:35:00+00:00"
      precipitation: 8.65
    - datetime: "2024-10-19T19:36:00+00:00"
      precipitation: 8.91
    - datetime: "2024-10-19T19:37:00+00:00"
      precipitation: 9.18
    - datetime: "2024-10-19T19:38:00+00:00"
      precipitation: 9.45
    - datetime: "2024-10-19T19:39:00+00:00"
      precipitation: 9.72
    - datetime: "2024-10-19T19:40:00+00:00"
      precipitation: 9.98
    - datetime: "2024-10-19T19:41:00+00:00"
      precipitation: 10.29
    - datetime: "2024-10-19T19:42:00+00:00"
      precipitation: 10.6
    - datetime: "2024-10-19T19:43:00+00:00"
      precipitation: 10.91
    - datetime: "2024-10-19T19:44:00+00:00"
      precipitation: 11.22
    - datetime: "2024-10-19T19:45:00+00:00"
      precipitation: 11.53
    - datetime: "2024-10-19T19:46:00+00:00"
      precipitation: 11.89
    - datetime: "2024-10-19T19:47:00+00:00"
      precipitation: 12.24
    - datetime: "2024-10-19T19:48:00+00:00"
      precipitation: 12.6
    - datetime: "2024-10-19T19:49:00+00:00"
      precipitation: 12.96
    - datetime: "2024-10-19T19:50:00+00:00"
      precipitation: 13.31
    - datetime: "2024-10-19T19:51:00+00:00"
      precipitation: 13.31
    - datetime: "2024-10-19T19:52:00+00:00"
      precipitation: 13.31
    - datetime: "2024-10-19T19:53:00+00:00"
      precipitation: 13.31
    - datetime: "2024-10-19T19:54:00+00:00"
      precipitation: 13.31
    - datetime: "2024-10-19T19:55:00+00:00"
      precipitation: 13.31
    - datetime: "2024-10-19T19:56:00+00:00"
      precipitation: 13.73
    - datetime: "2024-10-19T19:57:00+00:00"
      precipitation: 14.14
    - datetime: "2024-10-19T19:58:00+00:00"
      precipitation: 14.55

帮助我们改进翻译

建议编辑此页面，或提供/查看此页面的反馈。

编辑提供反馈查看待处理的反馈