Skip to main content

What data do I need to create a new site

You will need to provide some data about the site and some settings about the forecasting models. Type of the site type
Specify the type of the site. For a solar site it should be: solar.
Name of the site name
Specify a name for the site. It is used to easily recognize the site. It is a string.
Example: My solar site
Latitude of the site location latitude
Specify the latitude of the site location. It takes a value between -90 and 90.
Example: 52.5
Longitude of the site location longitude
Specify the longitude of the site location. It takes a value between -180 and 180.
Example: 13.4
Assets assets
  • Mount type mount
    Specify the mount type. This parameter accepts one of the following values: fixed, single_axis_tracking, or dual_axis_tracking, representing fixed, single-axis tracking, and dual-axis tracking mounting configurations that determine how the panels are oriented and whether they follow the sun’s movement.
    Default value: fixed
  • Solar park capacity capacity
    Specify the DC capacity of the solar park in kilowatts (kW). It is a positive number.
    Example: 1000
  • Solar panels orientation azimuth
    Specify the orientation (azimuth) of the PV panels in degrees. It is a positive number between 0 and 360 (0 N, 90 E, 180 S, 270 W). This parameter applies only to the Fixed mount type.
    Example: 180
  • Solar panels inclination tilt
    Specify the inclination (tilt) of the PV panels in degrees. It is a positive number between 0 and 90. This parameter applies only to the Fixed mount type.
    Example: 180
  • Installation date install_date
    Specify the date when the system was installed. It is a string with format: “YYYY-MM-DD”.
    Example: 2020-01-01
The following parameters are applicable only to the single-axis tracking mount type.
  • Axis tilt axis_tilt
    Specify the axis inclination (tilt). It is a positive number between 0 and 90. 0 means that the rotation axis is horizontal.
    Example: 0
  • Axis azimuth axis_azimuth
    Specify the axis orientation (azimuth). It is a positive number between 0 and 180 degrees and defines the plane about which the panels rotate to follow the sun. An azimuth of 0 or 180 indicates a north–south axis, where panels track the sun from east to west throughout the day. An azimuth of 90 indicates an east–west axis, where panels track from north to south.
    Example: 180
  • Axis maximum rotation angle max_angle
    Specify the maximum rotation angle of the single-axis tracking system. It is a positive number between 0 and 90 degrees and defines the maximum tilt from the horizontal that the tracker can reach. The system will not rotate beyond this limit in either direction.
    Example: 45
  • Backtrack backtrack
    Controls whether the tracker has the capability to backtrack to avoid row-to-row shading. false denotes no backtrack capability. true denotes backtrack capability.
    Example: true
  • Ground coverage ratio gcr
    Specify the ground coverage ratio. It is a decimal number between 0 and 1 and defines the ratio between the PV array surface area to the total ground area.
    Default value: 0.2857
Settings settings
  • Model resolution model_resolution
    Specify how frequently the forecasts will be updated. It can be every 15 minutes, 30 minutes, 1 hour or daily. It takes one of the following values: 15min, 30min, 1h or 1d.
  • Forecast max value forecast_max_value
    Specify an upper limit for the forecasts in kilowatts (kW). This setting is useful when the inverter’s rated output power is lower than the DC capacity of the solar panels, or when a grid export limit restricts how much power can be delivered. It is a positive number. If null no cap is applied.
  • Train long-term models trainLongTermModels
    Specify if a model based on typical meteorological year should be trained for long-term forecasting. It takes one of the following values: true or false
  • Train near-term models trainNearTermModels
    Specify if a model based on recent power observations should be trained for short-term forecasting. Power observations should be available in real time in this case. It takes one of the following values: true or false
  • Use physical models usePhysicalModels
    Specify if physical models should be enabled. No training data are required for physical models to work. It takes one of the following values: true or false

Create solar sites examples

import requests

api_key = "Your API key" # Set your API key

payload = {
	"type": "solar",
	"name": "My solar site",
	"latitude": 52.5,
	"longitude": 13.4,
	"settings": {
		"model_resolution": "15min",
		"forecast_max_value": 800, # e.g. inverter rated power or grid export limit
		"usePhysicalModels": True,
		"trainNearTermModels": False,
		"trainLongTermModels": False
	},
	"assets": [
		{
			"azimuth": 180,
			"tilt": 30,
			"capacity": 1000, # DC capacity
			"install_date": "2020-01-01"
		}
	]
}

url = "https://api.rebase.energy/platform/v2/sites"

headers = {"Authorization": api_key, "Content-Type": "application/json"}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
response = response.json()
The API response contains the ID of the new site.
Response example
{
    "site_id": "a923653c-26f1-1b29-955d-ffde5d182276"
}