<!--
{
  "availability" : [
    "iOS: 26.0.0 -",
    "iPadOS: 26.0.0 -",
    "macCatalyst: -"
  ],
  "documentType" : "symbol",
  "framework" : "EnergyKit",
  "identifier" : "/documentation/EnergyKit/ElectricityGuidance/Service/guidance(using:at:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "EnergyKit"
    ],
    "preciseIdentifier" : "s:9EnergyKit19ElectricityGuidanceV7ServiceC8guidance5using2atQrAC5QueryV_10Foundation4UUIDVtF"
  },
  "title" : "guidance(using:at:)"
}
-->

# guidance(using:at:)

Returns an async sequence of electricity guidance forecasts for the
requested venue with cost information incorporated, if available.

```
final func guidance(using query: ElectricityGuidance.Query, at energyVenueID: UUID) -> some AsyncSequence<ElectricityGuidance, any Error>
```

## Parameters

`query`

The [`ElectricityGuidance.Query`](/documentation/EnergyKit/ElectricityGuidance/Query) that you request.

`energyVenueID`

The [`EnergyVenue`](/documentation/EnergyKit/EnergyVenue) at which the devices consume electricity.

## Return Value

Returns an `AsyncSequence` of [`ElectricityGuidance`](/documentation/EnergyKit/ElectricityGuidance) forecasts
with error type [`EnergyKitError.guidanceUnavailable`](/documentation/EnergyKit/EnergyKitError/guidanceUnavailable).

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)