Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

Innhold og datakilder

EDR Realty RestAPI gir deg tilgang til eiendomsregisteret med det meste av informasjon om eiendommer og borettsandeler fra offentlige registre i Norge samlet på ett sted. Registeret inneholder nyttig informasjon om juridiske, tekniske og økonomiske forhold

Innhold

Tjenestene inneholder det meste av offentlig tilgjengelig informasjon for alle:

  • Eiendommer

  • Borettslag og borettsandeler

  • Adresser og steder

  • Boliger og bygninger

  • Personer med en relasjon til eiendom eller borettsandel

Datakilder

Tjenestene benytter blant annet data fra følgende offentlige datakilder:

  • Grunnboken: Norges offentlige register over tinglyste rettigheter og heftelser i fast eiendom og borettslagsandeler.

  • Matrikkelen: Norges offisielle eiendomsregister. Inneholder oversikt over alle eiendommer, boliger/bygninger og adresser.

  • Folkeregisteret: Norges offisielle personregister. Inneholder nøkkelopplysninger om alle personer som er eller har vært bosatt i Norge.

  • Enhetsregisteret: Enhetsregisteret samordner grunndata om enheter i næringslivet og offentlig sektor.

  • Posten: Oversikt over alle poststeder i Norge.

  • SSB: Norges offisielle statistikk relatert til økonomi, befolkning og samfunnet på nasjonalt, regionalt og lokalt nivå.

  • Landbruksregisteret: Gir informasjon om ressursgrunnlag, lokalisering og eierforhold på landbrukseiendommer i Norge.

  • Stedsnavnsregisteret: Norges offisielle register over stedsnavn i offentlig bruk

  • Riksantikvaren: Offisielle databaser over fredete kulturminner og kulturmiljøer i Norge.

  • Miljødirektoratet: informasjon om forurensning i grunnen og hvor det er mistanke om forurensning i Norge

  • Andre: Lovdata (konsesjonsforhold), NVE (ras og flomsoner), Statens kartverk (kartgrunnlag), m.fl.

Bruk av EDR Realty RestAPI

Støttetjenester

Dokumentasjon Swagger: Velg «swagger» under «Eiendom» og du kunne se og prøve ut tjenestene v.h.a. swagger-brukergrensesnittet (Swagger er et verktøy for dokumentasjon og samhandling resttjenester). Se  https://beta-api.ambita.com/api-landingpage/swagger2/index.html?url=https://beta-api.ambita.com/realty/api-docs

Testklient: Ved hjelp av testklienten kan en enkelt prøve ut tjenestene for søk oppslag, samt benytte lenker videre til relaterte tjenester. For å benytte testklienten fult ut må en installere en JSON-viewer i nettleseren en benytter. Se: https://beta-api.ambita.com/realty/v1

Ordboken: EDR Realty RestAPI benytter engelsk. Om en ønsker å se norske begreper den integrerte ordboktjenesten benyttes:

Dette kan også benyttes indirekte til å oversette et svar i JSON til norsk for enhver ressurs ved å legge til parameter:AcceptLanguage:Norwegian. (Denne funksjonen er for øyeblikket ikke tilgjengelig!)

Generell beskrivelse

EDR Realty RestAPI er benytter rene REST-operasjoner. Resultatet leveres som JSON-dokumenter.

REST: REST (Representational State Transfer) er designet for å utnytte eksisterende protokoller. REST kan brukes over nesten hvilken som helst protokoll (vanligvis benyttes HTTP når i web-APIer). Utviklere ikke trenger å installere biblioteker eller tilleggsprogramvare for å kunne dra nytte av en REST API. REST API Design ble definert av Dr. Roy Fielding i sin 2000 doktorgradsavhandling. Det er kjent for sitt utrolige lag av fleksibilitet. For nærmere beskrivelse se:https://en.wikipedia.org/wiki/Representational_state_transfer

JSON: JSON (JavaScript Object Notation) er en enkel tekstbasert standard for å formatere meldinger som brukes for datautveksling. Den er opprinnelig avledet fra JavaScript for å representere enkle datastrukturer. Standarden er imidlertid uavhengig av JavaScript eller andre programmeringsspråk. For ytterligere informasjon, se: https://json.org/

Konvolutt: Vi har valgt å bruke konvolutt i stedet for et JSON-element eller et JSON-array. Tjenestene svarer med data i JSON-formatet med en konvoluttstruktur i retur. Konvolutten inneholder en liste over elementer fra søkeressursen (List<Item>, Pagination og Error) eller generell oppslagsressurs (Item og Error)

Ident og nøkkel: Et objekt er identifisert ved hjelp av en ident. En ident kan bestå av flere felter. For eksempel er identen til en eiendom kommunenr, gardsnr, bruksnr, festenr og seksjonsnr. 

 ident: {
   municipalityNumber:301,
   cadastralUnitNumber:1,
   unitNumber:1,
   leaseholdUnitNumber:0,
   sectionNumber:0,
   section:false
 }

Alle ressurser har i tillegg et nøkkelfelt. Det feltet er strengen du bruker når du henter samme ressurs med et oppslag. Nøkkelen er en sammenstilling av feltene som i Ident-strukturen

Eksempel på matrikkelnøkkel: 301-1-1-0-0

Eksempler oppslag:

  • Oppslag v.h.a. objektnøkkel: /<tjeneste>/<key> - eksempel eiendom: cadastres/1243-55-244-0-2

  • Opplag v.h.a. nøkler for andre objekter: /<key-eier>/<key>/<tjeneste> - eksempel adresse med eiendom-nøkke: cadastres/1243-55-244-0-2/addresses/

Lenker: For å forenkle videre søk fra en tjeneste til neste er det lagt til lenker i tjenestene. Lenker er lagt inn for det mest brukte kallsekvensene som benyttes. For eksempel kan en for en eiendom benytte lenker for å finne eiere, adresser, boliger og bygninger til denne eiendommen Lenker fra eiendom til eiere 
Eksemplel lenke fra eiendom til eiere: 

links: { 
  self: { 
    rel: “Cadastre”, 
    href: “https://beta-api.ambita.com/realty/v1/cadastres/1243-55-244-0-2” 
  }, 
  owners: { 
    rel: “Person”, 
    href: “https://beta-api.ambita.com/realty/v1/cadastres/1243-55-244-0-2/owners/”
  }
}

Kvalifisering lenker:

  • Skille mellom søk og opplag. Tjenester for søk og opplag har samme navn, men det framgår av lenke om det er søk eller oppslag:

    • Søk eiendom: search/cadastres

    • Opplag eiendom: cadastres

  • Tjenester med de samme data for eiendommer og borettsandeler som eierforhold og omsetninger, men , men det framgår av om det er eiendom eller borettsande:

    • Eierskap eiendom: cadastre/ownerships

    • Eierskap borettsandel: share/ownerships

Kategorier: Tjenestene er inndelt i fem kategorier:

Alle tjenestene i samme kategori skal oppføre seg på samme måte. Det er også svært små forskjeller mellom de forskjellige kategoriene. To typene skiller seg ut:

  • Støtteressursene som ikke følger noen spesifikke regler.

  • Oppslaget av egne ident som alltid returnerer en enkel forekomst.

Paginering: En tjeneste som returnerer en liste over elementer vil også returnere et paginasjonselement for å gi brukeren muligheten til å aksessere mange elementer Der ytterligere filtrering ikke er mulig. Paginering styres gjennom variablene: pagesize (sidestørrelse) og page (side). Hvis du ber om side = 2 og sidestørrelse = 10, får du element 11-20.

Parameringsmuligheter: Flere av tjenestene har ulike parameringsmuligheter for å forenkle bruken av tjenestene. Hvilke parameringsmuligheter som støttes vil framgå av dokumentasjonen til den enkelte tjeneste. Eksempler på slike parameringsmuligheter:

  • Generelt:

    • Posisjon: positions=true/false: Inkludere posisjonsdata i JSON-retur til bruk for eksempel ved visning av objekter i kart. Default=false

    • Språk: AcceptLanguage:Norwegian/english: Om navn, strukturer og felter skal returneres på engelsk eller norsk. Default=engelsk

  • Eierforhold og omsetninger:

    • Eiernivå: onlyMaxCadastreLevel=true/false eiendom og onlyMaxShareLevel=true/false: Angir om en ønsker alle eller bare høyeste eiernivå for en eiendom (hjemmel, feste, framfeste) eller borettsandel (hjemmel, borett). Vanligvis er en bare interessert i høyeste eiernivå da det er eier av høyeste eiernivå som disponerer eiendommen / borettandelen. Default=false

    • Fritt salg: freeMarketOnly=true/false: Angir om bare omsetninger av type «fritt salg» (utlyst og solgt i det åpne markedet) vise. Default=false

    • Eier: hasProperty=true/false. Filtrere bort personer som ikke eier eiendommer eller borettsandeler. Default=false

    • Sortering: sortByDateDescending=true/false. Angir om dokumenter skal returneres i synkende eller stigende datorekkefølge. Default=false

  • Adresser:

    • Søk på eksakt adressenr (husnr): exactAddressNumber=true/false: Angir om en ønsker at tegn for tegn søk returnerer alle adresser med som starter med oppgitt adressenr (husnr) (som 1, 11.19 om en oppgir 1) eller bare adresse med eksakt oppgitt adressenr (husnr). Default=false

Typer tjenester

Søk: Søketjenestene hjelper deg å finne fram til ønsket objekt selv om du ikke kjenner identen til objektet. Du kan for eksempel finne en eiendom selv om du ikke kjenner matrikkelen til eiendommen ved å søke på eiernavn, adresse, koordinat, m.m. Søketjenestene gir mulighet for tegn for tegn søk

Eierskap: Viser oversikt over eiendommer og borettsandeler en person eller organisasjon eier, med informasjon om tilhørende boliger / bruksenheter, bygninger og adresser

Basistjenester: Basistjenester viser detaljert informasjon om ulike objekter. Informasjonen er hentet fra ulike offentlige registre. For en eiendom kan en for eksempel se informasjon om eiere, eiendomsgrenser og areal, adresser, boliger og bygninger, belåning, begrensninger, servitutter m.m. Tjenestene viser både aktiv og historisk informasjon

Stedfesting og kartvisning: Tjenester som kan benyttes for å plassere objekter (for eksempel eiendommer, bygninger / boliger og omsetninger) i kart. Kan benyttes mot Ambitas kartløsninger, men også mot andre kartløsninger som Google Maps.

Verdiøkte tjenester: Verdiøkte tjenester viser bearbeidet informasjon om ulike objekter. Eksempler på bearbeidet informasjon er beregnet boligverdi, pant (lån) presentert i prioritetsrekkefølge med gjeldende kreditor og beløp, m.v.

Oversikt tjenester

Søk og oppslag

Søke og oppslagstjenester som hjelper en å finne fram til ønsket objekt selv om du ikke kjenner identen til objektet. Søketjenestene gir mulighet for:

  • Query: Tegn for tegn søk (som for eksempel ønsket antall tegn i et gatenavn for å få returnert alle gater som starter med den oppgitte tegnstrengen. Krav om at minimum 3 tegn oppgis. Søk foretas v.h.a. elastic seach engine for å ivareta ulike skrivemåter, ulik rekkefølge på felter, m.v.

  • Oppslag: Oppslag med relaterte identer (som for eksempel oppslag med adresse for å finne en eiendom der en ikke kjenner eiendommens matrikkel). Ved opplag v.h.a. relaterte identer returneres lister med ingen, en eller flere forekomster.

  • Person:

    • Søk (/search/persons):

      • Navn, person / organisasjon

    • Oppslag (/persons):

      • Fødselsnr / organisasjonsnr / anonymPersonID

      • Matrikkel (offisiell id eiendom)

      • Organisasjonsnr og andelsnr, borettslag

  • Gate/vei:

  • Adresse:

    • Søk (/search/addresses):

      • Navn gate / vei, husnr og eventuelt bokstav, eventuelt kommunenavn / poststedsnavn

    • Oppslag (/addresses):

      • AdresseID (kommune, gatekode, husnr, eventuelt bokstav)

      • Krets (eksempel postnr og bydel)

      • Matrikkel (offisiell id eiendom)

      • Organisasjonsnr og andelsnr, borettslag

      • Bygningsnr

      • BruksenhetsID/BoligID

  • Eiendom:

    • Søk (/search/cadastres):

      • Matrikkel (offisiell id eiendom)

    • Oppslag (/cadastres):

      • AdresseID (kommune, gatekode, husnr, eventuelt bokstav)

      • Bygningsnr

      • AnonymPersonID

      • Posisjon (koordinat)

  • Borettslag:

  • Borettsandel:

    • Søk (/search/shares):

      • Navn, borettslag og andelsnr

    • Oppslag (shares):

      • Organisasjonsnr, borettslag og andelsnr

      • AdresseID (kommune, gatekode, husnr, eventuelt bokstav)

      • AnonymPersonID

      • Posisjon (koordinat)

  • Bygning:

    • Søk:

      • Ingen

    • Oppslag (/search/buildings):

      • Bygningsnr

      • Matrikkel (offisiell id eiendom)

      • AdresseID (kommune, gatekode, husnr, eventuelt bokstav)

      • BruksenhetsID/BoligID

  • Bruksenhet/Bolig:

    • Søk:

      • Ingen

    • Oppslag (/separatelyoccupiedunits):

      • BruksenhetsID/BoligID

      • Matrikkel (offisiell id eiendom)

      • AdresseID (kommune, gatekode, husnr, eventuelt bokstav)

      • Bygningsnr

  • Sted:

Eierskap

Viser oversikt over eiendommer og borettsandeler en person eller organisasjon eier, med informasjon om tilhørende boliger / bruksenheter, bygninger og adresser.

  • Detaljerte data om personer og organisasjoner:

  • Oversikt over eide objekter:

    • Eide eiendommer, tinglyste eierforhold cadastreOwnerships

    • Eide eiendommer, ikke tinglyste eierforhold UnregisteredOwnerships

    • Eide borettsandeler, tinglyste eierforhold shareOwnerships

    • Eieranandeler / eiere owningperson

    • Omsetningsdokument eiendom [cadaste/Conveyances] (realty.html#Cadastre-conveyances) / eiendom [share/Conveyances] (realty.html#share-conveyances)

  • Oversikt over boliger / bruksenheter, bygninger og adresser på eiendom / borettsandeler:

Basistjenester

Basistjenester viser detaljert informasjon om ulike objekter. Informasjonen er hentet fra ulike offentlige registre. For en eiendom kan en for eksempel se informasjon om eiere, eiendomsgrenser og areal, adresser, boliger og bygninger, belåning, begrensninger, servitutter m.m. Tjenestene viser både aktiv og historisk informasjon.

Stedfesting og kartvisning

Tjenester som kan benyttes for å plassere objekter (for eksempel eiendommer, bygninger / boliger og omsetninger) i kart. Kan benyttes mot Ambitas kartløsninger, men også mot andre kartløsninger som Google Maps.

Verdiøkte tjenester

Verdiøkte tjenester viser bearbeidet informasjon om ulike objekter. Eksempler på bearbeidet informasjon er beregnet boligverdi, pant (lån) presentert i prioritetsrekkefølge med gjeldende kreditor og beløp, m.v.

  • No labels