{"ok":true,"spec":"terrain-spec","version":1,"kind":"terrain","schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"terrain-spec v1","description":"Terreng på tomta i modellens lokale meter (x øst, y nord, z opp). Kobles til verden med site-spec georef.","type":"object","required":["spec","terrain"],"additionalProperties":false,"properties":{"spec":{"const":"terrain-spec"},"version":{"const":1},"name":{"type":"string"},"units":{"const":"m"},"terrain":{"type":"object","additionalProperties":false,"properties":{"origin":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2,"description":"[x, y] i meter: terrengflatens sørvestre hjørne i modellkoordinater. Standard [-10, -10]."},"size_m":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2,"description":"[bredde x, dybde y] i meter (minst 1). Standard [30, 25]."},"z":{"type":"number","description":"Høyde (meter, modellens z) i flatens midte. Standard 0."},"slope_x_pct":{"type":"number","minimum":-100,"maximum":100,"description":"Fall i x-retning, prosent (positivt = stiger mot øst)."},"slope_y_pct":{"type":"number","minimum":-100,"maximum":100,"description":"Fall i y-retning, prosent (positivt = stiger mot nord)."},"points":{"type":"array","maxItems":5000,"items":{"type":"array","items":{},"minItems":3,"maxItems":4},"description":"Høydepunkter [[x, y, z], …] i meter. Punkter nærmere enn 8 cm slås sammen. Fjerde element «rampe» merker en nedkjøring."},"zones":{"type":"array","maxItems":100,"items":{"type":"object","required":["boundary"],"properties":{"id":{"type":"string"},"boundary":{"type":"array","items":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2},"minItems":3},"z":{"type":"number"},"fall":{"type":"object","properties":{"retning":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2},"pct":{"type":"number"}}},"plan":{"type":"array","items":{"type":"array","items":{"type":"number"},"minItems":3,"maxItems":3},"minItems":3,"maxItems":3}}},"description":"Eksakte flater: ring (boundary) med enten konstant z, fall {retning [dx, dy], pct} eller plan (tre punkter [x, y, z])."},"breaklines":{"type":"array","maxItems":200,"items":{"type":"object","required":["path"],"properties":{"path":{"type":"array","items":{"type":"array","items":{"type":"number"},"minItems":3,"maxItems":3},"minItems":2},"type":{"enum":["myk","skarp"]}}},"description":"Bruddlinjer [{path: [[x, y, z], …], type: myk|skarp}]."},"holes":{"type":"array","items":{"type":"array","items":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2},"minItems":3},"description":"Utsparinger (plan-ringer) i terrenget, f.eks. kjeller."},"ramps":{"type":"array","items":{"type":"array","items":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2},"minItems":3},"description":"Nedkjøring/kjellernedgang (plan-ringer), regnes ikke med i gjennomsnittlig terreng."},"thickness_m":{"type":"number","exclusiveMinimum":0,"description":"Tykkelse på terrengblokka, meter. Standard 0,5."},"grid_m":{"type":"number","exclusiveMinimum":0,"description":"Maskevidde i meter. Standard 1."},"edge_display":{"enum":["soft","hard"],"description":"Kantvisning."},"source":{"type":"string","description":"Kilde for høydene (fritekst)."},"source_year":{"type":["string","integer"]},"source_text":{"type":"string"},"plates":{"description":"Valgfritt tilleggsobjekt (se /agent for utendørsverktøyene)."},"steps":{"description":"Valgfritt tilleggsobjekt (se /agent for utendørsverktøyene)."},"retaining_walls":{"description":"Valgfritt tilleggsobjekt (se /agent for utendørsverktøyene)."},"outdoor_stairs":{"description":"Valgfritt tilleggsobjekt (se /agent for utendørsverktøyene)."},"outdoor_fences":{"description":"Valgfritt tilleggsobjekt (se /agent for utendørsverktøyene)."},"drain_points":{"description":"Valgfritt tilleggsobjekt (se /agent for utendørsverktøyene)."},"pipes":{"description":"Valgfritt tilleggsobjekt (se /agent for utendørsverktøyene)."},"outdoor_downpipes":{"description":"Valgfritt tilleggsobjekt (se /agent for utendørsverktøyene)."},"cables":{"description":"Valgfritt tilleggsobjekt (se /agent for utendørsverktøyene)."},"cable_conduits":{"description":"Valgfritt tilleggsobjekt (se /agent for utendørsverktøyene)."},"cable_points":{"description":"Valgfritt tilleggsobjekt (se /agent for utendørsverktøyene)."},"trenches":{"description":"Valgfritt tilleggsobjekt (se /agent for utendørsverktøyene)."},"surfaces":{"description":"Valgfritt tilleggsobjekt (se /agent for utendørsverktøyene)."},"surface_zones":{"description":"Valgfritt tilleggsobjekt (se /agent for utendørsverktøyene)."},"cuts":{"description":"Valgfritt tilleggsobjekt (se /agent for utendørsverktøyene)."},"foundation_band":{"description":"Valgfritt tilleggsobjekt (se /agent for utendørsverktøyene)."}}}}},"examples":{"lite":{"spec":"terrain-spec","version":1,"name":"Terreng lite","units":"m","terrain":{"origin":[-10,-10],"size_m":[30,25],"z":0.0,"slope_y_pct":5}},"realistisk":{"spec":"terrain-spec","version":1,"name":"Terreng med målepunkter","units":"m","terrain":{"origin":[-12,-12],"size_m":[34,30],"z":0.0,"slope_x_pct":2,"slope_y_pct":6,"points":[[-12,-12,-0.9],[22,-12,-0.2],[22,18,1.6],[-12,18,0.9],[5,3,0.1],[0,8,0.4]],"zones":[{"id":"plate","boundary":[[-1,-1],[9,-1],[9,7],[-1,7]],"z":0.0}],"breaklines":[{"path":[[-12,10,0.3],[22,10,1.0]],"type":"myk"}],"source":"Eksempel (påfunnet målt terreng)","source_year":"2026"}}},"units":"m","validate":"https://draw.dibrix.com/spec/validate","schema_url":"https://draw.dibrix.com/spec/terrain/schema","usage":["Alt er meter og grader. Modellens lokale koordinater: x øst, y nord, z opp fra modellens null. Verdenskoordinater (site.georef) er [nord, øst] i EPSG:25832/25833/25835 (standard 25832).","Tre dokumenter: hus-spec (bygget), site-spec (eiendom/tomt: georef og plankrav) og terrain-spec (terreng). Site og terreng er også feltene `site` og `terrain` i hus-spec: send dem hver for seg eller slått sammen.","Valider først: POST /spec/validate {kind?: house|site|terrain, spec: {...}} (åpent, lagrer ingenting). Feilene har path, problem, expected og suggestion.","Send resultatet tilbake: POST /sessions/{sid}/spec (nøkkel eller innlogging) eller, uten innlogging, POST /configurator/sandbox/session/{sid}/spec i en sandkasseøkt (maks 400 elementer; én eller flere spec-dokumenter: {specs: [hus, site, terreng]}).","Kan du ikke sende (ingen utgående nett)? Gi JSON-en til brukeren i én kodeblokk: de limer den inn på /spec/proev (åpen side, ingen innlogging) og får validering, rettet forslag og modell-lenke.","Ingen adresse, gnr/bnr eller personopplysninger i en spec. Bruk påfunnede koordinater i eksempler og tester."]}