mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-22 16:56:50 +00:00
Add WWLLN docs (#9802)
* Add WWLLN docs
* Updated docs
* Added more docs and a screenshot
* Added window parameter
* ✏️ Tweak
This commit is contained in:
parent
8b2ced20bd
commit
305a259d76
82
source/_components/wwlln.markdown
Normal file
82
source/_components/wwlln.markdown
Normal file
@ -0,0 +1,82 @@
|
|||||||
|
---
|
||||||
|
layout: page
|
||||||
|
title: "World Wide Lightning Location Network (WWLLN)"
|
||||||
|
description: "Instructions on how to integrate WWLLN within Home Assistant."
|
||||||
|
date: 2019-07-06 23:17
|
||||||
|
sidebar: true
|
||||||
|
comments: false
|
||||||
|
sharing: true
|
||||||
|
footer: true
|
||||||
|
logo: wwlln.jpg
|
||||||
|
ha_category: Geolocation
|
||||||
|
ha_release: 0.96
|
||||||
|
ha_iot_class: Cloud Polling
|
||||||
|
ha_config_flow: true
|
||||||
|
---
|
||||||
|
|
||||||
|
The `wwlln` integration displays lightning strike information from the
|
||||||
|
[World Wide Lightning Location Network (WWLLN)](http://wwlln.net).
|
||||||
|
|
||||||
|
Entities are generated, updated and removed automatically with each update
|
||||||
|
from the feed. Each entity defines latitude and longitude and will be shown
|
||||||
|
on the default map automatically, or on a map card by defining the source
|
||||||
|
`wwlln`. The distance (in kilometers or miles, depending on your unit system)
|
||||||
|
is available as the state of each entity.
|
||||||
|
|
||||||
|
<p class='img'>
|
||||||
|
<img src='{{site_root}}/images/screenshots/wwlln-feed-map.png' />
|
||||||
|
</p>
|
||||||
|
|
||||||
|
New data is returned every 5 minutes.
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
To retrieve data from the WWLLN, add the following to your `configuration.yaml`
|
||||||
|
file:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
wwlln:
|
||||||
|
```
|
||||||
|
|
||||||
|
{% configuration %}
|
||||||
|
latitude:
|
||||||
|
description: The latitude you want to monitor; defaults to the value defined in `configuration.yaml`.
|
||||||
|
required: false
|
||||||
|
type: float
|
||||||
|
longitude:
|
||||||
|
description: The longitude you want to monitor; defaults to the value defined in `configuration.yaml`.
|
||||||
|
required: false
|
||||||
|
type: float
|
||||||
|
radius:
|
||||||
|
description: The radius around your location to monitor; defaults to 25 km or mi (depending on the unit system defined in your `configuration.yaml`).
|
||||||
|
required: false
|
||||||
|
type: int
|
||||||
|
window:
|
||||||
|
description: The amount of time before now for which strikes should be considered "active" and shown in the UI.
|
||||||
|
required: false
|
||||||
|
type: time
|
||||||
|
{% endconfiguration %}
|
||||||
|
|
||||||
|
## State Attributes
|
||||||
|
|
||||||
|
The following state attributes are available for each entity in addition to
|
||||||
|
the standard ones:
|
||||||
|
|
||||||
|
| Attribute | Description |
|
||||||
|
|--------------------|-------------|
|
||||||
|
| latitude | Latitude of the lightning strike. |
|
||||||
|
| longitude | Longitude of the lightning strike. |
|
||||||
|
| source | `wwlln` to be used in conjunction with the `geo_location` automation trigger. |
|
||||||
|
| external_id | The external ID used in the feed to identify the earthquake in the feed. |
|
||||||
|
| publication_date | Date and time when this event occurred. |
|
||||||
|
|
||||||
|
|
||||||
|
## Full Configuration
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# Example configuration.yaml entry
|
||||||
|
wwlln:
|
||||||
|
radius: 100
|
||||||
|
latitude: 37.39
|
||||||
|
longitude: -5.99
|
||||||
|
```
|
BIN
source/images/screenshots/wwlln-feed-map.png
Normal file
BIN
source/images/screenshots/wwlln-feed-map.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 105 KiB |
BIN
source/images/supported_brands/wwlln.jpg
Normal file
BIN
source/images/supported_brands/wwlln.jpg
Normal file
Binary file not shown.
After Width: | Height: | Size: 82 KiB |
Loading…
x
Reference in New Issue
Block a user