From 1bc7cb560a931370e71d392d7a3003201d433584 Mon Sep 17 00:00:00 2001 From: G Johansson Date: Thu, 23 Jun 2022 23:44:23 +0200 Subject: [PATCH] Update weather of native values (#1370) --- docs/core/entity/weather.md | 28 +++++++++++++++++----------- 1 file changed, 17 insertions(+), 11 deletions(-) diff --git a/docs/core/entity/weather.md b/docs/core/entity/weather.md index e57757eb..e4db8aa4 100644 --- a/docs/core/entity/weather.md +++ b/docs/core/entity/weather.md @@ -14,17 +14,21 @@ Properties should always only return information from memory and not do I/O (lik | Name | Type | Default | Description | ---- | ---- | ------- | ----------- | condition | string | **Required** | The current weather condition. -| temperature | float | **Required** | The current temperature in °C or °F. -| temperature_unit | string | **Required** | The temperature unit, °C or °F. -| pressure | float | `None` | The current air pressure in hPa or inHg. +| native_temperature | float | **Required** | The current temperature in °C or °F. +| native_temperature_unit | string | **Required** | The temperature unit; °C or °F. +| native_pressure | float | `None` | The current air pressure in hPa, mbar, inHg or mmHg. +| native_pressure_unit | string | `None` | The air pressure unit; hPa, mbar, inHg or mmHg. Required if native_pressure is set. | humidity | float | `None` | The current humidity in %. | ozone | float | `None` | The current ozone level. -| visibility | float | `None` | The current visibility in km or mi. -| wind_speed | float | `None` | The current wind speed in km/h or mi/h. +| native_visibility | float | `None` | The current visibility in km or mi. +| native_visibility_unit | string | `None` | The visibility unit; km or mi. Required if native_visibility is set. +| native_wind_speed | float | `None` | The current wind speed in m/s, km/h or mi/h. +| native_wind_speed_unit | string | `None` | The wind speed unit; m/s, km/h or mi/h. Required if native_wind_speed is set. +| native_precipitation_unit | string | `None` | The precipitation unit; mm or in. | wind_bearing | float or string | `None` | The current wind bearing in azimuth angle (degrees) or 1-3 letter cardinal direction. | forecast | array | `None` | Daily or Hourly forecast data. -Properties have to follow the units defined in the `unit_system`. +Properties have to follow the units mentioned on the respective unit of measurement in the table. ### Forecast @@ -33,14 +37,16 @@ Forecast data should either be daily or hourly. | Name | Type | Default | Description | ---- | ---- | ------- | ----------- | datetime | string | **Required** | UTC Date time in RFC 3339 format. -| temperature | float | **Required** | The higher temperature in °C or °F +| native_temperature | float | **Required** | The higher temperature in °C or °F | condition | string | `None` | The weather condition at this point. -| templow | float | `None` | The lower daily Temperature in °C or °F -| precipitation | float | `None` | The precipitation amount in mm or inch. +| native_templow | float | `None` | The lower daily Temperature in °C or °F +| native_precipitation | float | `None` | The precipitation amount in mm or in. | precipitation_probability | int | `None` | The probability of precipitation in %. -| pressure | float | `None` | The air pressure in hPa or inHg. +| native_pressure | float | `None` | The air pressure in hPa, mbar, inHg or mmHg. | wind_bearing | float or string | `None` | The wind bearing in azimuth angle (degrees) or 1-3 letter cardinal direction. -| wind_speed | int | `None` | The wind speed in km/h or mi/h. +| native_wind_speed | int | `None` | The wind speed in m/s, km/h or mi/h. + +Forecast data needs to follow the same unit of measurement as defined for properties where applicable. ### Recommended values for state and condition