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.
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.
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 -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.detailswhen present. Node prints each issue. cURL returns the JSON body. Eachpathpoints 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.
401or403- 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-Afterinterval when supplied before trying again. - Lost response,
409or503 - 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_IDto 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'</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'</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'</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'</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
scanRequiredCaller-supplied Room Studio normalized scan v1. No device capture or snapping occurs.
scan.schemaVersionRequiredscan.unitsRequiredscan.sourceRequiredscan.capturedAtRequiredUTC capture timestamp, with optional millisecond precision.
Format: date-timescan.roomsRequiredOne to four rooms in a shared world coordinate system.
Min items 1 · Max items 4scan.rooms[].idRequiredStable identifier within the plan.
Min length 1 · Max length 32scan.rooms[].labelRequiredPrintable room or fixture label (up to 40 ASCII characters).
Min length 1 · Max length 40scan.rooms[].heightRequiredRoom ceiling height.
Min 0.1 · Max 30scan.rooms[].wallsRequiredSimple closed counterclockwise wall loop. Consecutive endpoints must meet.
Min items 3 · Max items 24scan.rooms[].walls[].idRequiredStable identifier within the plan.
Min length 1 · Max length 32scan.rooms[].walls[].startRequiredWorld-space [x, y], in meters; positive y points north.
Min items 2 · Max items 2scan.rooms[].walls[].endRequiredWorld-space [x, y], in meters; positive y points north.
Min items 2 · Max items 2scan.rooms[].walls[].thicknessRequiredWall band thickness.
Min 0.01 · Max 2scan.rooms[].walls[].heightRequiredWall height.
Min 0.1 · Max 30scan.rooms[].walls[].confidenceRequiredscan.rooms[].openingsRequiredDoors, windows and passages.
Min items 0 · Max items 24scan.rooms[].openings[].idRequiredStable identifier within the plan.
Min length 1 · Max length 32scan.rooms[].openings[].typeRequiredscan.rooms[].openings[].wallIdRequiredStable identifier within the plan.
Min length 1 · Max length 32scan.rooms[].openings[].offsetRequiredDistance from the start of its host wall.
Min 0 · Max 1000scan.rooms[].openings[].widthRequiredOpening span along the wall.
Min 0.01 · Max 1000scan.rooms[].openings[].heightRequiredOpening height.
Min 0.01 · Max 30scan.rooms[].openings[].sillHeightRequiredClearance above the floor.
Min 0 · Max 30scan.rooms[].fixturesRequiredMeasured fixture footprints.
Min items 0 · Max items 24scan.rooms[].fixtures[].idRequiredStable identifier within the plan.
Min length 1 · Max length 32scan.rooms[].fixtures[].categoryRequiredPrintable room or fixture label (up to 40 ASCII characters).
Min length 1 · Max length 40scan.rooms[].fixtures[].footprintRequired[width, depth], meters.
Min items 2 · Max items 2scan.rooms[].fixtures[].positionRequiredWorld-space [x, y], in meters; positive y points north.
Min items 2 · Max items 2scan.rooms[].fixtures[].rotationRequiredCounterclockwise rotation of the fixture footprint.
Min -360 · Max 360scan.rooms[].loopClosedRequiredscan.rooms[].nonManhattanRequiredscan.adjacencyRequiredExisting adjacency records.
Min items 0 · Max items 6scan.adjacency[].roomIdARequiredStable identifier within the plan.
Min length 1 · Max length 32scan.adjacency[].roomIdBRequiredStable identifier within the plan.
Min length 1 · Max length 32scan.adjacency[].sharedWallIdsRequiredWall identifiers in either adjacent room.
Min items 0 · Max items 24scan.calibrationRequiredscan.snapReportRequiredunitSystemOptionalDisplay 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