diff --git a/source/_integrations/metoffice.markdown b/source/_integrations/metoffice.markdown index 8a24816d562..c6c497cf4fa 100644 --- a/source/_integrations/metoffice.markdown +++ b/source/_integrations/metoffice.markdown @@ -5,6 +5,8 @@ ha_category: - Weather ha_release: 0.42 ha_iot_class: Cloud Polling +ha_codeowners: + - '@MrHarcombe' ha_domain: metoffice --- @@ -12,38 +14,24 @@ The `metoffice` weather platform uses the Met Office's [DataPoint API](https://w ## Configuration -To add the Met Office weather platform to your installation, you'll need to register for a free API key at the link above and then add the following to your `configuration.yaml` file: +To add the Met Office weather platform to your installation, you'll need to register for a free API key at the link above and then go to **Configuration** >> **Integrations** in the UI, click the button with `+` sign and from the list of integrations select **Met Office**. Multiple entries can be configured, but a unique set of latitude and longitude must be supplied for each. -```yaml -# Example configuration.yaml entry -weather: - - platform: metoffice - api_key: YOUR_API_KEY -``` +A number of weather entities are created for each entry created in the configuration by location: one weather entity with a summary of the 3-hourly forecasts and twelve sensor entities for individual reporting on each of the individual measurements. The time supplied for each forecast is the start time for the forecast. -{% configuration %} -api_key: - description: "Your personal API key from the [Datapoint website](https://www.metoffice.gov.uk/datapoint)." - required: true - type: string -name: - description: Additional name for the weather integration in Home Assistant. - required: false - type: string - default: Met Office -latitude: - description: "Latitude coordinate to monitor weather of (required if **longitude** is specified), defaults to coordinates defined in your `configuration.yaml`." - required: inclusive - type: float -longitude: - description: "Longitude coordinate to monitor weather of (required if **latitude** is specified), defaults to coordinates defined in your `configuration.yaml`." - required: inclusive - type: float -{% endconfiguration %} +|Entity|Description|Enabled by default| +|------|-----------|------------------| +|weather.met_office_**site name**|Weather entity with state of the current weather condition and attributes of temperature, humidity, wind speed and visibility.|Yes.| +|sensor.**site name**_feels_like_temperature|Sensor entity giving the current forecast 'feels like' temperature.|No.| +|sensor.**site name**_humidity|Sensor entity giving the current forecast humidity.|No.| +|sensor.**site name**_probability_of_precipitation|Sensor entity giving the current forecast chance of rain.|Yes.| +|sensor.**site name**_station_name|Sensor entity giving the current forecast time interval since midnight UTC.|No.| +|sensor.**site name**_temperature|Sensor entity giving the current forecast temperature.|Yes.| +|sensor.**site name**_uv_index|Sensor entity giving the current forecast UV index.|No.| +|sensor.**site name**_visibility|Sensor entity giving the current forecast visibility classification.|No.| +|sensor.**site name**_visibility_distance|Sensor entity giving the current forecast visibility distance (as a range).|No.| +|sensor.**site name**_weather|Sensor entity giving the current forecast weather conditions.|Yes.| +|sensor.**site name**_wind_direction|Sensor entity giving the current forecast wind direction.|No.| +|sensor.**site name**_wind_gust|Sensor entity giving the current forecast maximum wind gust.|No.| +|sensor.**site name**_speed|Sensor entity giving the current forecast wind speed.|Yes.| -