meteocat 3.1.0 → 4.0.0

package/custom_components/meteocat/const.py

@@ -1,120 +1,132 @@
-# Constantes generales
-DOMAIN = "meteocat"
-BASE_URL = "https://api.meteo.cat"
-CONF_API_KEY = "api_key"
-TOWN_NAME = "town_name"
-TOWN_ID = "town_id"
-VARIABLE_NAME = "variable_name"
-VARIABLE_ID = "variable_id"
-STATION_NAME = "station_name"
-STATION_ID = "station_id"
-STATION_TYPE = "station_type"
-LATITUDE = "latitude"
-LONGITUDE = "longitude"
-ALTITUDE = "altitude"
-REGION_ID = "region_id"
-REGION_NAME = "region_name"
-PROVINCE_ID = "province_id"
-PROVINCE_NAME = "province_name"
-LIMIT_XEMA = "limit_xema"
-LIMIT_PREDICCIO = "limit_prediccio"
-LIMIT_XDDE = "limit_xdde"
-LIMIT_BASIC = "limit_basic"
-LIMIT_QUOTA = "limit_quota"
-STATION_STATUS = "station_status"
-HOURLY_FORECAST_FILE_STATUS = "hourly_forecast_file_status"
-DAILY_FORECAST_FILE_STATUS = "daily_forecast_file_status"
-UVI_FILE_STATUS = "uvi_file_status"
-ALERTS = "alerts"
-ALERT_FILE_STATUS = "alert_file_status"
-ALERT_WIND = "alert_wind"
-ALERT_RAIN_INTENSITY = "alert_rain_intensity"
-ALERT_RAIN = "alert_rain"
-ALERT_SEA = "alert_sea"
-ALERT_COLD = "alert_cold"
-ALERT_WARM = "alert_warm"
-ALERT_WARM_NIGHT = "alert_warm_night"
-ALERT_SNOW = "alert_snow"
-QUOTA_FILE_STATUS = "quota_file_status"
-QUOTA_XDDE = "quota_xdde"
-QUOTA_PREDICCIO = "quota_prediccio"
-QUOTA_BASIC = "quota_basic"
-QUOTA_XEMA = "quota_xema"
-QUOTA_QUERIES = "quota_queries"
-LIGHTNING_FILE_STATUS = "lightning_file_status"
-SUNRISE = "sunrise"
-SUNSET = "sunset"
-SUN_FILE_STATUS = "sun_file_status"
-
-from homeassistant.const import Platform
-
-ATTRIBUTION = "Powered by Meteocatpy"
-PLATFORMS = [Platform.SENSOR, Platform.WEATHER]
-DEFAULT_NAME = "METEOCAT"
-
-# Tiempos para validación de API
-DEFAULT_VALIDITY_DAYS = 1  # Número de días a partir de los cuales se considera que el archivo de información está obsoleto
-DEFAULT_VALIDITY_HOURS = 5  # Hora a partir de la cual la API tiene la información actualizada de predicciones disponible para descarga
-DEFAULT_VALIDITY_MINUTES = 0  # Minutos a partir de los cuales la API tiene la información actualizada de predicciones disponible para descarga
-DEFAULT_ALERT_VALIDITY_TIME = 120  # Minutos a partir de los cuales las alertas están obsoletas y se se debe proceder a una nueva llamada a la API
-DEFAULT_QUOTES_VALIDITY_TIME = 240 # Minutos a partir de los cuales los datos de cuotas están obsoletos y se se debe proceder a una nueva llamada a la API
-DEFAULT_LIGHTNING_VALIDITY_TIME = 240 # Minutos a partir de los cuales los datos de rayos están obsoletos y se se debe proceder a una nueva llamada a la API
-DEFAULT_LIGHTNING_VALIDITY_HOURS = 1  # Hora a partir de la cual la API tiene la información actualizada de rayos disponible para descarga
-DEFAULT_LIGHTNING_VALIDITY_MINUTES = 0  # Minutos a partir de los cuales la API tiene la información actualizada de rayos disponible para descarga
-
-# Multiplicadores para la duración de validez basada en limit_prediccio
-ALERT_VALIDITY_MULTIPLIER_100 = 12  # para limit_prediccio <= 100
-ALERT_VALIDITY_MULTIPLIER_200 = 6   # para 100 < limit_prediccio <= 200
-ALERT_VALIDITY_MULTIPLIER_500 = 3   # para 200 < limit_prediccio <= 500
-ALERT_VALIDITY_MULTIPLIER_DEFAULT = 1  # para limit_prediccio > 500
-
-# Códigos de sensores de la API
-WIND_SPEED = "wind_speed"  # Velocidad del viento
-WIND_DIRECTION = "wind_direction"  # Dirección del viento
-WIND_DIRECTION_CARDINAL = "wind_direction_cardinal"  # Dirección del viento en cardinal
-TEMPERATURE = "temperature"  # Temperatura
-HUMIDITY = "humidity"  # Humedad relativa
-PRESSURE = "pressure"  # Presión atmosférica
-PRECIPITATION = "precipitation"  # Precipitación
-PRECIPITATION_ACCUMULATED = "precipitation_accumulated" #Precipitación acumulada
-PRECIPITATION_PROBABILITY = "precipitation_probability" #Precipitación probabilidad
-SOLAR_GLOBAL_IRRADIANCE = "solar_global_irradiance"  # Irradiación solar global
-UV_INDEX = "uv_index"  # UV
-MAX_TEMPERATURE = "max_temperature"  # Temperatura máxima
-MIN_TEMPERATURE = "min_temperature"  # Temperatura mínima
-FEELS_LIKE = "feels_like"  # Sensación térmica
-WIND_GUST = "wind_gust"  # Racha de viento
-STATION_TIMESTAMP = "station_timestamp"  # Código de tiempo de la estación
-CONDITION = "condition"  # Estado del cielo
-MAX_TEMPERATURE_FORECAST = "max_temperature_forecast"  # Temperatura máxima prevista
-MIN_TEMPERATURE_FORECAST = "min_temperature_forecast"  # Temperatura mínima prevista
-LIGHTNING_REGION = "lightning_region"  # Rayos de la comarca
-LIGHTNING_TOWN = "lightning_town"  # Rayos de la población
-
-# Definición de códigos para variables
-WIND_SPEED_CODE = 30
-WIND_DIRECTION_CODE = 31
-TEMPERATURE_CODE = 32
-HUMIDITY_CODE = 33
-PRESSURE_CODE = 34
-PRECIPITATION_CODE = 35
-SOLAR_GLOBAL_IRRADIANCE_CODE = 36
-UV_INDEX_CODE = 39
-MAX_TEMPERATURE_CODE = 40
-MIN_TEMPERATURE_CODE = 42
-WIND_GUST_CODE = 50
-
-# Mapeo de códigos 'estatCel' a condiciones de Home Assistant
-CONDITION_MAPPING = {
-    "sunny": [1],
-    # "clear-night": [1],
-    "partlycloudy": [2, 3],
-    "cloudy": [4, 20, 21, 22],
-    "rainy": [5, 6, 23],
-    "pouring": [7, 8, 25],
-    "lightning-rainy": [8, 24],
-    "hail": [9],
-    "snowy": [10, 26, 27, 28],
-    "fog": [11, 12],
-    "snow-rainy": [27, 29, 30],
-}
+# Constantes generales
+DOMAIN = "meteocat"
+BASE_URL = "https://api.meteo.cat"
+CONF_API_KEY = "api_key"
+TOWN_NAME = "town_name"
+TOWN_ID = "town_id"
+VARIABLE_NAME = "variable_name"
+VARIABLE_ID = "variable_id"
+STATION_NAME = "station_name"
+STATION_ID = "station_id"
+STATION_TYPE = "station_type"
+LATITUDE = "latitude"
+LONGITUDE = "longitude"
+ALTITUDE = "altitude"
+REGION_ID = "region_id"
+REGION_NAME = "region_name"
+PROVINCE_ID = "province_id"
+PROVINCE_NAME = "province_name"
+LIMIT_XEMA = "limit_xema"
+LIMIT_PREDICCIO = "limit_prediccio"
+LIMIT_XDDE = "limit_xdde"
+LIMIT_BASIC = "limit_basic"
+LIMIT_QUOTA = "limit_quota"
+STATION_STATUS = "station_status"
+HOURLY_FORECAST_FILE_STATUS = "hourly_forecast_file_status"
+DAILY_FORECAST_FILE_STATUS = "daily_forecast_file_status"
+UVI_FILE_STATUS = "uvi_file_status"
+ALERTS = "alerts"
+ALERT_FILE_STATUS = "alert_file_status"
+ALERT_WIND = "alert_wind"
+ALERT_RAIN_INTENSITY = "alert_rain_intensity"
+ALERT_RAIN = "alert_rain"
+ALERT_SEA = "alert_sea"
+ALERT_COLD = "alert_cold"
+ALERT_WARM = "alert_warm"
+ALERT_WARM_NIGHT = "alert_warm_night"
+ALERT_SNOW = "alert_snow"
+QUOTA_FILE_STATUS = "quota_file_status"
+QUOTA_XDDE = "quota_xdde"
+QUOTA_PREDICCIO = "quota_prediccio"
+QUOTA_BASIC = "quota_basic"
+QUOTA_XEMA = "quota_xema"
+QUOTA_QUERIES = "quota_queries"
+LIGHTNING_FILE_STATUS = "lightning_file_status"
+SUN = "sun"
+SUNRISE = "sunrise"
+SUNSET = "sunset"
+SUN_FILE_STATUS = "sun_file_status"
+MOON_PHASE = "moon_phase"
+MOON_FILE_STATUS = "moon_file_status"
+MOONRISE = "moonrise"
+MOONSET = "moonset"
+
+from homeassistant.const import Platform
+
+ATTRIBUTION = "Powered by Meteocatpy & Solarmoonpy"
+PLATFORMS = [Platform.SENSOR, Platform.WEATHER]
+DEFAULT_NAME = "METEOCAT"
+
+# Tiempos para validación de API
+DEFAULT_VALIDITY_DAYS = 1  # Número de días a partir de los cuales se considera que el archivo de información está obsoleto
+DEFAULT_VALIDITY_HOURS = 6  # Hora a partir de la cual la API tiene la información actualizada de predicciones disponible para descarga
+DEFAULT_VALIDITY_MINUTES = 0  # Minutos a partir de los cuales la API tiene la información actualizada de predicciones disponible para descarga
+DEFAULT_UVI_LOW_VALIDITY_HOURS = 5  # Hora a partir de la cual la API tiene la información actualizada de datos UVI disponible para descarga con límite bajo de cuota
+DEFAULT_UVI_LOW_VALIDITY_MINUTES = 0  # Minutos a partir de los cuales la API tiene la información actualizada de datos UVI disponible para descarga con límite bajo de cuota
+DEFAULT_UVI_HIGH_VALIDITY_HOURS = 9  # Hora a partir de la cual la API tiene la información actualizada de datos UVI disponible para descarga con límite alto de cuota
+DEFAULT_UVI_HIGH_VALIDITY_MINUTES = 0  # Minutos a partir de los cuales la API tiene la información actualizada de datos UVI disponible para descarga con límite alto de cuota
+DEFAULT_ALERT_VALIDITY_TIME = 120  # Minutos a partir de los cuales las alertas están obsoletas y se se debe proceder a una nueva llamada a la API
+DEFAULT_QUOTES_VALIDITY_TIME = 240 # Minutos a partir de los cuales los datos de cuotas están obsoletos y se se debe proceder a una nueva llamada a la API
+DEFAULT_LIGHTNING_VALIDITY_TIME = 240 # Minutos a partir de los cuales los datos de rayos están obsoletos y se se debe proceder a una nueva llamada a la API
+DEFAULT_LIGHTNING_VALIDITY_HOURS = 1  # Hora a partir de la cual la API tiene la información actualizada de rayos disponible para descarga
+DEFAULT_LIGHTNING_VALIDITY_MINUTES = 0  # Minutos a partir de los cuales la API tiene la información actualizada de rayos disponible para descarga
+
+# Multiplicadores para la duración de validez basada en limit_prediccio
+ALERT_VALIDITY_MULTIPLIER_100 = 12  # para limit_prediccio <= 100
+ALERT_VALIDITY_MULTIPLIER_200 = 6   # para 100 < limit_prediccio <= 200
+ALERT_VALIDITY_MULTIPLIER_500 = 3   # para 200 < limit_prediccio <= 500
+ALERT_VALIDITY_MULTIPLIER_DEFAULT = 1  # para limit_prediccio > 500
+
+# CUOTA ALTA PARA FAVORECER ACTUALIZACIONES DIARIAS DE LAS PREDICCIONES
+PREDICCIO_HIGH_QUOTA_LIMIT = 550
+
+# Códigos de sensores de la API
+WIND_SPEED = "wind_speed"  # Velocidad del viento
+WIND_DIRECTION = "wind_direction"  # Dirección del viento
+WIND_DIRECTION_CARDINAL = "wind_direction_cardinal"  # Dirección del viento en cardinal
+TEMPERATURE = "temperature"  # Temperatura
+HUMIDITY = "humidity"  # Humedad relativa
+PRESSURE = "pressure"  # Presión atmosférica
+PRECIPITATION = "precipitation"  # Precipitación
+PRECIPITATION_ACCUMULATED = "precipitation_accumulated" #Precipitación acumulada
+PRECIPITATION_PROBABILITY = "precipitation_probability" #Precipitación probabilidad
+SOLAR_GLOBAL_IRRADIANCE = "solar_global_irradiance"  # Irradiación solar global
+UV_INDEX = "uv_index"  # UV
+MAX_TEMPERATURE = "max_temperature"  # Temperatura máxima
+MIN_TEMPERATURE = "min_temperature"  # Temperatura mínima
+FEELS_LIKE = "feels_like"  # Sensación térmica
+WIND_GUST = "wind_gust"  # Racha de viento
+STATION_TIMESTAMP = "station_timestamp"  # Código de tiempo de la estación
+CONDITION = "condition"  # Estado del cielo
+MAX_TEMPERATURE_FORECAST = "max_temperature_forecast"  # Temperatura máxima prevista
+MIN_TEMPERATURE_FORECAST = "min_temperature_forecast"  # Temperatura mínima prevista
+LIGHTNING_REGION = "lightning_region"  # Rayos de la comarca
+LIGHTNING_TOWN = "lightning_town"  # Rayos de la población
+
+# Definición de códigos para variables
+WIND_SPEED_CODE = 30
+WIND_DIRECTION_CODE = 31
+TEMPERATURE_CODE = 32
+HUMIDITY_CODE = 33
+PRESSURE_CODE = 34
+PRECIPITATION_CODE = 35
+SOLAR_GLOBAL_IRRADIANCE_CODE = 36
+UV_INDEX_CODE = 39
+MAX_TEMPERATURE_CODE = 40
+MIN_TEMPERATURE_CODE = 42
+WIND_GUST_CODE = 50
+
+# Mapeo de códigos 'estatCel' a condiciones de Home Assistant
+CONDITION_MAPPING = {
+    "sunny": [1],
+    # "clear-night": [1],
+    "partlycloudy": [2, 3],
+    "cloudy": [4, 20, 21, 22],
+    "rainy": [5, 6, 23],
+    "pouring": [7, 8, 25],
+    "lightning-rainy": [8, 24],
+    "hail": [9],
+    "snowy": [10, 26, 27, 28],
+    "fog": [11, 12],
+    "snow-rainy": [27, 29, 30],
+}