Aaron Bach be86e84c4e Add window update docs to WWLLN (#9932)
* Add window update docs to WWLLN

* ✏️ Tweak
2019-07-21 09:40:52 +02:00

2.6 KiB

title, description, logo, ha_category, ha_release, ha_iot_class, ha_config_flow
title description logo ha_category ha_release ha_iot_class ha_config_flow
World Wide Lightning Location Network (WWLLN) Instructions on how to integrate WWLLN within Home Assistant. wwlln.jpg Geolocation 0.96 Cloud Polling true

The wwlln integration displays lightning strike information from the World Wide Lightning Location Network (WWLLN).

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.

New data is fetched every 10 minutes. Because data from the WWLLN may vary in terms of how real-time it is, the default window parameter is set to 1 hour to ensure that as many strikes are caught as possible.

Configuration

To retrieve data from the WWLLN, add the following to your configuration.yaml file:

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: integer window: description: The amount of time before now for which strikes should be considered "active" and shown in the UI. Note that a window of less than 1 hour may cause Home Assistant to miss events. 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

# Example configuration.yaml entry
wwlln:
    radius: 100
    latitude: 37.39
    longitude: -5.99