Skip to content
HALOWERK

Bildwerk

floorplan areas

Grey plan; dark pixels (Otsu or wall_threshold) are walls; door gaps up to close_gaps_px are closed by morphological closing. Enclosed free areas (4-connected, not touching the border, at least 0.05 % of the image) are rooms; their area includes enclosed text and symbols, i.e. net area to the inner wall faces. Scale from meters_per_pixel, a reference line or 1:N with dpi. Room names via Tesseract 5.3.4 at the word centre.

POST https://bild.halowerk.com/v1/floorplan-areas

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
image_base64stringNoImage (PNG/JPEG/WebP/GIF/TIFF/AVIF) as base64, ≤ 10 MB.
image_urlstringNoOr a public image URL.
meters_per_pixelnumberNoScale in metres per pixel.
referenceobjectNoLine of known length (pixels, metres).
scale_denominatornumberNoPlan scale 1:N of a scan (with dpi).
dpinumberNoScan resolution.
wall_thresholdintegerNoWall below this grey value (default Otsu).
close_gaps_pxintegerNoClose door gaps up to this width (px).
min_room_m2numberNoDrop smaller rooms.
read_labelsbooleanNoOCR room names.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "image_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "Image (PNG/JPEG/WebP/GIF/TIFF/AVIF) as base64, ≤ 10 MB."
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Or a public image URL."
    },
    "meters_per_pixel": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100,
      "description": "Scale in metres per pixel."
    },
    "reference": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "x1",
        "y1",
        "x2",
        "y2",
        "length_m"
      ],
      "description": "Line of known length (pixels, metres).",
      "properties": {
        "x1": {
          "type": "number"
        },
        "y1": {
          "type": "number"
        },
        "x2": {
          "type": "number"
        },
        "y2": {
          "type": "number"
        },
        "length_m": {
          "type": "number",
          "exclusiveMinimum": 0
        }
      }
    },
    "scale_denominator": {
      "type": "number",
      "minimum": 1,
      "maximum": 100000,
      "description": "Plan scale 1:N of a scan (with dpi)."
    },
    "dpi": {
      "type": "number",
      "minimum": 30,
      "maximum": 4800,
      "description": "Scan resolution."
    },
    "wall_threshold": {
      "type": "integer",
      "minimum": 1,
      "maximum": 254,
      "description": "Wall below this grey value (default Otsu)."
    },
    "close_gaps_px": {
      "type": "integer",
      "minimum": 0,
      "maximum": 200,
      "default": 0,
      "description": "Close door gaps up to this width (px)."
    },
    "min_room_m2": {
      "type": "number",
      "minimum": 0,
      "maximum": 10000,
      "default": 1,
      "description": "Drop smaller rooms."
    },
    "read_labels": {
      "type": "boolean",
      "default": true,
      "description": "OCR room names."
    }
  }
}

Open original schema

Published input example

{
  "image_base64": "iVBORw0KGgoAAAANSUhEUgAAAKAAAABkAQMAAAA7eKnMAAAABlBMVEX///8AAABVwtN+AAAACXBIWXMAAAsTAAALEwEAmpwYAAAANklEQVRIiWNgGH7A/j8a+EO5oA3M8A9QGiQwKsgwGiAgMJoYoGA0d4wmBpuhnBjsaVB3DDcAAIj+7pmKUX4TAAAAAElFTkSuQmCC",
  "meters_per_pixel": 0.05,
  "read_labels": false
}

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 →