{ "config": { "step": { "user": { "data": { "azimuth": "Azimuth (360 degrees, 0 = North, 90 = East, 180 = South, 270 = West)", "declination": "Declination (0 = Horizontal, 90 = Vertical)", "latitude": "[%key:common::config_flow::data::latitude%]", "longitude": "[%key:common::config_flow::data::longitude%]", "modules_power": "Total Watt peak power of your solar modules" }, "description": "Fill in the data of your solar panels. Please refer to the documentation if a field is unclear." } } }, "config_subentries": { "plane": { "abort": { "api_key_required": "An API key is required to add more than one plane. You can configure it in the integration options.", "max_planes": "You can add a maximum of 4 planes.", "reconfigure_successful": "[%key:common::config_flow::abort::reconfigure_successful%]" }, "entry_type": "Plane", "initiate_flow": { "user": "Add plane" }, "step": { "reconfigure": { "data": { "azimuth": "[%key:component::forecast_solar::config::step::user::data::azimuth%]", "declination": "[%key:component::forecast_solar::config::step::user::data::declination%]", "modules_power": "[%key:component::forecast_solar::config::step::user::data::modules_power%]" }, "description": "Edit the solar plane configuration." }, "user": { "data": { "azimuth": "[%key:component::forecast_solar::config::step::user::data::azimuth%]", "declination": "[%key:component::forecast_solar::config::step::user::data::declination%]", "modules_power": "[%key:component::forecast_solar::config::step::user::data::modules_power%]" }, "description": "Add a solar plane. Multiple planes are supported with a Forecast.Solar API subscription." } } } }, "entity": { "sensor": { "energy_current_hour": { "name": "Estimated energy production - this hour" }, "energy_next_hour": { "name": "Estimated energy production - next hour" }, "energy_production_today": { "name": "Estimated energy production - today" }, "energy_production_today_remaining": { "name": "Estimated energy production - remaining today" }, "energy_production_tomorrow": { "name": "Estimated energy production - tomorrow" }, "power_highest_peak_time_today": { "name": "Highest power peak time - today" }, "power_highest_peak_time_tomorrow": { "name": "Highest power peak time - tomorrow" }, "power_production_next_12hours": { "name": "Estimated power production - in 12 hours" }, "power_production_next_24hours": { "name": "Estimated power production - in 24 hours" }, "power_production_next_hour": { "name": "Estimated power production - in 1 hour" }, "power_production_now": { "name": "Estimated power production - now" } } }, "exceptions": { "api_key_required": { "message": "An API key is required when more than one plane is configured" }, "end_before_start": { "message": "The end time must be after the start time." }, "no_plane": { "message": "No plane configured, cannot set up Forecast.Solar" } }, "options": { "error": { "api_key_required": "An API key is required to add more than one plane. You can configure it in the integration options.", "invalid_api_key": "[%key:common::config_flow::error::invalid_api_key%]" }, "step": { "init": { "data": { "api_key": "[%key:common::config_flow::data::api_key%]", "damping_evening": "Damping factor: adjusts the results in the evening", "damping_morning": "Damping factor: adjusts the results in the morning", "inverter_size": "Inverter size (Watt)" }, "description": "These values allow tweaking the Forecast.Solar result. Please refer to the documentation if a field is unclear." } } }, "selector": { "forecast_resolution": { "options": { "hourly": "Aggregated to whole hours", "raw": "Native (15-minute or hourly, depending on account)" } } }, "services": { "get_forecast": { "description": "Returns the solar production forecast time series for a configured Forecast.Solar entry.", "fields": { "config_entry": { "description": "The Forecast.Solar configuration entry to query.", "name": "Forecast.Solar entry" }, "end": { "description": "Latest period start to return (exclusive). If omitted, the response includes the full cached forecast.", "name": "End" }, "resolution": { "description": "Resolution of the returned series. 'Native' uses the upstream Forecast.Solar resolution (15-minute on paid accounts, hourly on the free tier). 'Hourly' aggregates to whole-hour buckets.", "name": "Resolution" }, "start": { "description": "Earliest period start to return (inclusive). If omitted, the response begins at the start of the cached forecast.", "name": "Start" } }, "name": "Get forecast" } } }