Weather

The weather app provides Eliona weather data from OpenWeatherMap.

App schema

Installation

1. Navigate to the Eliona App Store

2. Search for "Weather App"

3. Click "Install" and confirm the installation

4. Wait for the installation confirmation (usually 1-2 minutes)

Configuration

OpenWeatherMap registration

1. Visit OpenWeatherMap and create an account

2. Subscribe to the "One Call API 3.0" service (free version available)

3. Generate your API key in the account dashboard

4. Note down your API key for the Eliona configuration

App configuration parameters

Parameter	Description	Required	Default value
apiKey	Your OpenWeatherMap API key	Yes	-
enable	Enables/Disables the configuration	Yes	true
refreshInterval	Data synchronization interval (seconds)	Yes	300
requestTimeout	API request timeout (seconds)	No	120
projectIDs	Eliona project IDs for data collection	Yes	-

Configuration steps

1. Navigate to Settings > Apps > Weather in Eliona

2. Access the Generic Frontend interface

3. Use the configuration endpoint with the PUT method

4. Enter your configuration in JSON format:

{
  "apiKey": "your-api-key",
  "enable": true,
  "refreshInterval": 300,
  "requestTimeout": 120,
  "projectIDs": [
    "10"
  ]
}

Asset management

Asset type

The app creates a Weather-asset type that represents weather monitoring locations.

Creating weather assets

1. Navigate to Assets in Eliona

2. Click "Create new asset"

3. Select "Weather" as the asset type

4. Configure the basic asset properties

5. Save the new asset

Location configuration

1. Open your weather asset

2. Click the edit button

3. In the "More information" section:

   • Enter the location name (e.g. "Zurich, Switzerland")

   • For best results, use the format: "City, Country" or "City, State, Country"

4. Save the configuration

5. Refresh the page to verify:

   • The location name appears with additional geographic details

   • Weather data begins to fill the asset attributes

Location troubleshooting

If the location is not found:

1. Try more specific location names

2. Add country or state information

3. Check whether the location exists in the OpenWeatherMap database

4. Check for typos in the location name

Weather data attributes

The app provides these weather properties:

Attribute	Description	Unit
temperature	Current air temperature	°C
feels_like	Perceived temperature taking wind and humidity into account	°C
pressure	Air pressure at the location	hPa
humidity	Relative humidity in percent	%
dew_point	Temperature at which dew forms	°C
uvi	Ultraviolet index indicating the risk of sunburn	-
clouds	Percentage of cloud cover	%
wind_speed	Current wind speed	m/s
wind_deg	Wind direction in degrees (0-360)	°

App status monitoring

The app creates a "Weather Root" asset that provides:

Status indicators

• Asset status: Indicates the active/inactive state

• Status attribute: Current operating status with possible values:

Status	Description	Recommended action
OK	Normal operation	No action required
API_ERROR	Problem with the OpenWeatherMap API	Check API key and network connection
CONFIG_ERROR	Configuration issue	Check app configuration
RATE_LIMIT	API rate limit exceeded	Increase the refresh interval or upgrade the API plan
NETWORK_ERROR	Connection problem	Check network settings

Use cases

Building energy optimization

• Adjustment of HVAC systems based on outside temperature

• Optimization of cooling systems using humidity data

• Implementation of natural ventilation strategies based on wind conditions

Renewable energy management

• Prediction of solar power generation using cloud cover data

• Adjustment of wind turbine operation based on wind speed/direction

• Implementation of weather-dependent energy storage strategies

Facility management

• Planning maintenance activities considering weather conditions

• Implementation of weather-dependent cleaning schedules

• Optimization of landscape irrigation based on precipitation forecasts

Analytics and reporting

• Correlation of energy consumption with weather patterns

• Creation of reports on weather impacts

• Creation of predictive models for energy consumption