Skip to content

Room Studio · Calculation

Dimensioned floor plan

Draw caller-supplied normalized Room Studio geometry, including wall thickness, hosted openings and rotated fixtures. Returns the print SVG, wall lengths and area for each room. The same asset is used for the floor-plan PDF.

Related HT Calc tool: Renovation Planner

Room Studio has no public screen on htcalc.com. Its renovation handoff uses this planner for project costs. This HT Calc screen includes a Plus sample for visitors.

Example result · assetType: image/svg+xml See output

Cost per success
1 calculation credit
Production plans
Standard, Business, Scale, Enterprise
Plan allowances
Free sandbox
Not available

Integration example

Make a request

Use a production key scoped to room-floor-plan.

Keep the key on your server. A successful call uses 1 calculation credit.

Production request

Set HT_PRODUCTION_KEY on your server. Save as example.mjs and run node example.mjs with Node.js 18 or later.

import { randomUUID } from "node:crypto";

const key = process.env.HT_PRODUCTION_KEY;
if (!key) throw new Error("Set HT_PRODUCTION_KEY on your server.");
const endpoint = "https://calc.hasstechapi.com/v2/calc/room-floor-plan";
const input = {
  "scan": {
    "schemaVersion": 1,
    "units": "m",
    "source": "manual",
    "capturedAt": "2026-07-20T00:00:00.000Z",
    "rooms": [
      {
        "id": "room-golden",
        "label": "Living Room",
        "height": 2.4384,
        "walls": [
          {
            "id": "w1",
            "start": [
              0,
              0
            ],
            "end": [
              3.6576,
              0
            ],
            "thickness": 0.16,
            "height": 2.4384,
            "confidence": "high"
          },
          {
            "id": "w2",
            "start": [
              3.6576,
              0
            ],
            "end": [
              3.6576,
              3.048
            ],
            "thickness": 0.16,
            "height": 2.4384,
            "confidence": "high"
          },
          {
            "id": "w3",
            "start": [
              3.6576,
              3.048
            ],
            "end": [
              0,
              3.048
            ],
            "thickness": 0.16,
            "height": 2.4384,
            "confidence": "high"
          },
          {
            "id": "w4",
            "start": [
              0,
              3.048
            ],
            "end": [
              0,
              0
            ],
            "thickness": 0.16,
            "height": 2.4384,
            "confidence": "high"
          }
        ],
        "openings": [
          {
            "id": "o1",
            "type": "door",
            "wallId": "w1",
            "offset": 0.3048,
            "width": 0.9144,
            "height": 2.033016,
            "sillHeight": 0
          },
          {
            "id": "o2",
            "type": "window",
            "wallId": "w2",
            "offset": 0.6096,
            "width": 1.2192,
            "height": 0.9144,
            "sillHeight": 0.9144
          },
          {
            "id": "o3",
            "type": "opening",
            "wallId": "w3",
            "offset": 1.9,
            "width": 0.8,
            "height": 2.05,
            "sillHeight": 0
          }
        ],
        "fixtures": [
          {
            "id": "f1",
            "category": "sofa",
            "position": [
              0.82,
              2.28
            ],
            "footprint": [
              1.2,
              0.65
            ],
            "rotation": 25
          }
        ],
        "loopClosed": true,
        "nonManhattan": false
      }
    ],
    "adjacency": [],
    "calibration": null,
    "snapReport": null
  },
  "unitSystem": "imperial"
};
const requestId = process.env.HT_REQUEST_ID || Date.now() + "." + randomUUID();
// Keep this ID to look up usage if the connection is interrupted.
console.error("Usage lookup ID:", requestId);

const response = await fetch(endpoint, {
  method: "POST",
  redirect: "error",
  headers: {
    "Authorization": "Bearer " + key,
    "Content-Type": "application/json",
    "Idempotency-Key": requestId
  },
  body: JSON.stringify(input)
});
if (!response.ok) {
  const problem = await response.json().catch(() => null);
  const code = problem?.error?.code || response.statusText;
  const delay = response.headers.get("retry-after");
  if (delay) console.error("Retry-After (seconds):", delay);
  console.error("HTTP " + response.status + " " + code + ". Usage lookup ID: " + requestId);
  if (Array.isArray(problem?.error?.details)) {
    for (const issue of problem.error.details) console.error("Input issue:", JSON.stringify(issue));
  }
  process.exitCode = 1;
} else {
  console.log(JSON.stringify(await response.json(), null, 2));
}
cURL (shell)

Set HT_PRODUCTION_KEY on your server. Run in a POSIX shell with cURL 7.76+ and Python 3.7+ to create a request ID.

(
  set -eu
  : "${HT_PRODUCTION_KEY:?Set HT_PRODUCTION_KEY on your server}"
  request_id="${HT_REQUEST_ID:-}"
  if [ -z "$request_id" ]; then
    request_id=$(python3 -c 'import time, uuid; print(str(time.time_ns() // 1000000) + "." + str(uuid.uuid4()))')
  fi
  printf 'Usage lookup ID: %s\n' "$request_id" >&2
  # On INVALID_INPUT, read error.details in the JSON response body.
  curl --disable --silent --show-error --fail-with-body --include \
    --request POST 'https://calc.hasstechapi.com/v2/calc/room-floor-plan' \
    --header "Authorization: Bearer $HT_PRODUCTION_KEY" \
    --header 'Content-Type: application/json' \
    --header "Idempotency-Key: $request_id" \
    --data-binary @- <<'HT_INPUT'
{
  "scan": {
    "schemaVersion": 1,
    "units": "m",
    "source": "manual",
    "capturedAt": "2026-07-20T00:00:00.000Z",
    "rooms": [
      {
        "id": "room-golden",
        "label": "Living Room",
        "height": 2.4384,
        "walls": [
          {
            "id": "w1",
            "start": [
              0,
              0
            ],
            "end": [
              3.6576,
              0
            ],
            "thickness": 0.16,
            "height": 2.4384,
            "confidence": "high"
          },
          {
            "id": "w2",
            "start": [
              3.6576,
              0
            ],
            "end": [
              3.6576,
              3.048
            ],
            "thickness": 0.16,
            "height": 2.4384,
            "confidence": "high"
          },
          {
            "id": "w3",
            "start": [
              3.6576,
              3.048
            ],
            "end": [
              0,
              3.048
            ],
            "thickness": 0.16,
            "height": 2.4384,
            "confidence": "high"
          },
          {
            "id": "w4",
            "start": [
              0,
              3.048
            ],
            "end": [
              0,
              0
            ],
            "thickness": 0.16,
            "height": 2.4384,
            "confidence": "high"
          }
        ],
        "openings": [
          {
            "id": "o1",
            "type": "door",
            "wallId": "w1",
            "offset": 0.3048,
            "width": 0.9144,
            "height": 2.033016,
            "sillHeight": 0
          },
          {
            "id": "o2",
            "type": "window",
            "wallId": "w2",
            "offset": 0.6096,
            "width": 1.2192,
            "height": 0.9144,
            "sillHeight": 0.9144
          },
          {
            "id": "o3",
            "type": "opening",
            "wallId": "w3",
            "offset": 1.9,
            "width": 0.8,
            "height": 2.05,
            "sillHeight": 0
          }
        ],
        "fixtures": [
          {
            "id": "f1",
            "category": "sofa",
            "position": [
              0.82,
              2.28
            ],
            "footprint": [
              1.2,
              0.65
            ],
            "rotation": 25
          }
        ],
        "loopClosed": true,
        "nonManhattan": false
      }
    ],
    "adjacency": [],
    "calibration": null,
    "snapReport": null
  },
  "unitSystem": "imperial"
}
HT_INPUT
)
If your request fails
400 INVALID_INPUT

Read error.details when present. Node prints each issue. cURL returns the JSON body. Each path points into your request. An empty path refers to the whole body.

Check the accepted inputs for required fields, units and ranges. Send the corrected JSON as a new request.

401 or 403
Check that the server has the bearer key for the endpoint’s environment and that the key includes room-floor-plan.
429
Read the service error code, check your allowance, and wait for the Retry-After interval when supplied before trying again.
Lost response, 409 or 503
Open Request lookup, select the same environment and enter the printed usage lookup ID. A settled ID has already consumed credits. To retry the same calculation, set HT_REQUEST_ID to the original ID and reuse the same inputs. A settled request does not return its result again. Unset the variable for a new request, which can consume credits.

The usage lookup ID is the Idempotency-Key your server sends. The response’s x-request-id identifies the HTTP exchange for support.

Output

Example result

These values come from running this operation on the example inputs.

assetType
image/svg+xml
width
510 px
height
472.45 px

Result warnings

  • Sketch-grade, not survey-grade — typical accuracy ±1–2%. Not for permits or surveys.
How to interpret this result
  • Normalized meters in a shared plan coordinate system. Dimension labels appear on walls at least 0.5 m long. Area labels use square feet in both display modes.
Full example response (JSON)
{
  "status": "available",
  "result": {
    "assetType": "image/svg+xml",
    "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 510 472.45\" width=\"510\" height=\"472.45\" role=\"img\" aria-label=\"Floor plan of Living Room\"><title>Floor plan of Living Room</title><rect x=\"0\" y=\"0\" width=\"510\" height=\"472.45\" fill=\"#fbfbfc\" /><g class=\"ht-room\" data-room=\"room-golden\"><polygon points=\"64.34,382.11 445.66,382.11 445.66,64.34 64.34,64.34\" fill=\"#fbfbfc\" stroke=\"none\" /><polygon points=\"56,373.77 454,373.77 454,390.45 56,390.45\" fill=\"#1a1a1a\" stroke=\"#1a1a1a\" stroke-width=\"1\" stroke-linejoin=\"miter\" /><polygon points=\"437.32,390.45 437.32,56 454,56 454,390.45\" fill=\"#1a1a1a\" stroke=\"#1a1a1a\" stroke-width=\"1\" stroke-linejoin=\"miter\" /><polygon points=\"454,72.68 56,72.68 56,56 454,56\" fill=\"#1a1a1a\" stroke=\"#1a1a1a\" stroke-width=\"1\" stroke-linejoin=\"miter\" /><polygon points=\"72.68,56 72.68,390.45 56,390.45 56,56\" fill=\"#1a1a1a\" stroke=\"#1a1a1a\" stroke-width=\"1\" stroke-linejoin=\"miter\" /><polygon points=\"96.12,373.24 191.45,373.24 191.45,390.97 96.12,390.97\" fill=\"#fbfbfc\" stroke=\"none\" data-opening=\"o1\" /><path class=\"ht-door-swing\" d=\"M191.45 382.11 L190.99 372.76 L189.62 363.51 L187.34 354.43 L184.19 345.63 L180.19 337.17 L175.38 329.14 L169.81 321.63 L163.53 314.7 L156.59 308.42 L149.08 302.84 L141.06 298.03 L132.6 294.03 L123.79 290.88 L114.71 288.61 L105.46 287.24 L96.12 286.78\" fill=\"none\" stroke=\"#1a1a1a\" stroke-width=\"1.25\" stroke-dasharray=\"4 3\" /><line x1=\"96.12\" y1=\"382.11\" x2=\"96.12\" y2=\"286.78\" stroke=\"#1a1a1a\" stroke-width=\"2\" stroke-linecap=\"round\" /><polygon points=\"436.8,318.55 436.8,191.45 454.52,191.45 454.52,318.55\" fill=\"#fbfbfc\" stroke=\"none\" data-opening=\"o2\" /><line class=\"ht-window-glyph\" x1=\"454.52\" y1=\"318.55\" x2=\"454.52\" y2=\"191.45\" stroke=\"#1a1a1a\" stroke-width=\"1.25\" /><line class=\"ht-window-glyph\" x1=\"445.66\" y1=\"318.55\" x2=\"445.66\" y2=\"191.45\" stroke=\"#1a1a1a\" stroke-width=\"1.25\" /><line class=\"ht-window-glyph\" x1=\"436.8\" y1=\"318.55\" x2=\"436.8\" y2=\"191.45\" stroke=\"#1a1a1a\" stroke-width=\"1.25\" /><polygon points=\"247.58,73.2 164.17,73.2 164.17,55.48 247.58,55.48\" fill=\"#fbfbfc\" stroke=\"none\" data-opening=\"o3\" /><line x1=\"247.58\" y1=\"73.2\" x2=\"247.58\" y2=\"55.48\" stroke=\"#1a1a1a\" stroke-width=\"1.25\" stroke-dasharray=\"3 3\" /><line x1=\"164.17\" y1=\"73.2\" x2=\"164.17\" y2=\"55.48\" stroke=\"#1a1a1a\" stroke-width=\"1.25\" stroke-dasharray=\"3 3\" /><g transform=\"translate(149.83 144.41) rotate(-25)\" data-fixture=\"f1\"><rect x=\"-62.55\" y=\"-33.88\" width=\"125.1\" height=\"67.77\" rx=\"3\" fill=\"#fbfbfc\" stroke=\"#4a4a4a\" stroke-width=\"1.5\" /><text x=\"0\" y=\"3\" text-anchor=\"middle\" font-family=\"system-ui, sans-serif\" font-size=\"9\" fill=\"#4a4a4a\">S</text></g><text class=\"ht-dimension\" x=\"255\" y=\"398.11\" transform=\"rotate(0 255 398.11)\" text-anchor=\"middle\" dominant-baseline=\"middle\" font-family=\"system-ui, sans-serif\" font-size=\"11\" fill=\"#4a4a4a\">12&apos;</text><text class=\"ht-dimension\" x=\"461.66\" y=\"223.22\" transform=\"rotate(90 461.66 223.22)\" text-anchor=\"middle\" dominant-baseline=\"middle\" font-family=\"system-ui, sans-serif\" font-size=\"11\" fill=\"#4a4a4a\">10&apos;</text><text class=\"ht-dimension\" x=\"255\" y=\"48.34\" transform=\"rotate(360 255 48.34)\" text-anchor=\"middle\" dominant-baseline=\"middle\" font-family=\"system-ui, sans-serif\" font-size=\"11\" fill=\"#4a4a4a\">12&apos;</text><text class=\"ht-dimension\" x=\"48.34\" y=\"223.22\" transform=\"rotate(90 48.34 223.22)\" text-anchor=\"middle\" dominant-baseline=\"middle\" font-family=\"system-ui, sans-serif\" font-size=\"11\" fill=\"#4a4a4a\">10&apos;</text><text class=\"ht-room-label\" x=\"255\" y=\"223.22\" text-anchor=\"middle\" font-family=\"system-ui, sans-serif\" font-size=\"14\" font-weight=\"600\" fill=\"#111111\">Living Room</text><text class=\"ht-room-area\" x=\"255\" y=\"239.22\" text-anchor=\"middle\" font-family=\"system-ui, sans-serif\" font-size=\"11\" fill=\"#4a4a4a\">120 sq ft</text></g><text class=\"ht-disclaimer\" x=\"255\" y=\"463.45\" text-anchor=\"middle\" font-family=\"system-ui, sans-serif\" font-size=\"10\" fill=\"#4a4a4a\">Sketch-grade, not survey-grade — typical accuracy ±1–2%. Not for permits or surveys.</text></svg>",
    "width": 510,
    "height": 472.45,
    "rooms": [
      {
        "id": "room-golden",
        "label": "Living Room",
        "floorAreaSqft": 120,
        "walls": [
          {
            "id": "w1",
            "lengthM": 3.6576
          },
          {
            "id": "w2",
            "lengthM": 3.048
          },
          {
            "id": "w3",
            "lengthM": 3.6576
          },
          {
            "id": "w4",
            "lengthM": 3.048
          }
        ],
        "openings": 3,
        "fixtures": 1
      }
    ]
  },
  "formulaVersion": "room-floor-plan-htcalc-719df2c0e105-v1",
  "units": {
    "svg": "image/svg+xml",
    "width": "px",
    "height": "px",
    "rooms[].floorAreaSqft": "ft²",
    "rooms[].walls[].lengthM": "m"
  },
  "assumptions": [
    "Normalized meters in a shared plan coordinate system. Dimension labels appear on walls at least 0.5 m long. Area labels use square feet in both display modes."
  ],
  "warnings": [
    "Sketch-grade, not survey-grade — typical accuracy ±1–2%. Not for permits or surveys."
  ],
  "creditCost": 1
}

Request contract

Accepted inputs

Fields for this example. Expand the schema for all supported combinations and limits.

FieldType, units and limits

scanRequired
object

Caller-supplied Room Studio normalized scan v1. No device capture or snapping occurs.

scan.schemaVersionRequired
integerMust equal 1
scan.unitsRequired
stringMust equal "m"
scan.sourceRequired
stringAllowed: "manual", "lidar", "manual_entry", "roomplan_ios"
scan.capturedAtRequired
string

UTC capture timestamp, with optional millisecond precision.

Format: date-time
scan.roomsRequired
array

One to four rooms in a shared world coordinate system.

Min items 1 · Max items 4
scan.rooms[].idRequired
string

Stable identifier within the plan.

Min length 1 · Max length 32
scan.rooms[].labelRequired
string

Printable room or fixture label (up to 40 ASCII characters).

Min length 1 · Max length 40
scan.rooms[].heightRequired
number · m

Room ceiling height.

Min 0.1 · Max 30
scan.rooms[].wallsRequired
array

Simple closed counterclockwise wall loop. Consecutive endpoints must meet.

Min items 3 · Max items 24
scan.rooms[].walls[].idRequired
string

Stable identifier within the plan.

Min length 1 · Max length 32
scan.rooms[].walls[].startRequired
array

World-space [x, y], in meters; positive y points north.

Min items 2 · Max items 2
scan.rooms[].walls[].endRequired
array

World-space [x, y], in meters; positive y points north.

Min items 2 · Max items 2
scan.rooms[].walls[].thicknessRequired
number · m

Wall band thickness.

Min 0.01 · Max 2
scan.rooms[].walls[].heightRequired
number · m

Wall height.

Min 0.1 · Max 30
scan.rooms[].walls[].confidenceRequired
stringAllowed: "low", "medium", "high"
scan.rooms[].openingsRequired
array

Doors, windows and passages.

Min items 0 · Max items 24
scan.rooms[].openings[].idRequired
string

Stable identifier within the plan.

Min length 1 · Max length 32
scan.rooms[].openings[].typeRequired
stringAllowed: "door", "window", "opening"
scan.rooms[].openings[].wallIdRequired
string

Stable identifier within the plan.

Min length 1 · Max length 32
scan.rooms[].openings[].offsetRequired
number · m

Distance from the start of its host wall.

Min 0 · Max 1000
scan.rooms[].openings[].widthRequired
number · m

Opening span along the wall.

Min 0.01 · Max 1000
scan.rooms[].openings[].heightRequired
number · m

Opening height.

Min 0.01 · Max 30
scan.rooms[].openings[].sillHeightRequired
number · m

Clearance above the floor.

Min 0 · Max 30
scan.rooms[].fixturesRequired
array

Measured fixture footprints.

Min items 0 · Max items 24
scan.rooms[].fixtures[].idRequired
string

Stable identifier within the plan.

Min length 1 · Max length 32
scan.rooms[].fixtures[].categoryRequired
string

Printable room or fixture label (up to 40 ASCII characters).

Min length 1 · Max length 40
scan.rooms[].fixtures[].footprintRequired
array

[width, depth], meters.

Min items 2 · Max items 2
scan.rooms[].fixtures[].positionRequired
array

World-space [x, y], in meters; positive y points north.

Min items 2 · Max items 2
scan.rooms[].fixtures[].rotationRequired
number · degrees

Counterclockwise rotation of the fixture footprint.

Min -360 · Max 360
scan.rooms[].loopClosedRequired
booleanMust equal true
scan.rooms[].nonManhattanRequired
boolean
scan.adjacencyRequired
array

Existing adjacency records.

Min items 0 · Max items 6
scan.adjacency[].roomIdARequired
string

Stable identifier within the plan.

Min length 1 · Max length 32
scan.adjacency[].roomIdBRequired
string

Stable identifier within the plan.

Min length 1 · Max length 32
scan.adjacency[].sharedWallIdsRequired
array

Wall identifiers in either adjacent room.

Min items 0 · Max items 24
scan.calibrationRequired
object or null
scan.snapReportRequired
object or null
unitSystemOptional
string

Display lengths in feet and inches (default) or meters. Source area labels use square feet.

Allowed: "imperial", "metric"
Example request body (JSON)
{
  "scan": {
    "schemaVersion": 1,
    "units": "m",
    "source": "manual",
    "capturedAt": "2026-07-20T00:00:00.000Z",
    "rooms": [
      {
        "id": "room-golden",
        "label": "Living Room",
        "height": 2.4384,
        "walls": [
          {
            "id": "w1",
            "start": [
              0,
              0
            ],
            "end": [
              3.6576,
              0
            ],
            "thickness": 0.16,
            "height": 2.4384,
            "confidence": "high"
          },
          {
            "id": "w2",
            "start": [
              3.6576,
              0
            ],
            "end": [
              3.6576,
              3.048
            ],
            "thickness": 0.16,
            "height": 2.4384,
            "confidence": "high"
          },
          {
            "id": "w3",
            "start": [
              3.6576,
              3.048
            ],
            "end": [
              0,
              3.048
            ],
            "thickness": 0.16,
            "height": 2.4384,
            "confidence": "high"
          },
          {
            "id": "w4",
            "start": [
              0,
              3.048
            ],
            "end": [
              0,
              0
            ],
            "thickness": 0.16,
            "height": 2.4384,
            "confidence": "high"
          }
        ],
        "openings": [
          {
            "id": "o1",
            "type": "door",
            "wallId": "w1",
            "offset": 0.3048,
            "width": 0.9144,
            "height": 2.033016,
            "sillHeight": 0
          },
          {
            "id": "o2",
            "type": "window",
            "wallId": "w2",
            "offset": 0.6096,
            "width": 1.2192,
            "height": 0.9144,
            "sillHeight": 0.9144
          },
          {
            "id": "o3",
            "type": "opening",
            "wallId": "w3",
            "offset": 1.9,
            "width": 0.8,
            "height": 2.05,
            "sillHeight": 0
          }
        ],
        "fixtures": [
          {
            "id": "f1",
            "category": "sofa",
            "position": [
              0.82,
              2.28
            ],
            "footprint": [
              1.2,
              0.65
            ],
            "rotation": 25
          }
        ],
        "loopClosed": true,
        "nonManhattan": false
      }
    ],
    "adjacency": [],
    "calibration": null,
    "snapReport": null
  },
  "unitSystem": "imperial"
}
Full JSON schema
{
  "type": "object",
  "properties": {
    "scan": {
      "type": "object",
      "properties": {
        "schemaVersion": {
          "type": "integer",
          "const": 1
        },
        "units": {
          "type": "string",
          "const": "m"
        },
        "source": {
          "type": "string",
          "enum": [
            "manual",
            "lidar",
            "manual_entry",
            "roomplan_ios"
          ]
        },
        "capturedAt": {
          "type": "string",
          "format": "date-time",
          "description": "UTC capture timestamp, with optional millisecond precision."
        },
        "rooms": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 32,
                "pattern": "^[A-Za-z0-9_-]+$",
                "description": "Stable identifier within the plan."
              },
              "label": {
                "type": "string",
                "minLength": 1,
                "maxLength": 40,
                "pattern": "^[ -~]+$",
                "description": "Printable room or fixture label (up to 40 ASCII characters)."
              },
              "height": {
                "type": "number",
                "minimum": 0.1,
                "maximum": 30,
                "x-unit": "m",
                "description": "Room ceiling height."
              },
              "walls": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 32,
                      "pattern": "^[A-Za-z0-9_-]+$",
                      "description": "Stable identifier within the plan."
                    },
                    "start": {
                      "type": "array",
                      "items": {
                        "type": "number",
                        "minimum": -1000,
                        "maximum": 1000,
                        "x-unit": "m",
                        "description": "World coordinate."
                      },
                      "minItems": 2,
                      "maxItems": 2,
                      "description": "World-space [x, y], in meters; positive y points north."
                    },
                    "end": {
                      "type": "array",
                      "items": {
                        "type": "number",
                        "minimum": -1000,
                        "maximum": 1000,
                        "x-unit": "m",
                        "description": "World coordinate."
                      },
                      "minItems": 2,
                      "maxItems": 2,
                      "description": "World-space [x, y], in meters; positive y points north."
                    },
                    "thickness": {
                      "type": "number",
                      "minimum": 0.01,
                      "maximum": 2,
                      "x-unit": "m",
                      "description": "Wall band thickness."
                    },
                    "height": {
                      "type": "number",
                      "minimum": 0.1,
                      "maximum": 30,
                      "x-unit": "m",
                      "description": "Wall height."
                    },
                    "confidence": {
                      "type": "string",
                      "enum": [
                        "low",
                        "medium",
                        "high"
                      ]
                    }
                  },
                  "required": [
                    "id",
                    "start",
                    "end",
                    "thickness",
                    "height",
                    "confidence"
                  ],
                  "additionalProperties": false,
                  "description": "One measured wall in the ordered counterclockwise boundary."
                },
                "minItems": 3,
                "maxItems": 24,
                "description": "Simple closed counterclockwise wall loop. Consecutive endpoints must meet."
              },
              "openings": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 32,
                      "pattern": "^[A-Za-z0-9_-]+$",
                      "description": "Stable identifier within the plan."
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "door",
                        "window",
                        "opening"
                      ]
                    },
                    "wallId": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 32,
                      "pattern": "^[A-Za-z0-9_-]+$",
                      "description": "Stable identifier within the plan."
                    },
                    "offset": {
                      "type": "number",
                      "minimum": 0,
                      "maximum": 1000,
                      "x-unit": "m",
                      "description": "Distance from the start of its host wall."
                    },
                    "width": {
                      "type": "number",
                      "minimum": 0.01,
                      "maximum": 1000,
                      "x-unit": "m",
                      "description": "Opening span along the wall."
                    },
                    "height": {
                      "type": "number",
                      "minimum": 0.01,
                      "maximum": 30,
                      "x-unit": "m",
                      "description": "Opening height."
                    },
                    "sillHeight": {
                      "type": "number",
                      "minimum": 0,
                      "maximum": 30,
                      "x-unit": "m",
                      "description": "Clearance above the floor."
                    }
                  },
                  "required": [
                    "id",
                    "type",
                    "wallId",
                    "offset",
                    "width",
                    "height",
                    "sillHeight"
                  ],
                  "additionalProperties": false,
                  "description": "Opening in its named host wall. Offset plus width must fit the wall."
                },
                "minItems": 0,
                "maxItems": 24,
                "description": "Doors, windows and passages."
              },
              "fixtures": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 32,
                      "pattern": "^[A-Za-z0-9_-]+$",
                      "description": "Stable identifier within the plan."
                    },
                    "category": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 40,
                      "pattern": "^[ -~]+$",
                      "description": "Printable room or fixture label (up to 40 ASCII characters)."
                    },
                    "footprint": {
                      "type": "array",
                      "items": {
                        "type": "number",
                        "minimum": 0.05,
                        "maximum": 100,
                        "x-unit": "m",
                        "description": "Footprint dimension."
                      },
                      "minItems": 2,
                      "maxItems": 2,
                      "description": "[width, depth], meters."
                    },
                    "position": {
                      "type": "array",
                      "items": {
                        "type": "number",
                        "minimum": -1000,
                        "maximum": 1000,
                        "x-unit": "m",
                        "description": "World coordinate."
                      },
                      "minItems": 2,
                      "maxItems": 2,
                      "description": "World-space [x, y], in meters; positive y points north."
                    },
                    "rotation": {
                      "type": "number",
                      "minimum": -360,
                      "maximum": 360,
                      "x-unit": "degrees",
                      "description": "Counterclockwise rotation of the fixture footprint."
                    }
                  },
                  "required": [
                    "id",
                    "category",
                    "footprint",
                    "position",
                    "rotation"
                  ],
                  "additionalProperties": false,
                  "description": "Placed and rotated fixture."
                },
                "minItems": 0,
                "maxItems": 24,
                "description": "Measured fixture footprints."
              },
              "loopClosed": {
                "type": "boolean",
                "const": true
              },
              "nonManhattan": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "label",
              "height",
              "walls",
              "openings",
              "fixtures",
              "loopClosed",
              "nonManhattan"
            ],
            "additionalProperties": false,
            "description": "Measured room with a nondegenerate boundary."
          },
          "minItems": 1,
          "maxItems": 4,
          "description": "One to four rooms in a shared world coordinate system."
        },
        "adjacency": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "roomIdA": {
                "type": "string",
                "minLength": 1,
                "maxLength": 32,
                "pattern": "^[A-Za-z0-9_-]+$",
                "description": "Stable identifier within the plan."
              },
              "roomIdB": {
                "type": "string",
                "minLength": 1,
                "maxLength": 32,
                "pattern": "^[A-Za-z0-9_-]+$",
                "description": "Stable identifier within the plan."
              },
              "sharedWallIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 32,
                  "pattern": "^[A-Za-z0-9_-]+$",
                  "description": "Stable identifier within the plan."
                },
                "minItems": 0,
                "maxItems": 24,
                "description": "Wall identifiers in either adjacent room."
              }
            },
            "required": [
              "roomIdA",
              "roomIdB",
              "sharedWallIds"
            ],
            "additionalProperties": false,
            "description": "Optional source adjacency record."
          },
          "minItems": 0,
          "maxItems": 6,
          "description": "Existing adjacency records."
        },
        "calibration": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "wallId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 32,
                  "pattern": "^[A-Za-z0-9_-]+$",
                  "description": "Stable identifier within the plan."
                },
                "measuredM": {
                  "type": "number",
                  "minimum": 0.001,
                  "maximum": 1000,
                  "x-unit": "m",
                  "description": "Original measurement."
                },
                "enteredM": {
                  "type": "number",
                  "minimum": 0.001,
                  "maximum": 1000,
                  "x-unit": "m",
                  "description": "User-entered measurement."
                },
                "scaleApplied": {
                  "type": "number",
                  "minimum": 0.001,
                  "maximum": 1000,
                  "x-unit": "ratio",
                  "description": "Already applied to the normalized coordinates."
                }
              },
              "required": [
                "wallId",
                "measuredM",
                "enteredM",
                "scaleApplied"
              ],
              "additionalProperties": false,
              "description": "Optional recorded calibration. Coordinates are already calibrated."
            },
            {
              "type": "null"
            }
          ]
        },
        "snapReport": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "wallsSnapped": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 1024
                },
                "wallsTotal": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 1024
                },
                "maxCorrectionDeg": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 360,
                  "x-unit": "degrees",
                  "description": "Maximum correction."
                },
                "dominantAxisDeg": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 90,
                  "x-unit": "degrees",
                  "description": "Dominant wall direction."
                },
                "closureResidualBeforeM": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1000,
                  "x-unit": "m",
                  "description": "Pre-snap closure residual."
                },
                "closureResidualAfterM": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1000,
                  "x-unit": "m",
                  "description": "Post-snap closure residual."
                },
                "weldedWallCount": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 1024
                }
              },
              "required": [
                "wallsSnapped",
                "wallsTotal",
                "maxCorrectionDeg",
                "dominantAxisDeg",
                "closureResidualBeforeM",
                "closureResidualAfterM",
                "weldedWallCount"
              ],
              "additionalProperties": false,
              "description": "Optional source snap record."
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "schemaVersion",
        "units",
        "source",
        "capturedAt",
        "rooms",
        "adjacency",
        "calibration",
        "snapReport"
      ],
      "additionalProperties": false,
      "description": "Caller-supplied Room Studio normalized scan v1. No device capture or snapping occurs."
    },
    "unitSystem": {
      "type": "string",
      "enum": [
        "imperial",
        "metric"
      ],
      "description": "Display lengths in feet and inches (default) or meters. Source area labels use square feet."
    }
  },
  "required": [
    "scan"
  ],
  "additionalProperties": false,
  "description": "Creates the dimensioned Room Studio print SVG. The maximum request body is 16 KiB. The print view must fit 510 by 6,000 source pixels (including its disclaimer)."
}

Production endpoint: POST https://calc.hasstechapi.com/v2/calc/room-floor-plan
Formula: room-floor-plan-htcalc-719df2c0e105-v1

Related PDF reports