home-assistant.io/source/_integrations/meteoalarm.markdown

110 lines
3.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

---
title: MeteoAlarm
description: Instructions on how to set up MeteoAlarm binary sensors within Home Assistant.
ha_category: Binary Sensor
ha_release: 0.93
ha_iot_class: Cloud Polling
ha_codeowners:
- '@rolfberkenbosch'
ha_domain: meteoalarm
ha_platforms:
- binary_sensor
---
The `MeteoAlarm` platform allows one to watch for weather alerts in europe from [MeteoAlarm](https://www.meteoalarm.org) (EUMETNET). To use this binary sensor, you need the name of your country and the province name from [MeteoAlarm](https://feeds.meteoalarm.org). Please note that you need to write the exact country name (with hyphens) as at the end of the URL starting with: `https://feeds.meteoalarm.org/feeds/meteoalarm-legacy-atom-`.
The binary sensor state shows if applicable the warning message. The details are available as attribute.
## Configuration
To enable this binary sensor, add the following lines to your `configuration.yaml`:
```yaml
binary_sensor:
- platform: meteoalarm
country: "netherlands"
province: "Groningen"
```
{% configuration %}
name:
description: Binary sensor name
required: false
default: meteoalarm
type: string
country:
description: The fullname of your country in English format (lowercases)
required: true
type: string
province:
description: The province
required: true
type: string
language:
description: "The ISO code of your language, please be aware that this is only possible in the current country. So 'nl-NL' or 'nl-BE' is only possible in Netherlands or Belgium"
required: false
type: string
default: "en-US"
{% endconfiguration %}
Example output
You will find an example below when the state is "on".
```yaml
attribution: Information provided by MeteoAlarm
language: en-GB
category: Met
event: Severe forest-fire warning
responseType: Monitor
urgency: Immediate
severity: Severe
certainty: Likely
effective: 2019-05-02T22:00:00+00:00
onset: 2019-05-02T22:00:00+00:00
expires: 2019-05-03T21:59:00+00:00
senderName: Stig Carlsson
headline: Orange forest-fire for Hedmark, Oppland
description: High grass and heather fire hazard in areas without snow until significant amount of precipitation.
Consequences: Vegetation is very easily ignited and very large areas may be affected.
instruction: Be very careful with open fire. Follow the instructions from the local authorities. Emergency services should assess a necessary level of alertness.
awareness_level: 3; orange; Severe
awareness_type: 8; forest-fire
unit_of_measurement:
friendly_name: meteoalarm
icon: mdi:alert
```
There are a few awareness levels:
* 2; yellow; Moderate
* 3; orange; Severe
* 4; red; High
Example automation
Below you find an example of an automation.
{% raw %}
```yaml
automation:
- alias: "Alert me about weather warnings"
trigger:
platform: state
entity_id: binary_sensor.meteoalarm
from: off
action:
- service: notify.notify
data:
title: "{{state_attr('binary_sensor.meteoalarm', 'headline')}}"
message: "{{state_attr('binary_sensor.meteoalarm', 'description')}} is effective on {{state_attr('binary_sensor.meteoalarm', 'effective')}}"
```
{% endraw %}
<div class='note warning'>
This integration is not affiliated with MeteoAlarm and retrieves data from the website by using the XML feeds. Use it at your own risk.
</div>