Integración de OpenUV con Home Assistant

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.

Índice de contenido

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ón
Ending 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_index

Actualice 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_index

Para 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.