PV Power Site

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/solcast/main/json-schema/solcast-pv-power-site-schema.json",
  "title": "PV Power Site",
  "description": "A registered Solcast PV power site with full system specifications used with the advanced PV power model.",
  "type": "object",
  "properties": {
    "resource_id": {
      "type": "string",
      "description": "Unique identifier assigned by Solcast when a site is registered.",
      "examples": ["ba75-e17a-7374-95ed"]
    },
    "name": {
      "type": "string",
      "description": "User-defined name for the PV site (does not need to be unique).",
      "examples": ["Sydney Rooftop Array"]
    },
    "latitude": {
      "type": "number",
      "description": "Site latitude in decimal degrees (north positive).",
      "minimum": -90,
      "maximum": 90,
      "examples": [-33.856784]
    },
    "longitude": {
      "type": "number",
      "description": "Site longitude in decimal degrees (east positive).",
      "minimum": -180,
      "maximum": 180,
      "examples": [151.215297]
    },
    "capacity": {
      "type": "number",
      "description": "DC system capacity in kilowatts (kW).",
      "minimum": 0,
      "examples": [10.0]
    },
    "tilt": {
      "type": "number",
      "description": "Panel tilt angle in degrees from horizontal (0 = flat, 90 = vertical).",
      "minimum": 0,
      "maximum": 90,
      "examples": [25]
    },
    "azimuth": {
      "type": "number",
      "description": "Panel azimuth in degrees clockwise from north (0/360 = north, 90 = east, 180 = south, 270 = west).",
      "minimum": 0,
      "maximum": 360,
      "examples": [180]
    },
    "install_date": {
      "type": "string",
      "format": "date",
      "description": "Date the PV system was installed (YYYY-MM-DD).",
      "examples": ["2020-06-01"]
    },
    "ac_capacity": {
      "type": "number",
      "description": "AC inverter output capacity in kilowatts (kW).",
      "minimum": 0
    },
    "dc_capacity": {
      "type": "number",
      "description": "DC array capacity in kilowatts (kW). May differ from capacity if clipping occurs.",
      "minimum": 0
    },
    "loss_factor": {
      "type": "number",
      "description": "System loss factor as a fraction (0–1). Accounts for wiring, soiling, degradation, and other losses. Typical values 0.75–0.95.",
      "minimum": 0,
      "maximum": 1,
      "examples": [0.9]
    },
    "tracking_type": {
      "type": "string",
      "description": "Panel tracking mechanism type.",
      "enum": ["fixed", "horizontal_single_axis", "vertical_single_axis", "two_axis"],
      "examples": ["fixed"]
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the site was registered in Solcast."
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the site was last modified."
    }
  },
  "required": ["resource_id", "name", "latitude", "longitude"],
  "examples": [
    {
      "resource_id": "ba75-e17a-7374-95ed",
      "name": "Sydney Rooftop Array",
      "latitude": -33.856784,
      "longitude": 151.215297,
      "capacity": 10.0,
      "tilt": 25,
      "azimuth": 180,
      "install_date": "2020-06-01",
      "loss_factor": 0.9,
      "tracking_type": "fixed",
      "created_at": "2020-06-15T10:00:00.0000000Z",
      "updated_at": "2023-01-10T09:00:00.0000000Z"
    }
  ]
}