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. Returnerer `{ building, totals }` i stedet for `{ buildings, totals }`. Returnerer `404` hvis bygningen ikke finnes.

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»)
`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

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",
      "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
  }
}

Filtrert etter bygning

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

{
  "building": {
    "buildingId": "4858263",
    "displayName": "Bygning 1",
    "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 er tilgjengelig gjennom MCP-verktøyet get_roof_measurements. Det aksepterer en valgfri building_id-parameter for å filtrere resultater til en enkelt bygning.

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