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
  • Solar park capacity capacity
    Specify the 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).
    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.
    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
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.
  • 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

Create solar site
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": "1h",
		"usePhysicalModels": True,
		"trainNearTermModels": False,
		"trainLongTermModels": False
	},
	"assets": [
		{
			"azimuth": 180,
			"tilt": 30,
			"capacity": 1000,
			"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 following example shows how to create a solar site with different panel orientations and/or inclinations, which is often the case for PV systems on roof tops.
Create multi-asset solar site
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": "1h",
		"usePhysicalModels": True,
		"trainNearTermModels": False,
		"trainLongTermModels": False
	},
	"assets": [
		{
			"azimuth": 180,
			"tilt": 30,
			"capacity": 10,
			"install_date": "2020-01-01"
		},
		{
			"azimuth": 90,
			"tilt": 25,
			"capacity": 5,
			"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"
}