La integración OpenUV con Home Assistant ofrece una herramienta valiosa para el seguimiento de datos de UV y ozono provenientes de openuv.io. Aunque los datos proporcionados constituyen estimaciones que pretenden apoyar la toma de decisiones informada, no deben sustituir el análisis, el asesoramiento o el diagnóstico de un profesional médico entrenado.
Generando una clave API
Para generar una clave API, tenemos que iniciar sesión en el sitio web de OpenUV.
Configuración
La adición de OpenUV a tu instancia de Home Assistant puede realizarse a través de la interfaz de usuario, haciendo clic en el botón «Mi».
Si el botón «Mi» no funciona, también puedes realizar los siguientes pasos manualmente:
- Navega a tu instancia de Home Assistant.
- Ve a Configuración > Dispositivos y Servicios.
- En la esquina inferior derecha, selecciona el botón «Agregar Integración».
- De la lista, selecciona OpenUV.
- Sigue las instrucciones en pantalla para completar la configuración.
Sensores
Los sensores proporcionados por OpenUV son variados, cada uno con un tipo y valor específico. Abarcan desde el nivel actual de ozono, el índice de UV, hasta el tiempo de exposición segura al sol según el tipo de piel de Fitzpatrick.
| Nombre | Tipo | Valor |
|---|---|---|
| Nivel de ozono actual | Sensor | nivel de ozono en du (Unidades Dobson) |
| Índice UV actual | Sensor | Índice UV (valor numérico) |
| Nivel UV actual | Sensor | Nivel UV (como literal) |
| Índice UV máx. | Sensor | Índice UV máx. para el día (al mediodía solar) |
| Ventana de protección | sensor binario | si se debe usar protección solar |
| Tipo de piel 1 Tiempo de exposición seguro | Sensor | la cantidad de tiempo que la piel Fitzpatrick tipo 1 puede estar al sol sin protección |
| Tipo de piel 2 Tiempo de exposición seguro | Sensor | la cantidad de tiempo que la piel tipo 2 de Fitzpatrick puede estar expuesta al sol sin protección |
| Tipo de piel 3 Tiempo de exposición seguro | Sensor | la cantidad de tiempo que la piel Fitzpatrick tipo 3 puede estar al sol sin protección |
| Tipo de piel 4 Tiempo de exposición seguro | Sensor | la cantidad de tiempo que la piel tipo 4 de Fitzpatrick puede estar expuesta al sol sin protección |
| Tipo de piel 5 Tiempo de exposición seguro | Sensor | la cantidad de tiempo que la piel tipo 5 de Fitzpatrick puede estar expuesta al sol sin protección |
| Tipo de piel 6 Tiempo de exposición seguro | Sensor | la cantidad de tiempo que la piel Fitzpatrick tipo 6 puede estar al sol sin protección |
Actualización de Datos
Es importante mencionar que OpenUV no actualiza automáticamente los datos para sus entidades. Los usuarios deben actualizar los datos manualmente a través del servicio homeassistant.update_entity.
A partir del 1 de febrero de 2019, el plan «Limitado» (el predeterminado para los nuevos usuarios) tiene un límite de 50 solicitudes de API por día. Como los diferentes planes de API y ubicaciones tendrán diferentes requisitos, la integración OpenUV no consulta automáticamente la API para obtener nuevos datos después de que se carga inicialmente.
Ventana de Protección
El sensor binario «Ventana de Protección» estará activado cuando se deba usar protección contra el sol. Por defecto, esto ocurre en cualquier momento en que el índice UV esté por encima de 3.5.
Starting UV index for the protection window: el índice UV que, cuando se pasa, indica que se debe utilizar la protecciónEnding UV index for the protection window: el índice UV que, cuando se pasa, indica que ya no se requiere protección
Ejemplos de Actualización de Datos
Para mantener actualizada la información, es posible configurar actualizaciones automáticas de datos. Un ejemplo sería actualizar los datos del índice UV cada 20 minutos mientras el sol esté al menos 10 grados por encima del horizonte.
Otro ejemplo sería actualizar la ventana de protección una vez al día a las 12:00 p.m. Esto se hace utilizando una automatización en la plataforma.
Actualice los datos del índice UV cada 20 minutos mientras el sol esté al menos 10 grados sobre el horizonte:
automation:
- alias: "Update OpenUV"
trigger:
platform: time_pattern
minutes: "/20"
condition:
condition: numeric_state
entity_id: sun.sun
value_template: "{{ state.attributes.elevation }}"
above: 10
action:
service: homeassistant.update_entity
target:
entity_id: sensor.openweathermap_uv_indexActualice la ventana de protección una vez al día a las 12:00 p. m.:
automation:
- alias: "Update OpenUV"
trigger:
platform: time
at: "12:00:00"
action:
service: homeassistant.update_entity
target:
entity_id: sensor.openweathermap_uv_indexPara realizar una cantidad óptima de llamadas a la API en lugares donde la cantidad de luz diurna varía, debe conocer el total de horas de luz diurna del día más largo del año. Si, por ejemplo, son 17 horas, puede realizar 2 llamadas cada 45 minutos sin llegar al límite de 50 llamadas API por día:
automation:
- alias: "Actualizar OpenUV"
trigger:
- platform: time_pattern
minutes: "/15"
condition:
- condition: sun
after: sunrise
before: sunset
before_offset: "+00:45:00"
- condition: template
value_template: >-
{{
state_attr('automation.update_openuv', 'last_triggered') == None
or (
now() - state_attr('automation.update_openuv', 'last_triggered')
) >= timedelta(hours = 0, minutes = 40)
}}
action:
service: homeassistant.update_entity
target:
entity_id:
- sensor.openweathermap_uv_index
Claves API Expiradas y Re-autenticación
En OpenUV, una respuesta HTTP 403 indica una de dos condiciones: una clave API no válida o una clave API cuyo límite diario/mensual se ha alcanzado.
Desafortunadamente, la integración no puede determinar cuál de las dos condiciones se ha dado a partir de los datos de la API proporcionados por OpenUV. Por lo tanto, se sigue la siguiente estrategia:
Cualquier respuesta HTTP 403 creará una notificación persistente pidiéndote que vuelvas a autenticar la integración OpenUV.
Sígueme a YouTube
