Ortwerk
viewshed
Reads the DEM with an own GeoTIFF reader (TIFF 6.0/BigTIFF, strips or tiles, none/LZW/Deflate/PackBits, predictors 2 and 3, 8–64 bit, GDAL_NODATA honoured). For every cell centre within max_distance_m and for each target, the elevation profile from the observer eye (ground + observer_height_m) is sampled every half pixel with bilinear interpolation; a target is visible when its elevation angle is not below the steepest angle along the profile. Earth curvature with atmospheric refraction is.
POST https://ort.halowerk.com/v1/viewshedInputs
| Field | Type | Required | Description |
|---|---|---|---|
| geotiff_base64 | string | No | GeoTIFF file, base64 (uncompressed, LZW, Deflate or PackBits; strips or tiles; 8–64 bit). |
| geotiff_url | string | No | Alternative: public http(s) URL of a GeoTIFF up to 12 MB (downloaded once per call). |
| band | integer | No | Band number (1-based). |
| observer | object | Yes | Observer position: lon/lat (supported CRS), x/y in the raster CRS, or col/row. |
| observer_height_m | number | No | Eye height above ground. |
| target_height_m | number | No | Height above ground of the evaluated cells and of targets without height_m. |
| max_distance_m | number | No | Radius of the analysis; default the whole raster. |
| curvature | boolean | No | Apply earth curvature and refraction. |
| refraction_coefficient | number | No | |
| targets | array | No | Points to test for visibility. |
| output_raster | boolean | No | Return a uint8 GeoTIFF (1 visible, 0 hidden, 255 outside/no data) of the analysis window. |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"observer"
],
"properties": {
"geotiff_base64": {
"type": "string",
"maxLength": 6000000,
"description": "GeoTIFF file, base64 (uncompressed, LZW, Deflate or PackBits; strips or tiles; 8–64 bit)."
},
"geotiff_url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Alternative: public http(s) URL of a GeoTIFF up to 12 MB (downloaded once per call)."
},
"band": {
"type": "integer",
"minimum": 1,
"maximum": 64,
"default": 1,
"description": "Band number (1-based)."
},
"observer": {
"type": "object",
"additionalProperties": false,
"properties": {
"lon": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"x": {
"type": "number",
"description": "X in the raster CRS."
},
"y": {
"type": "number",
"description": "Y in the raster CRS."
},
"col": {
"type": "integer",
"minimum": 0
},
"row": {
"type": "integer",
"minimum": 0
},
"id": {
"type": "string",
"maxLength": 100
}
},
"description": "Observer position: lon/lat (supported CRS), x/y in the raster CRS, or col/row."
},
"observer_height_m": {
"type": "number",
"minimum": 0,
"maximum": 2000,
"default": 1.7,
"description": "Eye height above ground."
},
"target_height_m": {
"type": "number",
"minimum": 0,
"maximum": 2000,
"default": 0,
"description": "Height above ground of the evaluated cells and of targets without height_m."
},
"max_distance_m": {
"type": "number",
"minimum": 1,
"maximum": 200000,
"description": "Radius of the analysis; default the whole raster."
},
"curvature": {
"type": "boolean",
"default": true,
"description": "Apply earth curvature and refraction."
},
"refraction_coefficient": {
"type": "number",
"minimum": 0,
"maximum": 1,
"default": 0.13
},
"targets": {
"type": "array",
"maxItems": 200,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"lon": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"x": {
"type": "number",
"description": "X in the raster CRS."
},
"y": {
"type": "number",
"description": "Y in the raster CRS."
},
"col": {
"type": "integer",
"minimum": 0
},
"row": {
"type": "integer",
"minimum": 0
},
"id": {
"type": "string",
"maxLength": 100
},
"height_m": {
"type": "number",
"minimum": 0,
"maximum": 2000
}
}
},
"description": "Points to test for visibility."
},
"output_raster": {
"type": "boolean",
"default": false,
"description": "Return a uint8 GeoTIFF (1 visible, 0 hidden, 255 outside/no data) of the analysis window."
}
}
}Published input example
{
"geotiff_base64": "SUkqACwBAACAAAAMghQKCQaCwOEweFQiHQ2IQyJQuKQ+JxaKxGMxeNRiPR2QRyRRuSR+RyaSyGUyeVSiXS2YSyZSuaS+ZzaazGczedTifT2gTyhTuiT+h0ai0Gk0elUinU2oUypUuqU+p1aq1Gs1etVivV2wVyxVuyV+x2ay2G02e1Wi3W24Wy5Wu6QJ4XW43i52+WXe+XrAX/BAC/XnB3vDYnC4jGYHE2zF47G4fJUnI5TMY/Ky/L5rM5PPTDO6DSZvQxzR6bS5/TanWa/T47XbHYavFarcbXW7nab3bbPbcHeZDh8XdW/gcbfcqecnj8vn83mdPo5bqdDsVzndnr8KP9vvdzq+PxeXw+fu+nyej1+rze72e/2/P5fX4/f4fn6fj9/r7P8/iFICDQAAAQMAAQAAACkAAAABAQMAAQAAACkAAAACAQMAAQAAACAAAAADAQMAAQAAAAUAAAAGAQMAAQAAAAEAAAARAQQAAQAAAAgAAAAWAQMAAQAAACkAAAAXAQQAAQAAACQBAAAcAQMAAQAAAAEAAABTAQMAAQAAAAMAAAAOgwwAAwAAAM4BAACChAwABgAAAOYBAACvhwMAFAAAABYCAAAAAAAAAAAAAAAAJEAAAAAAAAAkQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAICEHkEAAAAAECBWQQAAAAAAAAAAAQABAAAABAAABAAAAQABAAEEAAABAAEAAAwAAAEAeH8EDAAAAQApIw==",
"observer": {
"x": 500205,
"y": 5799795
},
"observer_height_m": 2,
"max_distance_m": 150,
"targets": [
{
"id": "mast",
"x": 500275,
"y": 5799795,
"height_m": 30
}
]
}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