Skip to content
HALOWERK

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/viewshed

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
geotiff_base64stringNoGeoTIFF file, base64 (uncompressed, LZW, Deflate or PackBits; strips or tiles; 8–64 bit).
geotiff_urlstringNoAlternative: public http(s) URL of a GeoTIFF up to 12 MB (downloaded once per call).
bandintegerNoBand number (1-based).
observerobjectYesObserver position: lon/lat (supported CRS), x/y in the raster CRS, or col/row.
observer_height_mnumberNoEye height above ground.
target_height_mnumberNoHeight above ground of the evaluated cells and of targets without height_m.
max_distance_mnumberNoRadius of the analysis; default the whole raster.
curvaturebooleanNoApply earth curvature and refraction.
refraction_coefficientnumberNo
targetsarrayNoPoints to test for visibility.
output_rasterbooleanNoReturn 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."
    }
  }
}

Open original schema

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

All endpoints in this hub →