From b889b9a5ecfa333894d4dc06fbf823732a04416f Mon Sep 17 00:00:00 2001 From: Andrey Mityagin <6134677+avee87@users.noreply.github.com> Date: Tue, 17 Jun 2025 12:47:41 +0100 Subject: [PATCH 1/4] Improved MetOffice documentation --- source/_integrations/metoffice.markdown | 45 ++++++++++++++++--------- 1 file changed, 29 insertions(+), 16 deletions(-) diff --git a/source/_integrations/metoffice.markdown b/source/_integrations/metoffice.markdown index 4c2896bd1ece..1ea35d4228c8 100644 --- a/source/_integrations/metoffice.markdown +++ b/source/_integrations/metoffice.markdown @@ -18,31 +18,44 @@ ha_integration_type: integration The **Met Office** weather {% term integration %} uses the Met Office's [DataHub API](https://www.metoffice.gov.uk/services/data/met-office-weather-datahub) for weather data. +Details about the API are available in the [DataHub API documentation](https://datahub.metoffice.gov.uk/docs/f/category/site-specific/overview). The [datapoint-python](https://github.com/EJEP/datapoint-python) library is used to retrieve data. + ## Prerequisites 1. Register for a [Met Office DataHub](https://datahub.metoffice.gov.uk/) account. -2. After registration, [subscribe](https://datahub.metoffice.gov.uk/profile/subscriptions) to [Site Specific Global Spot](https://datahub.metoffice.gov.uk/pricing/site-specific) dataset to obtain your API key. Free tier subscription gives 360 calls per day, which is enough for using this integration +2. After registration, [subscribe](https://datahub.metoffice.gov.uk/profile/subscriptions) to [Site Specific Global Spot](https://datahub.metoffice.gov.uk/pricing/site-specific) dataset to obtain your API key. Free tier subscription gives 360 calls per day, which is enough to use this integration for one weather site. {% include integrations/config_flow.md %} +| Parameter | Value | +| :-------- | :--------------------------------------------------------- | +| API Key | API Key for MetOffice DataHub | +| Latitude | Latitude of the location, defaults to your home latitude | +| Longitude | Longitude of the location, defaults to your home longitude | + ## Entities -This integration creates a number of weather entities for each entry created in the configuration by location: one weather entity with a summary and a forecast (daily, hourly, and twice-daily), and sensor entities for individual reporting on each of the individual measurements. Note that only some of the sensor entities flagged below are enabled by default, so your system isn't overrun on initial configuration. +This integration creates the following entities: -The available sensor entities: +| Entity type | Entity ID | Description | +| :---------- | :------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ | +| weather | `weather.` | Main weather entity for the given location. Daily, hourly and twice-daily forecasts are available | +| sensor | `sensor..weather` | [Weather condition](https://developers.home-assistant.io/docs/core/entity/weather/#recommended-values-for-state-and-condition). | +| sensor | `sensor..temperature` | Temperature, ºC. | +| sensor | `sensor..feels_like_temperature` | Temperature accounting for the human perception of weather, ºC. | +| sensor | `sensor..humidity` | Relative humidity, %. | +| sensor | `sensor..wind_speed` | Wind speed, m/s. | +| sensor | `sensor..wind_gust` | Wind gust speed, m/s. | +| sensor | `sensor..wind_direction` | Wind direction, degrees. | +| sensor | `sensor..visibility` | Visibility distance in meters. | +| sensor | `sensor..uv ` | UV index. | +| sensor | `sensor..precipitation` | Probability of precipitation, %. | +| sensor | `sensor..name ` | Name of the weather station. | -- "feels like" temperature -- humidity -- probability of precipitation -- station name -- temperature -- UV index -- visibility -- weather -- wind direction -- wind gust -- wind speed +Only the main weather entity, probability of precipitation, temperature, weather and wind speed sensors are enabled by default. -Only probability of precipitation, temperature, weather and wind speed are enabled by default. +## Removing the integration -Details about the API are available in the [DataHub API documentation](https://datahub.metoffice.gov.uk/docs/f/category/site-specific/overview). The [datapoint-python](https://github.com/EJEP/datapoint-python) library is used to retrieve data. +This integration follows standard integration removal. + +{% include integrations/remove_device_service.md %} From 7f3c9200d28d18b2be5926994686d519fc3a8947 Mon Sep 17 00:00:00 2001 From: Andrey Mityagin <6134677+avee87@users.noreply.github.com> Date: Tue, 17 Jun 2025 12:56:00 +0100 Subject: [PATCH 2/4] better --- source/_integrations/metoffice.markdown | 46 +++++++++++++++---------- 1 file changed, 28 insertions(+), 18 deletions(-) diff --git a/source/_integrations/metoffice.markdown b/source/_integrations/metoffice.markdown index 1ea35d4228c8..e3231ea87293 100644 --- a/source/_integrations/metoffice.markdown +++ b/source/_integrations/metoffice.markdown @@ -35,24 +35,34 @@ Details about the API are available in the [DataHub API documentation](https://d ## Entities -This integration creates the following entities: - -| Entity type | Entity ID | Description | -| :---------- | :------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ | -| weather | `weather.` | Main weather entity for the given location. Daily, hourly and twice-daily forecasts are available | -| sensor | `sensor..weather` | [Weather condition](https://developers.home-assistant.io/docs/core/entity/weather/#recommended-values-for-state-and-condition). | -| sensor | `sensor..temperature` | Temperature, ºC. | -| sensor | `sensor..feels_like_temperature` | Temperature accounting for the human perception of weather, ºC. | -| sensor | `sensor..humidity` | Relative humidity, %. | -| sensor | `sensor..wind_speed` | Wind speed, m/s. | -| sensor | `sensor..wind_gust` | Wind gust speed, m/s. | -| sensor | `sensor..wind_direction` | Wind direction, degrees. | -| sensor | `sensor..visibility` | Visibility distance in meters. | -| sensor | `sensor..uv ` | UV index. | -| sensor | `sensor..precipitation` | Probability of precipitation, %. | -| sensor | `sensor..name ` | Name of the weather station. | - -Only the main weather entity, probability of precipitation, temperature, weather and wind speed sensors are enabled by default. +### Weather + +| Entity ID | Description | +| :--------------------------- | :------------------------------------------------------------------------------------------------ | +| `weather.` | Main weather entity for the given location. Daily, hourly and twice-daily forecasts are available | + +### Sensor + +Separate sensors are created for each of the following conditions: + +| Condition | Description | +| :----------------------- | :------------------------------------------------------------------------------------------------------------------------------ | +| `weather` | [Weather condition](https://developers.home-assistant.io/docs/core/entity/weather/#recommended-values-for-state-and-condition). | +| `temperature` | Temperature, ºC. | +| `feels_like_temperature` | Temperature accounting for the human perception of weather, ºC. | +| `humidity` | Relative humidity, %. | +| `wind_speed` | Wind speed, m/s. | +| `wind_gust` | Wind gust speed, m/s. | +| `wind_direction` | Wind direction, degrees. | +| `visibility` | Visibility distance in meters. | +| `uv ` | UV index. | +| `precipitation` | Probability of precipitation, %. | +| `name ` | Name of the weather station. | + +Entity IDs follow the following format: +`sensor._` + +Only the probability of precipitation, temperature, weather and wind speed sensors are enabled by default. ## Removing the integration From c7d5e4a88a6a1a5b4c2ef973a7225432baca4b66 Mon Sep 17 00:00:00 2001 From: Andrey Mityagin <6134677+avee87@users.noreply.github.com> Date: Tue, 17 Jun 2025 12:57:19 +0100 Subject: [PATCH 3/4] formatting --- source/_integrations/metoffice.markdown | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/source/_integrations/metoffice.markdown b/source/_integrations/metoffice.markdown index e3231ea87293..6db52c354d89 100644 --- a/source/_integrations/metoffice.markdown +++ b/source/_integrations/metoffice.markdown @@ -55,11 +55,12 @@ Separate sensors are created for each of the following conditions: | `wind_gust` | Wind gust speed, m/s. | | `wind_direction` | Wind direction, degrees. | | `visibility` | Visibility distance in meters. | -| `uv ` | UV index. | +| `uv` | UV index. | | `precipitation` | Probability of precipitation, %. | -| `name ` | Name of the weather station. | +| `name` | Name of the weather station. | Entity IDs follow the following format: + `sensor._` Only the probability of precipitation, temperature, weather and wind speed sensors are enabled by default. From 3657f99bd852a095eff264b59ec5c351759634b6 Mon Sep 17 00:00:00 2001 From: Andrey Mityagin <6134677+avee87@users.noreply.github.com> Date: Tue, 17 Jun 2025 13:14:48 +0100 Subject: [PATCH 4/4] improvements --- source/_integrations/metoffice.markdown | 48 ++++++++++++------------- 1 file changed, 23 insertions(+), 25 deletions(-) diff --git a/source/_integrations/metoffice.markdown b/source/_integrations/metoffice.markdown index 6db52c354d89..ae4537eaa1e2 100644 --- a/source/_integrations/metoffice.markdown +++ b/source/_integrations/metoffice.markdown @@ -27,7 +27,7 @@ Details about the API are available in the [DataHub API documentation](https://d {% include integrations/config_flow.md %} -| Parameter | Value | +| Option | Description | | :-------- | :--------------------------------------------------------- | | API Key | API Key for MetOffice DataHub | | Latitude | Latitude of the location, defaults to your home latitude | @@ -37,33 +37,31 @@ Details about the API are available in the [DataHub API documentation](https://d ### Weather -| Entity ID | Description | -| :--------------------------- | :------------------------------------------------------------------------------------------------ | -| `weather.` | Main weather entity for the given location. Daily, hourly and twice-daily forecasts are available | +| Entity ID | Description | +| :------------------------ | :------------------------------------------------------------------------------------------------ | +| `weather.` | Main weather entity for the given location. Daily, hourly and twice-daily forecasts are available | ### Sensor -Separate sensors are created for each of the following conditions: - -| Condition | Description | -| :----------------------- | :------------------------------------------------------------------------------------------------------------------------------ | -| `weather` | [Weather condition](https://developers.home-assistant.io/docs/core/entity/weather/#recommended-values-for-state-and-condition). | -| `temperature` | Temperature, ºC. | -| `feels_like_temperature` | Temperature accounting for the human perception of weather, ºC. | -| `humidity` | Relative humidity, %. | -| `wind_speed` | Wind speed, m/s. | -| `wind_gust` | Wind gust speed, m/s. | -| `wind_direction` | Wind direction, degrees. | -| `visibility` | Visibility distance in meters. | -| `uv` | UV index. | -| `precipitation` | Probability of precipitation, %. | -| `name` | Name of the weather station. | - -Entity IDs follow the following format: - -`sensor._` - -Only the probability of precipitation, temperature, weather and wind speed sensors are enabled by default. +Separate sensors are created for each of the following weather conditions: + +| Condition | Description | Enabled by default | +| :----------------------- | :------------------------------------------------------------------------------------------------------------------------------ | ------------------ | +| `weather` | [Weather condition](https://developers.home-assistant.io/docs/core/entity/weather/#recommended-values-for-state-and-condition). | Yes | +| `temperature` | Temperature, ºC. | Yes | +| `feels_like_temperature` | Temperature accounting for the human perception of weather, ºC. | No | +| `humidity` | Relative humidity, %. | No | +| `wind_speed` | Wind speed, m/s. | Yes | +| `wind_gust` | Wind gust speed, m/s. | No | +| `wind_direction` | Wind direction, degrees. | No | +| `visibility` | Visibility distance in meters. | No | +| `uv` | UV index. | No | +| `precipitation` | Probability of precipitation, %. | Yes | +| `name` | Name of the weather station. | No | + +Entity IDs follow the format: + +`sensor._` ## Removing the integration