Adding OpenWeatherMap Minute forecast action

homeassistant/components/openweathermap/const.py

@@ -48,6 +48,7 @@
 ATTR_API_CLOUD_COVERAGE = "cloud_coverage"
 ATTR_API_FORECAST = "forecast"
 ATTR_API_CURRENT = "current"
+ATTR_API_MINUTE_FORECAST = "minute_forecast"
 ATTR_API_HOURLY_FORECAST = "hourly_forecast"
 ATTR_API_DAILY_FORECAST = "daily_forecast"
 UPDATE_LISTENER = "update_listener"

homeassistant/components/openweathermap/coordinator.py

@@ -7,6 +7,7 @@
     CurrentWeather,
     DailyWeatherForecast,
     HourlyWeatherForecast,
+    MinutelyWeatherForecast,
     OWMClient,
     RequestError,
     WeatherReport,
@@ -27,10 +28,14 @@
     ATTR_API_CONDITION,
     ATTR_API_CURRENT,
     ATTR_API_DAILY_FORECAST,
+    ATTR_API_DATETIME,
     ATTR_API_DEW_POINT,
     ATTR_API_FEELS_LIKE_TEMPERATURE,
+    ATTR_API_FORECAST,
     ATTR_API_HOURLY_FORECAST,
     ATTR_API_HUMIDITY,
+    ATTR_API_MINUTE_FORECAST,
+    ATTR_API_PRECIPITATION,
     ATTR_API_PRECIPITATION_KIND,
     ATTR_API_PRESSURE,
     ATTR_API_RAIN,
@@ -94,6 +99,11 @@ def _convert_weather_response(self, weather_report: WeatherReport):
 
         return {
             ATTR_API_CURRENT: current_weather,
+            ATTR_API_MINUTE_FORECAST: (
+                self._get_minute_weather_data(weather_report.minutely_forecast)
+                if weather_report.minutely_forecast is not None
+                else {}
+            ),
             ATTR_API_HOURLY_FORECAST: [
                 self._get_hourly_forecast_weather_data(item)
                 for item in weather_report.hourly_forecast
@@ -104,6 +114,17 @@ def _convert_weather_response(self, weather_report: WeatherReport):
             ],
         }
 
+    def _get_minute_weather_data(self, minute_forecast: list[MinutelyWeatherForecast]):
+        return {
+            ATTR_API_FORECAST: [
+                {
+                    ATTR_API_DATETIME: item.date_time,
+                    ATTR_API_PRECIPITATION: round(item.precipitation, 2),
+                }
+                for item in minute_forecast
+            ]
+        }
+
     def _get_current_weather_data(self, current_weather: CurrentWeather):
         return {
             ATTR_API_CONDITION: self._get_condition(current_weather.condition.id),

homeassistant/components/openweathermap/icons.json

@@ -0,0 +1,7 @@
+{
+  "services": {
+    "get_minute_forecast": {
+      "service": "mdi:weather-snowy-rainy"
+    }
+  }
+}

homeassistant/components/openweathermap/services.yaml

@@ -0,0 +1,5 @@
+get_minute_forecast:
+  target:
+    entity:
+      domain: weather
+      integration: openweathermap

homeassistant/components/openweathermap/strings.json

@@ -47,5 +47,16 @@
         }
       }
     }
+  },
+  "services": {
+    "get_minute_forecast": {
+      "name": "Get minute forecast",
+      "description": "Get minute weather forecast."
+    }
+  },
+  "exceptions": {
+    "service_minute_forecast_mode": {
+      "message": "Minute forecast is available only when {name} mode is set to v3.0"
+    }
   }
 }

homeassistant/components/openweathermap/weather.py

@@ -14,7 +14,9 @@
     UnitOfSpeed,
     UnitOfTemperature,
 )
-from homeassistant.core import HomeAssistant, callback
+from homeassistant.core import HomeAssistant, SupportsResponse, callback
+from homeassistant.exceptions import ServiceValidationError
+from homeassistant.helpers import entity_platform
 from homeassistant.helpers.device_registry import DeviceEntryType, DeviceInfo
 from homeassistant.helpers.entity_platform import AddEntitiesCallback
 
@@ -28,6 +30,7 @@
     ATTR_API_FEELS_LIKE_TEMPERATURE,
     ATTR_API_HOURLY_FORECAST,
     ATTR_API_HUMIDITY,
+    ATTR_API_MINUTE_FORECAST,
     ATTR_API_PRESSURE,
     ATTR_API_TEMPERATURE,
     ATTR_API_VISIBILITY_DISTANCE,
@@ -44,6 +47,8 @@
 )
 from .coordinator import WeatherUpdateCoordinator
 
+SERVICE_GET_MINUTE_FORECAST = "get_minute_forecast"
+
 
 async def async_setup_entry(
     hass: HomeAssistant,
@@ -61,6 +66,14 @@ async def async_setup_entry(
 
     async_add_entities([owm_weather], False)
 
+    platform = entity_platform.async_get_current_platform()
+    platform.async_register_entity_service(
+        name=SERVICE_GET_MINUTE_FORECAST,
+        schema=None,
+        func="async_get_minute_forecast",
+        supports_response=SupportsResponse.ONLY,
+    )
+
 
 class OpenWeatherMapWeather(SingleCoordinatorWeatherEntity[WeatherUpdateCoordinator]):
     """Implementation of an OpenWeatherMap sensor."""
@@ -91,6 +104,8 @@ def __init__(
             manufacturer=MANUFACTURER,
             name=DEFAULT_NAME,
         )
+        self.mode = mode
+        self.weather_coordinator = weather_coordinator
 
         if mode in (OWM_MODE_V30, OWM_MODE_V25):
             self._attr_supported_features = (
@@ -100,6 +115,17 @@ def __init__(
         elif mode == OWM_MODE_FREE_FORECAST:
             self._attr_supported_features = WeatherEntityFeature.FORECAST_HOURLY
 
+    async def async_get_minute_forecast(self) -> dict[str, list[dict]] | dict:
+        """Return Minute forecast."""
+
+        if self.mode == OWM_MODE_V30:
+            return self.weather_coordinator.data[ATTR_API_MINUTE_FORECAST]
+        raise ServiceValidationError(
+            translation_domain=DOMAIN,
+            translation_key="service_minute_forecast_mode",
+            translation_placeholders={"name": DEFAULT_NAME},
+        )
+
     @property
     def condition(self) -> str | None:
         """Return the current condition."""