Vanlige arbeidsflyter

Hente befaringsdata

Den vanligste arbeidsflyten er å hente prosjektdata for visning i eksterne systemer — dashbord, rapporter eller eiendomsforvaltningsverktøy.

List alle prosjekter

GET /v1/projects
Authorization: Bearer <token>

Dette returnerer en liste med prosjektsammendrag med ID-er, adresser og forsidebilder. Bruk dette til å bygge prosjektlister eller søkegrensesnitt.

Hent prosjektdetaljer med rom

GET /v1/projects/{projectId}
Authorization: Bearer <token>

Svaret inkluderer hele prosjektstrukturen: rom gruppert etter type, bilder, AI-sammendrag og befaringsnotater.

Last ned et bilde

Bilder refereres med photoId og extension i prosjektdataene. Kombiner dem til et filnavn:

GET /v1/projects/{projectId}/photos/{photoId}.{extension}
Authorization: Bearer <token>

For miniatyrbilder, bruk en mindre bredde:

GET /v1/projects/{projectId}/photos/{photoId}.jpg?width=200

AI-drevet analyse med MCP

Med MCP-grensesnittet kan du la en AI-assistent analysere befaringsdata direkte.

Oppsummer et prosjekt

«Oppsummer befaringsfunnene for prosjektet på Storgata 10»

AI-assistenten kaller list_projects for å finne prosjektet etter adresse, deretter get_project for å hente detaljer, og presenterer et sammendrag av rom, bilder og befaringsnotater.

Sammenlign rom

«Sammenlign våtrommene i prosjekt X — hvilke har befaringsnotater?»

Assistenten henter prosjektdetaljer og filtrerer rom etter type, og fremhever de med notater.

Generer en rapport

«Lag en tabell over alle rom i dette prosjektet med type, etasje og antall bilder»

Assistenten kan strukturere prosjektdata i formaterte tabeller eller rapporter basert på dine instruksjoner.

Integrasjonsmønstre

Bildegalleri

Bruk prosjektdetaljer-endepunktet for å hente alle bildereferanser, og hent deretter hvert bilde med valgfri skalering for responsiv visning:

/v1/projects/{id}/photos/{filename}?width=800
/v1/projects/{id}/photos/{filename}?width=200  (miniatyrbilde)

Dashbord-widget

Hent prosjektsammendrag for å vise en kompakt oversikt — antall prosjekter, siste befaringer og forsidebilder for rask navigering.

Bransjescenarier

Forsikring: skadesaksbehandling

Et forsikringsselskap kan integrere befaringsdata direkte i skadesaksbehandlingen:

1. Hent prosjektliste — vis befaringer knyttet til en forsikringssak
2. Les AI-sammendraget — bruk den automatiske oppsummeringen som grunnlag for skadevurdering
3. Gå gjennom romnotater — se befaringsnotater per rom for å identifisere skader
4. Last ned bilder — vedlegg befaringsbilder til skadesaken
5. Vurder møbleringsgrad — bruk romobjekter fra mål-endepunktet til å telle og kategorisere møbler per rom, og få et objektivt mål på hvor møblert eiendommen er (relevant for innbodekning)
6. Vurder møbellogistikk — sjekk objektdimensjoner og -kategorier for å avgjøre om møbler kan flyttes til tilstøtende rom under reparasjoner, eller om ekstern transport og lagring bør inkluderes i oppgjøret

AI-sammendraget og befaringsnotatene kan brukes til å automatisere deler av skadevurderingen, mens bildene gir visuell dokumentasjon. Romobjekter gir et kvantitativt lag — objekttellinger og -kategorier underbygger innbokrav, og objektdimensjoner gir grunnlag for logistikkplanlegging ved utbedringsarbeid.

Eiendomsforvaltning: porteføljeoversikt

Et eiendomsforvaltningsselskap kan bygge en porteføljeoversikt over tilstandsbefaringer:

1. Synkroniser prosjekter — hent alle prosjekter regelmessig og sammenlign lastUpdated
2. Vis forsidebilder — bruk skalerte forsidebilder for kompakt visning
3. Filtrer på status — skille mellom aktive og arkiverte befaringer
4. Drilldown — vis fullstendige romdetaljer med bilder og notater for enkeltprosjekter

AI-assistent: automatisert rapportering

En AI-assistent kan via MCP-grensesnittet automatisere rapporteringsoppgaver:

1. Sammenlign befaringer — «Sammenlign våtrommene i prosjekt A og prosjekt B»
2. Identifiser funn — «Hvilke rom har befaringsnotater i dette prosjektet?»
3. Generer oversikter — «Lag en tabell over alle prosjekter med adresse og siste oppdatering»

Takskifte: materialkalkyle

En takentreprenør kan bruke takgeometri-endepunktene til å planlegge og prissette et takskifte:

1. Hent takmålinger — bruk GET /v1/projects/{projectId}/roof for å hente 3D-areal, helning og antall flater per bygning
2. Analyser takform — bruk GET /v1/projects/{projectId}/roof/svg for å forstå takformen i detalj. Delte vertekser (data-shared-with) avdekker møner, sløyser og overganger mellom flater som påvirker materialvalg og arbeidsomfang
3. Inspiser taket visuelt — bruk GET /v1/projects/{projectId}/roof/photo for å hente et flyfoto av taket. Match flater fra SVG-en mot fotoet for å identifisere rør, ventilasjon, takvinduer og andre elementer som øker kompleksiteten og kostnadene, men som ikke er del av geometrien
4. Beregn materialbehov — kombiner 3D-arealet med forbrukstall for takstein, membran eller andre materialer. Bruk helningsvinkelen til å justere for økt materialforbruk på bratte flater, og kantlengder for beslag ved sløyser og overganger
5. Dimensjoner takrenner — bruk omkrets og kantlengder til å beregne lengder for takrenner, nedløp og beslag
6. Vurder tilgjengelighet — sjekk høyde over bakken (minHeightAboveGround / maxHeightAboveGround) for å planlegge stillasering

Solcelleanlegg: egnethetsvurdering

En solcelleinstallatør kan bruke takdataene til å vurdere egnethet og planlegge plassering:

1. Identifiser egnede flater — bruk takmålingene til å finne flater med gunstig helning (20–40°) og retning (sørvendt)
2. Beregn tilgjengelig areal — summér 2D-arealet for egnede flater for å estimere panelkapasitet
3. Sjekk for hindringer — bruk flyfotoet til å identifisere rør, ventilasjon, piper og andre objekter som reduserer brukbart panelareal eller krever tilpasninger i panelplasseringen
4. Analyser skyggeforhold — bruk takplanen med punkthøyder og data-shared-with-attributter for å vurdere skygging mellom flater
5. Modeller solinnstråling — kombiner helning, kompassretning og punkthøyder for å estimere årlig energiproduksjon

Forsikring: takskade

Et forsikringsselskap kan bruke takgeometridataene til rask skadedokumentasjon:

1. Kartlegg skadeomfang — bruk flateareal, helning og høyde over bakken fra takmålingene for å dokumentere omfanget
2. Inspiser visuelt — bruk flyfotoet for å se den faktiske taktilstanden og identifisere synlige skader, rusk eller slitasje
3. Vurder reparasjonskostnad — kombiner 3D-areal med materialkostnader, justert for helning og kompleksitet (antall flater)
4. Dokumenter visuelt — bruk takplanen og flyfotoet som vedlegg til skadedokumentasjonen

Oppussing: kostnadskalkyle

En oppussingsentreprenør kan bruke mål-endepunktet til å beregne materialkostnader:

1. Hent mål — bruk GET /v1/projects/{projectId}/measurements for å hente gulvareal, veggareal og listlengder per rom
2. Beregn materialvolum — kombiner arealene med forbrukstall for maling, fliser, gulvbelegg eller andre materialer
3. Vurder møbelhåndtering — bruk romobjekter til å avgjøre hva som må flyttes før arbeidet starter. Sjekk objektdimensjoner og -kategorier for å avgjøre om gjenstander kan flyttes til tilstøtende rom eller krever ekstern transport og lagring — dette påvirker både kostnad og tidsplan
4. Prissett oppdraget — multipliser materialvolum med enhetspriser, og legg til møbelhåndteringskostnader der det er relevant
5. Generer plantegning — bruk GET /v1/projects/{projectId}/floorplan for å inkludere en visuell oversikt i tilbudet. SVG-en inkluderer objektplassering, som viser hvor møbler står i forhold til arbeidsområder