Updated MetOffice integration documentation (#18305)

This commit is contained in:
avee87 2021-06-27 20:07:36 +01:00 committed by GitHub
parent 317130e1fd
commit 2578105c1b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -18,25 +18,25 @@ The `metoffice` weather platform uses the Met Office's [DataPoint API](https://w
{% include integrations/config_flow.md %} {% include integrations/config_flow.md %}
## Entities ## Entities
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. 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, and twelve sensor entities for individual reporting on each of the individual measurements, for both 3-hourly and daily updates (to a grand total of 26 entities available). Note that only one of the two summary entities and the 3-hourly sensor entities flagged below are enabled by default, so your system isn't overrun on initial configuration. The time supplied for each forecast is the start time for the forecast.
|Entity|Description|Enabled by default| The available sensor entities:
|------|-----------|------------------|
|weather.met_office_**site name**|Weather entity with state of the current weather condition and attributes of temperature, humidity, wind speed and visibility.|Yes.| - "feels like" temperature
|sensor.**site name**_feels_like_temperature|Sensor entity giving the current forecast 'feels like' temperature.|No.| - humidity
|sensor.**site name**_humidity|Sensor entity giving the current forecast humidity.|No.| - probability of precipitation
|sensor.**site name**_probability_of_precipitation|Sensor entity giving the current forecast chance of rain.|Yes.| - station name
|sensor.**site name**_station_name|Sensor entity giving the current forecast time interval since midnight UTC.|No.| - temperature
|sensor.**site name**_temperature|Sensor entity giving the current forecast temperature.|Yes.| - UV index
|sensor.**site name**_uv_index|Sensor entity giving the current forecast UV index.|No.| - visibility
|sensor.**site name**_visibility|Sensor entity giving the current forecast visibility classification.|No.| - visibility distance
|sensor.**site name**_visibility_distance|Sensor entity giving the current forecast visibility distance (as a range).|No.| - weather
|sensor.**site name**_weather|Sensor entity giving the current forecast weather conditions.|Yes.| - wind direction
|sensor.**site name**_wind_direction|Sensor entity giving the current forecast wind direction.|No.| - wind gust
|sensor.**site name**_wind_gust|Sensor entity giving the current forecast maximum wind gust.|No.| - wind speed
|sensor.**site name**_speed|Sensor entity giving the current forecast wind speed.|Yes.|
Only probability of precipitation, temperature, weather and wind speed are enabled by default.
Details about the API are available in the [DataPoint API documentation](https://www.metoffice.gov.uk/services/data/datapoint/api-reference). The [DataPoint](https://github.com/EJEP/datapoint-python) library is used to retrieve data. Details about the API are available in the [DataPoint API documentation](https://www.metoffice.gov.uk/services/data/datapoint/api-reference). The [DataPoint](https://github.com/EJEP/datapoint-python) library is used to retrieve data.