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-23 17:27:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

Component configuration for NWS (#11951)

Browse Source
This commit is contained in:
MatthewFlamm 2020-04-13 02:46:08 -04:00 committed by GitHub
parent f359f83cb9
commit 92a6e1ea10
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 19 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
source/_integrations/nws.markdown
View File

@ -19,24 +19,35 @@ To add NWS to your installation using the closest station, add the following to
```yaml ```yaml
# Example configuration.yaml entry # Example configuration.yaml entry
weather: nws:
- platform: nws api_key: YOUR_API_KEY
api_key: YOUR_API_KEY
``` ```
To specify a station, for example, KADW (Andrews Air Force Base), use the following: To specify a station, for example, KADW (Andrews Air Force Base), use the following:
```yaml ```yaml
# Example configuration.yaml entry # Example configuration.yaml entry
weather: nws:
- platform: nws api_key: YOUR_API_KEY
api_key: YOUR_API_KEY station: KADW
station: KADW
``` ```
A list of nearby stations is printed to the log with level `DEBUG` if no station is supplied. Stations can also be found on the [NOAA website](https://www.cnrfc.noaa.gov/metar.php). Codes with only three characters, for example, `ADW` should be prefixed with the letter K, `KADW`. A list of nearby stations is printed to the log with level `DEBUG` if no station is supplied. Stations can also be found on the [NOAA website](https://www.cnrfc.noaa.gov/metar.php). Codes with only three characters, for example, `ADW` should be prefixed with the letter K, `KADW`.
The default forecast is day and night, `mode: daynight`, while `mode: hourly` gives the forecast hourly. The forecast is obtained from the latitude and longitude value, not the station. Multiple entries can be configured, but a unique set of latitude and longitude must be supplied for each:
```yaml
# Example configuration.yaml entry
nws:
- api_key: YOUR_API_KEY
latitude: 38.5
longitude: -76.5
- api_key: YOUR_API_KEY
latitude: 39
longitude: -76.5
```
Two weather entities are created for each entry in the configuration: one for hourly forecasts and one for day and night forecasts. The time supplied for each forecast is the start time for the forecast.
{% configuration %} {% configuration %}
api_key: api_key:
@ -53,16 +64,6 @@ longitude:
required: false required: false
type: float type: float
default: "Provided by Home Assistant configuration." default: "Provided by Home Assistant configuration."
name:
description: "Name to use in the frontend."
required: false
type: string
default: "Station name."
mode:
description: "The forecast type. Can be `daynight` or `hourly`."
required: false
type: string
default: daynight
station: station:
description: "METAR station code." description: "METAR station code."
required: false required: false