---
title: "guidance(using:at:)"
framework: energykit
role: symbol
role_heading: Instance Method
path: "energykit/electricityguidance/service/guidance(using:at:)"
---

# guidance(using:at:)

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

## Declaration

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

```

## Parameters

- `query`: The doc://com.apple.energykit/documentation/EnergyKit/ElectricityGuidance/Query that you request.
- `energyVenueID`: The doc://com.apple.energykit/documentation/EnergyKit/EnergyVenue at which the devices consume electricity.

## Return Value

Return Value Returns an AsyncSequence of ElectricityGuidance forecasts with error type EnergyKitError.guidanceUnavailable.