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-hoursInputs
| Field | Type | Required | Description |
|---|---|---|---|
| lat | number | Yes | Latitude in WGS84 decimal degrees (Germany). |
| lon | number | Yes | Longitude in WGS84 decimal degrees (Germany). |
| facade_azimuth_deg | number | Yes | Direction the facade faces (outward normal), degrees from north clockwise: 90 east, 180 south, 270 west. |
| obstruction_elevation_deg | number | No | Uniform obstruction angle above the horizon (e.g. opposite buildings), degrees. |
| horizon_profile | array | No | Optional horizon profile; elevation is interpolated linearly between the given azimuths. |
| year | integer | No | Calendar 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."
}
}
}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
- Ortwerk0.01 USDC
area coverage
POSThttps://ort.halowerk.com/v1/area-coverageRuns one multi-source Dijkstra from all origins (Routing runs on HALOWERK's own graph of the German road and path network built from OpenStreetMap (Geofabrik germany-latest.osm.pbf, data until 2026-11-12, ODbL 1.0; 25 million nodes, edges a
- Ortwerk0.004 USDC
autobahn roadworks
POSThttps://ort.halowerk.com/v1/autobahn-roadworksFetches live roadworks (long- and short-term) and closures per motorway from the public Autobahn App API of Die Autobahn GmbH des Bundes (no key; https://verkehr.autobahn.de/o/autobahn). The free-text periods are parsed into concrete interv
- Ortwerk0.004 USDC
avalanche bulletin
POSThttps://ort.halowerk.com/v1/avalanche-bulletinFresh official WSL SLF CAAMLv6 JSON for one Swiss warning region, in de/en/fr/it with explicit actual-language fallback. Includes the complete unmodified bulletin, all elevation/aspect/time distinctions, publication and validity times, sour