Grunnbegreper

Denne siden forklarer objektene API-et returnerer og hvordan de henger sammen. Referansen lister alle feltene.

Datamodellen

Organisasjon                 bedriften din i Telescope; en API-nøkkel ser bare denne
└── Mappe                    en samling eiendommer; mapper kan ligge i hverandre
    ├── Mappe                undermappe
    └── Eiendom              en eiendom på en tomt
        ├── hazards[]        klimafareresultater, ett per klimafare
        ├── biodiversity[]   naturmangfoldresultater, ett per analyse
        ├── buildings[]      bygninger på tomten, fra det nasjonale registeret
        └── energy_certificates[]   energiattester

Organisasjon

Bedriften eller teamet som eier dataene. Du sender aldri med en organisasjons-ID. API-nøkkelen bestemmer den.

Mappe

En mappe (kalt portfolio i API-et) er en navngitt gruppe eiendommer, for eksempel et fond, en region eller en kunde. Mappene danner et tre: en rotmappe kan inneholde undermapper, som kan ha sine egne undermapper, og så videre. Hver eiendom ligger direkte i nøyaktig én mappe.

Du oppretter og organiserer mapper i Telescope-appen. API-et lister dem slik at du kan gruppere eiendommene på samme måte. Se Mapper.

Eiendom

En eiendom er en tomt med en adresse, og som regel én eller flere bygninger. Telescope kjører analysene sine på tomtens geometri. API-et returnerer eiendommens adresse, identifikatorer og verdi, pluss resultatene i fire lister:

Liste	Hva den inneholder
hazards	Hvor eksponert eiendommen er for hver klimafare, for eksempel jordskred eller overvannsflom
biodiversity	Om eiendommen overlapper eller ligger nær sårbar natur, for eksempel verneområder
buildings	Bygninger registrert på tomten, med bruk, byggeår, areal og etasjer
energy_certificates	Energiattester utstedt for eiendommen, nyeste først

Analyser og lagrede resultater

Når en eiendom legges til, eller tomten endres, kjører Telescope analysene i bakgrunnen og lagrer resultatene. API-et returnerer disse lagrede resultatene. Å lese en eiendom starter aldri en ny analyse.

Det har to konsekvenser for integrasjoner:

• Nye eiendommer starter tomme. Rett etter at en eiendom er opprettet, er hazards og biodiversity tomme lister. De fylles ut etter hvert som analysene blir ferdige.
• En manglende oppføring betyr at det ikke finnes noe lagret resultat. Hvis en klimafare ikke står i hazards, har Telescope ikke noe resultat for den ennå. Det er noe annet enn en oppføring med eksponering NOT_EXPOSED, som betyr at den er analysert og at eiendommen ikke er eksponert.

Slik leser du et klimafareresultat

Hver oppføring i hazards beskriver én klimafare for én eiendom.

Felt	Betydning
name	Klimafaren, for eksempel landslide. Se klimafarer.
exposure	Hvor eksponert stedet er: fra NOT_EXPOSED via VERY_LOW opp til VERY_HIGH.
relevant	Om klimafaren har betydning for denne eiendommen.
sensitivity	Hvor følsom eiendommen er for klimafaren, hvis noen har vurdert det.
vulnerability	Det samlede resultatet av eksponering og følsomhet.

Eksponering kommer fra Telescopes analyse av stedet under flere klimascenarioer. API-et gir deg det ene nivået Telescope bruker: det høyeste nivået på tvers av scenarioene, med mindre en bruker har overstyrt det i appen.

Relevans settes først av analysen. Brukere kan endre den, for eksempel når en klimafare ikke kan påvirke eiendommens bygninger. En klimafare kan ha høy eksponering og likevel være merket som ikke relevant. De fleste rapporter bør bare telle relevante klimafarer.

Følsomhet vurderes av brukere i Telescope. Inntil noen gjør det, er den null, og det samme er vulnerability.

Sårbarhet beregnes ut fra eksponering og følsomhet, så en brukers overstyring av eksponeringen endrer også sårbarheten. Brukere kan ikke overstyre selve sårbarheten.

Slik leser du et naturmangfoldresultat

Hver oppføring i biodiversity beskriver én naturmangfoldanalyse, for eksempel protected_areas eller red_list_species.

Felt	Betydning
name	Analysen. Se naturmangfoldanalyser.
relevant	Om temaet har betydning for denne eiendommen. En brukers overstyring hvis den er satt, ellers analyseresultatet.
proximity	overlaps hvis eiendommen overlapper de analyserte områdene, nearby hvis den ligger nær, ellers null.

Identifikatorer

Felt	Hva det er	Hvem setter det
id	Telescopes identifikator, en UUID. Endres ikke så lenge objektet finnes.	Telescope
internal_reference_id	Din egen identifikator, for eksempel eiendoms-ID-en i ERP-systemet eller eiendomsregisteret ditt. Kan være tom.	Du
matrikkelnummer	Tomtens norske matrikkelnummer, for eksempel 0301-208/101/0/0.	Settes når eiendommen legges til, og kan endres når du oppdaterer den

Bruk id som primærnøkkel når du lagrer data fra Telescope. Bruk internal_reference_id til å koble Telescope-data med dine egne systemer, og til å opprette eller oppdatere eiendommer uten å lage duplikater.

Et matrikkelnummer leses som kommunenummer, deretter gårdsnummer (gnr), bruksnummer (bnr), festenummer (fnr) og seksjonsnummer (snr): 0301-208/101/0/0 er kommune 0301 (Oslo), gnr 208, bnr 101, fnr 0, snr 0.

Tidsstempler

Alle tidsstempler er ISO 8601 i UTC, for eksempel 2026-09-30T12:01:44.104221Z.

• En eiendoms updated_at endres når selve eiendommen endres, for eksempel navnet, adressen eller mappen.
• Den endres ikke når klimafare- eller naturmangfoldresultatene, bygningene eller energiattestene endres. Hvert klimafare- og naturmangfoldresultat har sin egen updated_at.

Synkroniser data forklarer hvordan du holder resultatene oppdatert.