Skip to content
HALOWERK

Ortwerk

facade sun hours

Computes the sun position every 5 minutes over a whole year with the NOAA solar position equations (Spencer 1971 Fourier series for declination and equation of time, accuracy about 0.1°) plus Bennett refraction, and counts the time in which the sun is above the horizon (or a given obstruction / horizon profile) and in front of the vertical facade (angle between sun azimuth and facade normal below 90°). Returns annual and monthly hours, the share of astronomical daylight, and for 20 March, 21.

POST https://ort.halowerk.com/v1/facade-sun-hours

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
latnumberYesLatitude in WGS84 decimal degrees (Germany).
lonnumberYesLongitude in WGS84 decimal degrees (Germany).
facade_azimuth_degnumberYesDirection the facade faces (outward normal), degrees from north clockwise: 90 east, 180 south, 270 west.
obstruction_elevation_degnumberNoUniform obstruction angle above the horizon (e.g. opposite buildings), degrees.
horizon_profilearrayNoOptional horizon profile; elevation is interpolated linearly between the given azimuths.
yearintegerNoCalendar year.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "lat",
    "lon",
    "facade_azimuth_deg"
  ],
  "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)."
    },
    "facade_azimuth_deg": {
      "type": "number",
      "minimum": 0,
      "maximum": 360,
      "description": "Direction the facade faces (outward normal), degrees from north clockwise: 90 east, 180 south, 270 west."
    },
    "obstruction_elevation_deg": {
      "type": "number",
      "minimum": 0,
      "maximum": 60,
      "default": 0,
      "description": "Uniform obstruction angle above the horizon (e.g. opposite buildings), degrees."
    },
    "horizon_profile": {
      "type": "array",
      "minItems": 2,
      "maxItems": 72,
      "description": "Optional horizon profile; elevation is interpolated linearly between the given azimuths.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "azimuth_deg",
          "elevation_deg"
        ],
        "properties": {
          "azimuth_deg": {
            "type": "number",
            "minimum": 0,
            "maximum": 360
          },
          "elevation_deg": {
            "type": "number",
            "minimum": 0,
            "maximum": 80
          }
        }
      }
    },
    "year": {
      "type": "integer",
      "minimum": 2000,
      "maximum": 2100,
      "default": 2026,
      "description": "Calendar year."
    }
  }
}

Open original schema

Published input example

{
  "lat": 52.52,
  "lon": 13.405,
  "facade_azimuth_deg": 180
}

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 →