Updated documentation for OpenWeatherMap alongside PR 39839 (#14434)

This commit is contained in:
Niccolo Zapponi 2020-11-08 12:50:28 +00:00 committed by GitHub
parent 38db0306f2
commit 1576d40d70
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -27,15 +27,16 @@ You need an API key, which is free, but requires a [registration](https://home.o
To add OpenWeatherMap integration go to **Configuration** >> **Integrations** and find the integration in the list.
| Parameter | Value |
| :------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- |
| :------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| API Key | API Key from the website |
| Name | Name of the integration |
| Latitude | Latitude for weather forecast and sensor |
| Longitude | Longitude for weather forecast and sensor |
| Mode | Forecast mode, `hourly` for a three-hour forecast, `daily` for daily forecast, or `freedaily` for a five-day forecast with the free tier. |
| Mode | Forecast mode, `hourly` for a three-hour forecast, `daily` for daily forecast using a paid API tier, `onecall_hourly` for an hourly forecast up to 2 days, or `onecall_daily` for a daily forecast up to 7 days (ideal for the free tier). |
| Language | Language for receiving data (only for `sensor`) |
The integration creates weather entity and also sensors for all available conditions.
Selecting a `onecall` mode with the free tier leverages the One Call API, resulting in updates every 5 minutes and is recommended for both hourly and daily forecast.
For each condition `sensor` entity will be created with id:
@ -46,7 +47,7 @@ Sensor prints information in language which was selected for integration.
All conditions:
| Condition | Description |
| :----------- | :------------------------------------- |
| :------------- | :----------------------------------- |
| `weather` | A human-readable text summary. |
| `temperature` | Current temperature. |
| `wind_speed` | Wind speed. |