jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-19 15:26:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

Updated documentation for OpenWeatherMap alongside PR 39839 (#14434)

Browse Source
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
1 changed files with 11 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
source/_integrations/openweathermap.markdown
View File

@ -26,16 +26,17 @@ 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. To add OpenWeatherMap integration go to **Configuration** >> **Integrations** and find the integration in the list.
| Parameter | Value | | Parameter | Value |
| :------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- | | :------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| API Key | API Key from the website | | API Key | API Key from the website |
| Name | Name of the integration | | Name | Name of the integration |
| Latitude | Latitude for weather forecast and sensor | | Latitude | Latitude for weather forecast and sensor |
| Longitude | Longitude 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`) | | Language | Language for receiving data (only for `sensor`) |
The integration creates weather entity and also sensors for all available conditions. 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: For each condition `sensor` entity will be created with id:
@ -45,8 +46,8 @@ Sensor prints information in language which was selected for integration.
All conditions: All conditions:
| Condition | Description | | Condition | Description |
| :----------- | :------------------------------------- | | :------------- | :----------------------------------- |
| `weather` | A human-readable text summary. | | `weather` | A human-readable text summary. |
| `temperature` | Current temperature. | | `temperature` | Current temperature. |
| `wind_speed` | Wind speed. | | `wind_speed` | Wind speed. |