---
title: ElectricHVACLoadEvent
framework: energykit
role: symbol
role_heading: Structure
path: energykit/electrichvacloadevent
---

# ElectricHVACLoadEvent

A measurement of the electricity consumed by an HVAC system.

## Declaration

```swift
struct ElectricHVACLoadEvent
```

## Overview

Overview Submit events representing electricity consumption to provide insights about electricity usage and your managed devices’ adherence to ElectricityGuidance. These events are data points recorded at specific points in time for a given EnergyVenue that allow the venue to determine when the device used electricity and the electricity’s cleanliness based on historical guidance. The framework can also determine relative cost using the rate plan at the energy venue, if available. After you submit load events to report the electricity consumption of HVAC devices, you can request insights through ElectricityInsightQuery. When you adopt the EnergyKit LoadEvents Entitlement, the Home app displays your device’s energy usage with the device name you provide. important: The system stores and syncs the energy data that you provide through load events with end-to-end encryption through the entire process, ensuring the data isn’t accessible to anyone, even Apple. For more information, see EnergyKit data security. Submit electrical HVAC load events Save data to the load event when the heating or cooling stage changes. An electric HVAC load event provides information about the state transitions of the HVAC unit when it’s actively consuming energy. Significant changes may include: A person initiated an action A pause in power consumption such as going idle The heating or cooling stage changed Idle devices between heating or cooling cycles don’t generate events. The device that requested ElectricityGuidance must submit the corresponding load events. Load events for an EnergyVenue are accessible to all people that use the Home app.

## Topics

### Creating an electrical load event

- [init(timestamp:measurement:session:device:)](energykit/electrichvacloadevent/init(timestamp:measurement:session:device:).md)

### Getting load event information

- [id](energykit/electrichvacloadevent/id.md)
- [timestamp](energykit/electrichvacloadevent/timestamp.md)
- [session](energykit/electrichvacloadevent/session-swift.property.md)
- [ElectricHVACLoadEvent.Session](energykit/electrichvacloadevent/session-swift.struct.md)

### Getting device information

- [deviceID](energykit/electrichvacloadevent/deviceid.md)
- [deviceName](energykit/electrichvacloadevent/devicename.md)

### Getting electrical measurements

- [measurement](energykit/electrichvacloadevent/measurement.md)
- [ElectricHVACLoadEvent.ElectricalMeasurement](energykit/electrichvacloadevent/electricalmeasurement.md)

### Deprecated

- [init(timestamp:measurement:session:deviceID:)](energykit/electrichvacloadevent/init(timestamp:measurement:session:deviceid:).md)

## Relationships

### Conforms To

- [Decodable](swift/decodable.md)
- [ElectricalLoadEventProtocol](energykit/electricalloadeventprotocol.md)
- [Encodable](swift/encodable.md)
- [Identifiable](swift/identifiable.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)