Takmålinger

Endepunkt

GET /v1/projects/{projectId}/roof

Returnerer takmålinger gruppert per bygning, basert på flyfoto/satellittbilder. Inkluderer detaljer per takflate (helning, retning, areal, omkrets, høyde) samt totaler per bygning og samlet.

Spørringsparametere:

Parameter	Type	Beskrivelse
`buildingId`	string	Filtrer til én bygning. Responsen beholder formen — `buildings` inneholder bare den ene — og `totals` gjelder kun den. Returnerer `404` hvis bygningen ikke finnes på matrikkelenheten.
`includeMatrikkel`	boolean	Ta med alle bygninger på matrikkelenheten, ikke bare den adresserte. Legger til uthus som garasje eller anneks. Utelates den, returneres kun den adresserte bygningen.

For mer detaljert geometridata — individuelle punkthøyder, kantlengder med kompassretning og topologien mellom takflater — se Takplan.

Responsmodell

Takflate

Felt	Type	Beskrivelse
`surfaceId`	string	Flateidentifikator
`slope`	number	Helning fra Norkart API (gradianer)
`direction`	number	Retning fra Norkart API (UTM sone 33-peiling)
`calculatedSlope`	number	Sann helning i grader beregnet fra polygongeometri via Newells metode (0 = flatt, 90 = vertikalt)
`calculatedDirection`	number	Sann kompassretning i grader beregnet fra polygongeometri (0 = nord, 90 = øst, 180 = sør, 270 = vest)
`area2d`	number	2D-projisert areal i m²
`area3d`	number	3D-flateareal i m²
`perimeter`	number	Omkrets i m
`vertices`	number	Antall polygonhjørner
`minRoofAltitude`	number	Minimum takhøyde (meter over havet)
`maxRoofAltitude`	number	Maksimum takhøyde (meter over havet)
`minHeightAboveGround`	number	Minimum høyde over bakken i m
`maxHeightAboveGround`	number	Maksimum høyde over bakken i m

Bygning

Felt	Type	Beskrivelse
`buildingId`	string	Bygningsidentifikator
`displayName`	string	Visningsnavn (f.eks. «Bygning 1»)
`buildingType`	string \| null	Bygningstypekode fra matrikkelen, f.eks. `111` enebolig, `181` garasje. `null` når registeret ikke har klassifisert bygningen
`buildingTypeLabel`	string \| null	Norsk navn på bygningstypen, ordrett fra SSBs Standard for bygningstype. `null` for ukjent eller manglende kode
`buildingTypeGroup`	string \| null	Norsk navn på kodens tosifrede gruppe — et kortere navn på samme bygning
`fromMatrikkel`	boolean	`true` når bygningen kom fra matrikkelen og ikke fra adresseoppslaget — et uthus som garasje eller anneks. Alltid `false` med mindre `includeMatrikkel` er satt
`surfaces`	array	Takflater (se over)
`totalRoofArea`	number	Totalt 3D-takareal i m²
`totalRoofArea2d`	number	Totalt 2D-projisert areal i m²
`surfaceCount`	number	Antall takflater
`wallCount`	number	Antall utledede vegger

Takkanter

Takkantene klassifiseres automatisk i norsk takterminologi, og lengden summeres per type — løpemeteren en taktekker priser jobben etter. Korrigeringer noen har gjort manuelt i applikasjonen overstyrer klassifiseringen, slik at tallene her er de samme som kunden ser.

Responsen inneholder kun den maskinlesbare type. Tabellen under er oppslaget for hva hver enkelt heter i faget.

Type	Norsk navn
`ridge`	Møne
`monoPitchTop`	Topp pulttak
`hip`	Grat
`valley`	Kilrenne
`eave`	Takfot
`rake`	Gavl
`wallAbutment`	Avslutning mot vegg
`pitchChange`	Knekk
`cornice`	Gesims
`unknown`	Uklassifisert

Rad per type

Felt	Type	Beskrivelse
`type`	string	Kanttypen (maskinlesbar)
`length`	number	Summert 3D-lengde i m — løpemeter
`lengthHorizontal`	number	Summert horisontal (plan) lengde i m
`count`	number	Antall kanter av denne typen
`overriddenCount`	number	Hvor mange av dem en person har omklassifisert manuelt

`roofEdges`

Felt	Type	Beskrivelse
`buildings`	array	Takst per bygning: `buildingId`, `types` og `totals`
`types`	array	Sum per type på tvers av alle bygninger
`totals`	object	Totalsum: `length`, `lengthHorizontal`, `count`
`hasUnclassified`	boolean	`true` når noen kanter ikke lot seg klassifisere
`overriddenCount`	number	Hvor mange kanter totalt som er manuelt omklassifisert

{
  "roofEdges": {
    "buildings": [
      {
        "buildingId": "4858263",
        "types": [
          { "type": "ridge", "length": 8.1, "lengthHorizontal": 8.1, "count": 1, "overriddenCount": 0 },
          { "type": "eave", "length": 16.2, "lengthHorizontal": 16.2, "count": 2, "overriddenCount": 0 }
        ],
        "totals": { "length": 24.3, "lengthHorizontal": 24.3, "count": 3 }
      }
    ],
    "types": [
      { "type": "ridge", "length": 8.1, "lengthHorizontal": 8.1, "count": 1, "overriddenCount": 0 },
      { "type": "eave", "length": 16.2, "lengthHorizontal": 16.2, "count": 2, "overriddenCount": 0 }
    ],
    "totals": { "length": 24.3, "lengthHorizontal": 24.3, "count": 3 },
    "hasUnclassified": false,
    "overriddenCount": 0
  }
}

Totaler

Felt	Type	Beskrivelse
`buildings`	number	Antall bygninger
`surfaces`	number	Totalt antall takflater
`totalRoofArea`	number	Totalt 3D-takareal i m²
`totalRoofArea2d`	number	Totalt 2D-projisert areal i m²
`walls`	number	Totalt antall utledede vegger

Eksempler

Alle bygninger

GET /v1/projects/abc-123/roof

{
  "buildings": [
    {
      "buildingId": "4858263",
      "displayName": "Bygning 1",
      "buildingType": "111",
      "buildingTypeLabel": "Enebolig",
      "buildingTypeGroup": "Enebolig",
      "fromMatrikkel": false,
      "surfaces": [
        {
          "surfaceId": "4858263-1",
          "slope": 0,
          "direction": 0,
          "calculatedSlope": 0,
          "calculatedDirection": 0,
          "area2d": 25.9,
          "area3d": 25.9,
          "perimeter": 24.3,
          "vertices": 9,
          "minRoofAltitude": 38.7,
          "maxRoofAltitude": 38.7,
          "minHeightAboveGround": 1.5,
          "maxHeightAboveGround": 3.2
        },
        {
          "surfaceId": "4858263-2",
          "slope": 30.4,
          "direction": 190,
          "calculatedSlope": 27.3,
          "calculatedDirection": 186,
          "area2d": 85.0,
          "area3d": 95.6,
          "perimeter": 42.1,
          "vertices": 11,
          "minRoofAltitude": 42.0,
          "maxRoofAltitude": 45.4,
          "minHeightAboveGround": 6.4,
          "maxHeightAboveGround": 8.8
        }
      ],
      "totalRoofArea": 136.9,
      "totalRoofArea2d": 126.2,
      "surfaceCount": 3,
      "wallCount": 12
    }
  ],
  "totals": {
    "buildings": 1,
    "surfaces": 3,
    "totalRoofArea": 136.9,
    "totalRoofArea2d": 126.2,
    "walls": 12
  }
}

Hele matrikkelenheten

GET /v1/projects/abc-123/roof?includeMatrikkel=true

Bygninger matrikkelen legger til er merket med fromMatrikkel: true. Merk at både bygningslisten og totalene endrer seg når parameteren settes.

Takflatene er utelatt i eksempelet under for lesbarhet — surfaces inneholder like mange flater som surfaceCount angir.

{
  "buildings": [
    {
      "buildingId": "4858263",
      "displayName": "Bygning 1",
      "buildingType": "111",
      "buildingTypeLabel": "Enebolig",
      "buildingTypeGroup": "Enebolig",
      "fromMatrikkel": false,
      "surfaces": [],
      "totalRoofArea": 136.9,
      "totalRoofArea2d": 126.2,
      "surfaceCount": 3,
      "wallCount": 12
    },
    {
      "buildingId": "4858264",
      "displayName": "Bygning 2",
      "buildingType": "181",
      "buildingTypeLabel": "Garasje, uthus, anneks knyttet til bolig",
      "buildingTypeGroup": "Garasje og uthus til bolig",
      "fromMatrikkel": true,
      "surfaces": [],
      "totalRoofArea": 31.2,
      "totalRoofArea2d": 30.1,
      "surfaceCount": 1,
      "wallCount": 4
    }
  ],
  "totals": {
    "buildings": 2,
    "surfaces": 4,
    "totalRoofArea": 168.1,
    "totalRoofArea2d": 156.3,
    "walls": 16
  }
}

Filtrert etter bygning

GET /v1/projects/abc-123/roof?buildingId=4858263

{
  "buildings": [
    {
      "buildingId": "4858263",
      "displayName": "Bygning 1",
      "buildingType": "111",
      "buildingTypeLabel": "Enebolig",
      "buildingTypeGroup": "Enebolig",
      "fromMatrikkel": false,
      "surfaces": [
        {
          "surfaceId": "4858263-1",
          "slope": 0,
          "direction": 0,
          "area2d": 25.9,
          "area3d": 25.9,
          "perimeter": 24.3,
          "vertices": 9,
          "minRoofAltitude": 38.7,
          "maxRoofAltitude": 38.7,
          "minHeightAboveGround": 1.5,
          "maxHeightAboveGround": 3.2
        }
      ],
      "totalRoofArea": 136.9,
      "totalRoofArea2d": 126.2,
      "surfaceCount": 3,
      "wallCount": 12
    }
  ],
  "totals": {
    "buildings": 1,
    "surfaces": 3,
    "totalRoofArea": 136.9,
    "totalRoofArea2d": 126.2,
    "walls": 12
  }
}

MCP-verktøy

Måledataene, inkludert takkantene, er tilgjengelig gjennom MCP-verktøyet get_roof_measurements. Det aksepterer en valgfri building_id-parameter for å filtrere resultater til en enkelt bygning og include_matrikkel for å ta med hele matrikkelenheten.

For visuell takgeometri med verteksnivå-detaljer, se Takplan.