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.

Spørreparametere

Parameter	Type	Beskrivelse
includeMatrikkel	boolean	Ta med alle bygninger på matrikkelenheten, ikke bare den adresserte. Legger til uthus som garasje eller anneks.

Settes den, tegnes også bygningene matrikkelen legger til i SVG-en, hver som sin egen <g>-gruppe.

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>

Kantattributter

Hver kantlinje er merket med hva kanten er, i norsk takterminologi.

Attributt	Beskrivelse
data-edge-type	Kanttypen slik den gjelder: ridge (møne), hip (grat), valley (kilrenne), eave (takfot), rake (gavl), monoPitchTop, wallAbutment, pitchChange, cornice eller unknown
data-edge-overridden	"true" når en person har omklassifisert kanten manuelt. Utelatt ellers
data-edge-type-auto	Hva klassifiseringen selv kom fram til. Bare til stede på en overstyrt kant

En kant som deles av to takflater tegnes én gang per flate, og begge får samme type.

Merknad

data-edge-type er den gjeldende typen: en manuell korrigering går foran klassifiseringen, slik at tegningen viser det samme som kunden ser. data-edge-overridden gjør det mulig å skille en menneskelig avgjørelse fra en automatisk.

Bygningsgruppen merkes i tillegg med data-building-type — bygningstypekoden fra matrikkelen — når registeret har klassifisert bygningen.

MCP-verktøy

SVG-visualiseringen er tilgjengelig gjennom MCP-verktøyet get_roof_svg. Det aksepterer en valgfri include_matrikkel-parameter.

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