Copy page

Standorte & Daten

Standorte & Solarflächen

Ein Standort (Site) beschreibt eine PV-Anlage einmal vollständig. Danach fragen Sie Prognosen und historische Daten nur noch über die site_id ab — ohne die Konfiguration jedes Mal mitzuschicken.

Aufbau eines Standorts

Ein Standort besteht aus drei Teilen:

1. Lage — latitude, longitude (Pflicht). elevation, timezone und der Geländehorizont werden automatisch ermittelt.
2. Strings — eine Liste von PV-Strings (Teilanlagen) mit eigener Geometrie.
3. Config — optionale, anlagenweite Feinkonfiguration. Nur explizit gesetzte Werte werden gespeichert; alles andere folgt den aktuellen Systemstandards.

Standort anlegen (Body)
{
  "name": "Dach Süd",
  "latitude": 48.8566,
  "longitude": 2.3522,
  "strings": [
    {
      "slope": 30,
      "orientation": 180,
      "power_kw": 8
    },
    {
      "slope": 30,
      "orientation": 90,
      "power_kw": 4
    }
  ],
  "config": {
    "modules": {
      "technology": "topcon"
    },
    "tracking": {
      "type": "fixed"
    }
  }
}

PV-Strings

Jeder String ist eine eigenständige Teilanlage. Der Standort summiert die Leistung aller Strings. Beim Anlegen einer Site wird automatisch ein Standardstring (10kWp, 180° Süd, 30° Neigung) hinterlegt, den Sie jederzeit bearbeiten können.

Feld	Bedeutung
id	Stabile String-ID (z. B. str_9f3a1c08). Vom Server vergeben, schreibgeschützt.
slope	Modulneigung in Grad (0 = horizontal, 90 = senkrecht).
orientation	Azimut in Grad (0 = N, 90 = O, 180 = S, 270 = W).
power_kw	Peak-Leistung des Strings in kW.
gcr	Ground Coverage Ratio für Reihenverschattung (optional).
near_field_shading	Nahfeld-Verschattung des Strings (optional).

Konfiguration (Config)

Die anlagenweite Config ist in Gruppen organisiert. Alle Felder sind optional — fehlt eine Gruppe, gelten die Systemstandards.

Gruppe	Inhalt
modules	Modultechnik (monosi, multisi, perc, topcon, cdte), Temperaturkoeffizient, Installationsjahr.
mounting	Montageart (open, mix, isol) und Höhe über Grund.
inverter	Wechselrichter-Clipping (max/min in % der DC-Nennleistung).
losses	Verluste & Gewinne: Kabel, Konversion, Albedo, Schnee-Abrutschen, Diffusmodell.
shading	Geländehorizont nutzen (use_terrain_horizon) und Himmelshindernisse (sky_obstruction).
tracking	Tracker-Typ (fixed, single_axis, dual_axis) und Achsenparameter.

Die genauen Wertebereiche und Defaults jeder Gruppe stehen in der API-Referenz.

Automatisch ermittelte Felder

Aus den Koordinaten werden beim Anlegen (und bei Standortänderung) automatisch bestimmt und gespeichert:

• elevation — Höhe über NN in Metern.
• timezone — IANA-Zeitzone (z. B. Europe/Berlin), Basis für lokale Zeitstempel.
• Geländehorizont — fließt in die Verschattungsrechnung ein.

Temporäre Standorte

Mit is_ephemeral: true markieren Sie einen Standort als temporär/experimentell. Diese Funktion erfordert einen passenden Plan. Temporäre Standorte werden automatisch zum 1. des kommenden Monats gelöscht. Einen temporären Standort dauerhaft zu machen (is_ephemeral: false) ist immer erlaubt.

Limits

Limit	Verhalten
Standort-Limit	Maximale Anzahl Standorte (kann unmetered sein).
String-Limit	Maximale Strings pro Standort.
Standortwechsel	Fest 1 Standortwechsel pro 30 Tage je Standort (planunabhängig).

Löschen & Wiederherstellen

Gelöschte Standorte werden zunächst als „pending deletion" markiert (deleted_at gesetzt) und erst 30 Tage später endgültig entfernt. Innerhalb dieser Frist lassen sie sich wiederherstellen. Details in der API-Referenz.