Electricity maps

The Electricity Maps App provides Eliona with real-time electricity grid data from Electricity Maps, including CO₂ intensity and the share of renewable energy for various geographical zones.

App-Schema

Installation

Install the Electricity Maps App via the Eliona App Store.

Configuration

Register with Electricity Maps

1. Create an account at Electricity Maps

2. Subscribe to the appropriate API plan (free version available for basic use in one region)

3. Generate an API key in your account settings and save it for the Eliona configuration

Configure the Electricity Maps App

Configurations can be created in Eliona under Settings > Apps > Electricity Maps, which opens the app interface Generic Frontend. Use the configuration endpoint with the PUT method.

The configuration requires the following data:

Attribute	Description	Required
apiKey	Electricity Maps API key from the previous step	Yes
enable	Flag to activate/deactivate this configuration	Yes
refreshInterval	Interval in seconds for data synchronization (minimum 300 recommended)	Yes
requestTimeout	API query timeout in seconds	No (Standard: 120)
projectIDs	List of Eliona Project IDs for data collection	Yes

Example configuration JSON:

{
  "apiKey": "Ihr-API-Schlüssel",
  "enable": true,
  "refreshInterval": 900,
  "requestTimeout": 120,
  "projectIDs": [
    "10"
  ]
}

Asset Creation

After configuration, the app creates an Electricity Zone asset type. You can create multiple assets of this type, each representing a geographical zone to be monitored.

Configure Electricity Zone Locations

1. Create a new asset of type Electricity Zone

2. Click on the edit button of the asset

3. In the "More Information" section, set the zone identifier (z.B. "CH" oder "Switzerland" für die Schweiz, "DE" oder "Germany" für Deutschland)

4. Save the asset configuration

5. Refresh the page to check if the app has correctly identified the zone

The asset is then filled with electricity grid data:

Attribut	Beschreibung	Einheit
carbon_intensity	CO₂-Intensität des Stromverbrauchs	gCO₂eq/kWh
renewable_percentage	Anteil erneuerbarer Energien am Stromverbrauch	%
fossil_free_percentage	Anteil fossiler-freier Energie am Stromverbrauch	%

App Status Monitoring

The app creates a root asset named "Electricity Maps Root" that provides information about the app's status:

• Asset status: Active/Inactive indicates whether the app is running

• Status attribute: Shows the current operational status. If the app status is not "OK", this indicates that the app may not be functioning correctly. If the error state persists, let us know by submitting an error report.

Anwendungsfälle

The Electricity Maps App enables:

• Real-time monitoring of electricity grid CO₂ intensity

• Tracking the share of renewable energies

• Optimizing energy purchasing

• ESG reporting and sustainability tracking

• Load management strategies based on grid composition

• CO₂-conscious load shifting