Skip to content
HALOWERK

Ortwerk

roof potential

Loads the building containing the point from the official 3D building model LoD2 of North Rhine-Westphalia (Geobasis NRW, OGC API Features, CityJSON, dl-de/zero-2-0, model of 2025/2026), converts every RoofSurface to ETRS89/UTM32 and computes area (Newell normal, scale-corrected), tilt and azimuth. Faces with tilt up to 60° that do not face north (azimuth outside 315°–45°, flat roofs always) and have at least 5 m² are counted as suitable. Peak power = suitable area × usable_share ×.

POST https://ort.halowerk.com/v1/roof-potential

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
latnumberYesLatitude in WGS84 decimal degrees (Germany).
lonnumberYesLongitude in WGS84 decimal degrees (Germany).
kwp_per_m2numberNoModule peak power per m² of module area (default 0.2 kWp/m²).
usable_sharenumberNoShare of the suitable roof area that can be covered by modules (edges, dormers, chimneys; default 0.7).
system_loss_pctnumberNoPV system losses in percent for PVGIS (default 14).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "lat",
    "lon"
  ],
  "properties": {
    "lat": {
      "type": "number",
      "minimum": 47.2,
      "maximum": 55.1,
      "description": "Latitude in WGS84 decimal degrees (Germany)."
    },
    "lon": {
      "type": "number",
      "minimum": 5.8,
      "maximum": 15.1,
      "description": "Longitude in WGS84 decimal degrees (Germany)."
    },
    "kwp_per_m2": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 0.25,
      "default": 0.2,
      "description": "Module peak power per m² of module area (default 0.2 kWp/m²)."
    },
    "usable_share": {
      "type": "number",
      "minimum": 0.3,
      "maximum": 1,
      "default": 0.7,
      "description": "Share of the suitable roof area that can be covered by modules (edges, dormers, chimneys; default 0.7)."
    },
    "system_loss_pct": {
      "type": "number",
      "minimum": 0,
      "maximum": 40,
      "default": 14,
      "description": "PV system losses in percent for PVGIS (default 14)."
    }
  }
}

Open original schema

Published input example

{
  "lat": 51.453857,
  "lon": 7.013474
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →