Takplan

Endepunkt

GET /v1/projects/{projectId}/roof/svg

Returnerer en 2D-visualisering av takgeometrien som SVG, projisert fra GPS-koordinater. SVG-en inneholder rike dataattributter på hvert element for programmatisk tilgang. Alle numeriske dataattributter bruker centimeter (deklarert via data-units="cm" på rotelementet).

Merknad

Kun tilgjengelig for prosjekter med tilknyttet adresse. Returnerer 404 hvis prosjektet ikke har takgeometridata.

Attribusjon

Takdata leveres av © Norkart AS/Geovekst og kommunene. Attribusjonen er bygget inn i SVG-ens <metadata>-element.

Struktur

Elementer er gruppert hierarkisk: bygning → takflate → polygon, kanter, vertekser. Hver flates polygon, kantlinjer og verteksmarkører er pakket i en <g data-surface-id="..."> gruppe, slik at det er enkelt å identifisere hvilke elementer som hører sammen.

Dataattributter

Rotelement (<svg>)

Attributt	Beskrivelse
data-units	Enhet for alle numeriske dataattributter (cm)

Bygningsgruppe (<g>)

Attributt	Beskrivelse
data-building-id	Bygningsidentifikator
data-building-name	Visningsnavn (f.eks. «Bygning 1»)
data-surface-count	Antall takflater
data-total-area-3d	Totalt 3D-takareal i cm²

Flategruppe (<g>)

Attributt	Beskrivelse
data-surface-id	Flateidentifikator (grupperer polygon, kanter og vertekser for én flate)

Takflate (<path>)

Attributt	Beskrivelse
data-surface-id	Flateidentifikator
data-slope	Helning fra Norkart API i hele grader (gradianer)
data-direction	Retning fra Norkart API i hele grader (UTM sone 33-peiling)
data-calculated-slope	Sann helning i hele grader beregnet fra polygongeometri
data-calculated-direction	Sann kompassretning i hele grader beregnet fra polygongeometri
data-area-2d	2D-projisert areal i cm²
data-area-3d	3D-flateareal i cm²
data-perimeter	Omkrets i cm
data-min-altitude / data-max-altitude	Høydeintervall i cm
data-vertex-count	Antall polygonhjørner

Kantlinje (<line>)

Attributt	Beskrivelse
data-surface-id	Overordnet flateidentifikator
data-edge-index	Kantindeks i polygonet
data-length	3D-kantlengde i cm
data-direction	Kompassretning i hele grader
data-slope	Kantens helningsvinkel i hele grader
data-altitude-start / data-altitude-end	Vertekshøyder i cm

Verteksmarkør (<circle>)

Attributt	Beskrivelse
data-surface-id	Overordnet flateidentifikator
data-vertex-index	Verteksposisjon i polygonet (0-indeksert)
data-altitude	Høyde over havet i cm
data-height-above-ground	Høyde over bakken i cm
data-shared-with	Kommaseparerte flate-IDer som deler denne verteksen (kun til stede på delte vertekser)

Eksempel

GET /v1/projects/abc-123/roof/svg

<svg xmlns="http://www.w3.org/2000/svg" viewBox="-9.636 -6.856 19.984 13.176" data-units="cm">
  <g data-building-id="4858263" data-building-name="Bygning"
     data-surface-count="3" data-total-area-3d="1368800">
    <g data-surface-id="110310263448">
      <path d="M -4.092 2.302 L -4.251 2.314 ... Z"
            fill="#B0B4B4" fill-opacity="0.6" stroke="#666666" stroke-width="0.1"
            data-surface-id="110310263448" data-slope="0" data-direction="0"
            data-area-2d="259300" data-area-3d="259300" data-perimeter="2299"
            data-min-altitude="3867" data-max-altitude="3867" data-vertex-count="9"/>
      <line x1="-4.092" y1="2.302" x2="-4.251" y2="2.314"
            data-surface-id="110310263448" data-edge-index="0"
            data-length="16" data-direction="274"
            data-altitude-start="3867" data-altitude-end="3867" .../>
      <circle cx="-4.092" cy="2.302" r="0.15"
              data-surface-id="110310263448" data-vertex-index="0"
              data-altitude="3867" data-height-above-ground="168"
              data-shared-with="110310263449"/>
    </g>
    <g data-surface-id="110310263449">
      <path d="M 6.967 1.862 L 8.347 1.809 ... Z"
            data-surface-id="110310263449" data-slope="30" data-direction="190"
            data-area-2d="849600" data-area-3d="956200" .../>
      ...
    </g>
  </g>
</svg>

MCP-verktøy

SVG-visualiseringen er tilgjengelig gjennom MCP-verktøyet get_roof_svg.

For aggregerte takmålinger (areal, helning, totaler), se Takmålinger.