Veggmålinger

Endepunkt

GET /v1/projects/{projectId}/walls

Returnerer yttervegggeometri gruppert per bygning, utledet fra takflatedata. Hver vegg inkluderer type, kompassretning, areal, 3D-vertekser, 2D-projiserte hjørner og koblinger til takflatene og takkanene den er utledet fra.

Spørringsparametere:

Parameter	Type	Beskrivelse
buildingId	string	Filtrer til én bygning. totals gjelder da 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. Veggene utledes fra takgeometrien, så parameteren virker som på takendepunktene.

Hver bygning oppgir i tillegg buildingType, buildingTypeLabel, buildingTypeGroup og fromMatrikkel, med samme betydning som på takmålingene.

Merknad

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

Attribusjon

Vegggeometri er utledet fra takdata levert av © Norkart AS/Geovekst og kommunene.

Høydereferanse

vertices oppgir høyde i meter over havet, samme referanse som takgeometrien. De to kan kombineres direkte.

buildingId og includeMatrikkel

buildingId slår opp mot hele matrikkelenheten, så en garasje eller et uthus finnes på id uansett om includeMatrikkel er satt.

Merk konsekvensen: filtrerer du på en slik bygning, får du den — men spør du om eiendommen uten includeMatrikkel, er den ikke med i lista. De to parameterne svarer altså ikke helt likt på hvilke bygninger som finnes.

Beslutninger fra applikasjonen gjelder også her: vegger genereres uten takflater som er markert som ikke takflate, og en vegg som er utelatt (på egen hånd eller med bygningen) er fortsatt med, med excluded: true, men holdes utenfor veggareal og antall. Se takmålingene.

Veggtyper

Type	Beskrivelse
ground	Ekte yttervegg — fra takkanten rett ned til bakken. Dette er bygningens faktiske fasader.
shared	Overgangsvegg mellom takflater på ulike høyder — arker, gesimssprang eller nivåendringer. Ikke en ekte fasade, men likevel en utvendig flate.

Responsmodell

Vegg

Felt	Type	Beskrivelse
wallId	string	Veggidentifikator (f.eks. «BYG-1-W1»)
wallType	string	ground eller shared (se over)
direction	number	Kompassretning veggen vender mot (0–360°, 0 = nord, 90 = øst, 180 = sør, 270 = vest)
surfaceIds	string[]	Takflate-IDer veggen er utledet fra (matcher surfaceId i Takmålinger)
edgeIds	string[]	Takkant-IDer veggen projiserer fra (matcher data-edge-id i Takplan)
area	number	Veggareal i m²
excluded	boolean	true når veggen, eller hele bygningen, er utelatt fra prosjektet i applikasjonen. Holdes utenfor totalene
vertices	number[][]	Veggpolygon i GPS-koordinater [lon, lat, alt][]
corners	number[][]	Vegg projisert på 2D-plan som [u, v][] i meter — for bredde/høyde-resonering

Bygning

Felt	Type	Beskrivelse
buildingId	string	Bygningsidentifikator
displayName	string	Visningsnavn (f.eks. «Bygning 1»)
walls	array	Yttervegger (se over)
excluded	boolean	true når hele bygningen er utelatt fra prosjektet i applikasjonen
totalWallArea	number	Totalt veggareal for denne bygningen i m², uten utelatte vegger
wallCount	number	Antall vegger som teller

Totaler

Felt	Type	Beskrivelse
buildings	number	Antall bygninger
walls	number	Totalt antall vegger
totalWallArea	number	Totalt veggareal på tvers av alle bygninger i m², uten utelatte vegger

Eksempler

Alle bygninger

GET /v1/projects/abc-123/walls

{
  "buildings": [
    {
      "buildingId": "4858263",
      "displayName": "Bygning 1",
      "excluded": false,
      "walls": [
        {
          "wallId": "4858263-W1",
          "wallType": "ground",
          "direction": 180,
          "surfaceIds": ["110310263449"],
          "edgeIds": ["110310263449-0"],
          "area": 12.4,
          "excluded": false,
          "vertices": [
            [5.6877, 58.9613, 45.4],
            [5.6877, 58.9613, 8.5],
            [5.6875, 58.9613, 8.5],
            [5.6875, 58.9613, 45.4]
          ],
          "corners": [
            [0, 6.9],
            [0, 0],
            [1.7, 0],
            [1.7, 6.9]
          ]
        },
        {
          "wallId": "4858263-W2",
          "wallType": "shared",
          "direction": 90,
          "surfaceIds": ["110310263448", "110310263449"],
          "edgeIds": ["110310263448-2"],
          "area": 4.1,
          "excluded": false,
          "vertices": [
            [5.6875, 58.9612, 41.98],
            [5.6875, 58.9612, 38.67],
            [5.6875, 58.9612, 38.67],
            [5.6875, 58.9612, 41.98]
          ],
          "corners": [
            [0, 3.3],
            [0, 0],
            [1.2, 0],
            [1.2, 3.3]
          ]
        }
      ],
      "totalWallArea": 16.5,
      "wallCount": 2
    }
  ],
  "totals": {
    "buildings": 1,
    "walls": 2,
    "totalWallArea": 16.5
  }
}

Filtrert etter bygning

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

Returnerer samme struktur med én bygning i buildings-arrayet.

Kryssreferanser med takdata

Vegger er utledet fra takkanter. Bruk topologilenkene til å korrelere:

• surfaceIds → matcher med surfaceId i Takmålinger for å finne overordnet takflate
• edgeIds → matcher med data-edge-id i Takplan for å finne den eksakte takkanten veggen projiserer fra

Dette muliggjør fullstendig resonering om bygningens ytterside — takflater, vegger og hvordan de henger sammen.

MCP-verktøy

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

For en visuell utbrettet oversikt over veggene, se Veggplan.