mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-21 16:27:19 +00:00
GeoNet NZ Volcanic Alert Level feed integration (#10464)
* initial version * added screenshots * config flow available * moved screenshots * fixed version number * small changes * ✏️ Tweak * ⬆️ Change release version * moved files Co-authored-by: Klaas Schoute <klaas_schoute@hotmail.com>
This commit is contained in:
parent
a646c14ef4
commit
b8d15f6853
96
source/_integrations/geonetnz_volcano.markdown
Normal file
96
source/_integrations/geonetnz_volcano.markdown
Normal file
@ -0,0 +1,96 @@
|
||||
---
|
||||
title: "GeoNet NZ Volcanic Alert Level"
|
||||
description: "Instructions on how to integrate the GeoNet New Zealand Volcanic Alert Level feed into Home Assistant."
|
||||
logo: geonet-nz.png
|
||||
ha_category:
|
||||
- Sensor
|
||||
ha_iot_class: Cloud Polling
|
||||
ha_release: 0.103
|
||||
ha_config_flow: true
|
||||
---
|
||||
|
||||
The `geonetnz_volcano` integration lets you use a GeoJSON feed provided by
|
||||
New Zealand's [GeoNet](https://www.geonet.org.nz/) with information
|
||||
about volcanoes in the New Zealand region.
|
||||
It shows information of those volcanoes filtered by distance to Home Assistant's
|
||||
location.
|
||||
|
||||
Entities are generated and updated automatically with each update
|
||||
from the feed. Each entity defines the [volcanic alert level](https://www.geonet.org.nz/about/volcano/val)
|
||||
as its state. Latitude and longitude of the volcano are included as attributes
|
||||
to show on the default map automatically.
|
||||
|
||||
The data is updated every 5 minutes.
|
||||
|
||||
<p class='img'>
|
||||
<img src='{{site_root}}/images/integrations/geonetnz_volcano/map.png' />
|
||||
</p>
|
||||
|
||||
<p class='img'>
|
||||
<img src='{{site_root}}/images/integrations/geonetnz_volcano/sensor.png' />
|
||||
</p>
|
||||
|
||||
<div class='note'>
|
||||
|
||||
The material used by this integration is provided under the [Creative Commons Attribution 3.0 New Zealand (CC BY 3.0 NZ) license](http://creativecommons.org/licenses/by/3.0/nz/).
|
||||
It has only been modified for the purpose of presenting the material in Home Assistant.
|
||||
Please refer to the [creator's disclaimer notice](https://www.geonet.org.nz/disclaimer) and [data policy](https://www.geonet.org.nz/policy) for more information.
|
||||
|
||||
We acknowledge the New Zealand GeoNet project and its sponsors EQC, GNS Science and LINZ, for providing data/images used in this integration.
|
||||
|
||||
</div>
|
||||
|
||||
## Configuration
|
||||
|
||||
To integrate the GeoNet New Zealand Volcanic Alert Level feed use the **Integrations** feature
|
||||
in the GUI, you find it under **Configurations** -> **Integrations**, or add the
|
||||
following line to your `configuration.yaml`.
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
geonetnz_volcano:
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
radius:
|
||||
description: The radius around your location to monitor; defaults to 50 km or mi (depending on the unit system defined in your configuration).
|
||||
required: false
|
||||
type: float
|
||||
default: 50.0
|
||||
latitude:
|
||||
description: Latitude of the coordinates around which volcanoes are considered.
|
||||
required: false
|
||||
type: float
|
||||
default: Latitude defined in your configuration.
|
||||
longitude:
|
||||
description: Longitude of the coordinates around which volcanoes are considered.
|
||||
required: false
|
||||
type: float
|
||||
default: Longitude defined in your configuration.
|
||||
{% endconfiguration %}
|
||||
|
||||
## State Attributes
|
||||
|
||||
The following state attributes are available for each entity in addition to
|
||||
the standard ones:
|
||||
|
||||
| Attribute | Description |
|
||||
|------------------------|-------------|
|
||||
| latitude | Latitude of the volcano. |
|
||||
| longitude | Longitude of the volcano. |
|
||||
| external_id | The external ID used in the feed to identify the volcano. |
|
||||
| activity | Volcanic activity. |
|
||||
| hazards | Most likely hazards. |
|
||||
| distance | The distance in km or mi to Home Assistant's location. |
|
||||
| last update | Timestamp of the last update from the feed. |
|
||||
| last update successful | Timestamp of the last successful update from the feed. |
|
||||
|
||||
## Full Configuration
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
geonetnz_quakes:
|
||||
radius: 100
|
||||
latitude: -41.2
|
||||
longitude: 174.7
|
||||
```
|
BIN
source/images/integrations/geonetnz_volcano/map.png
Normal file
BIN
source/images/integrations/geonetnz_volcano/map.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 282 KiB |
BIN
source/images/integrations/geonetnz_volcano/sensor.png
Normal file
BIN
source/images/integrations/geonetnz_volcano/sensor.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 112 KiB |
Loading…
x
Reference in New Issue
Block a user