Spørsmål for bruk av MatrikkelAPIet
Hvordan finner man eier for en adresse?
Dette er en teknisk beskrivelse for hvordan man kan bruke API-et for å navigere seg rundt i datamodellen. Det er ikke en generell oppskrift for hvordan fastslå hvem som eier en adresse, da dette spørsmålet ikke har noe entydig svar.
Hvis man starter med en adresse og ønsker å navigere seg til eiere er det en del informasjon om matrikkeldomenet det er viktig å vite. Adresser i matrikkelen er punkter som symboliserer inngangsdøren til en bygning. Det er matrikkelenheter (eiendommer) man kan eie, så for å gå fra adresse til en eier må vi finne de relevante matrikkelenhetene og se på deres eiere.
Adresse har i seg selv en direktepeker til matrikkelenhet. Denne pekeren er uinteressant for oss her, da den kun eksisterer for å plassere representasjonspunktet til adressen i riktig område.
Det vi i stedet vil er å se på hvilke bygninger adressen er tilknyttet, og dermed hvilke matrikkelenheter vi kan finne derfra. I bygninger finnes det bruksenheter. Det er disse som har koblingene vi er interessert i. En bruksenhet (også gjerne kalt boenhet for vårt formål) er en del av en bygning vi kan knytte til adresse og matrikkelenhet. I en enebolig finnes det typisk bare én bruksenhet, mens i et leilighetsbygg vil hver enkelt leilighet være en bruksenhet.
Det vi da må gjøre er å ta utgangspunkt i adressen vår og komme oss til matrikkelenhetene gjennom bruksenheter.
Eksemplet under benytter ren XML men det er best å gjøre dette gjennom et høynivåspråk siden man får mye hjelp med typing av objekter der.
1: Finn unik bobleID for adressen vår
Vi kaller på tjenesten AdresseService sin metode findAdresseIdForIdent
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:adr="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/service/adresse" xmlns:adr1="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/adresse" xmlns:kom="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kommune" xmlns:dom="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain">
<soapenv:Header/>
<soapenv:Body>
<adr:findAdresseIdForIdent>
<adr:adresseIdent xsi:type="adr1:VegadresseIdent" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<adr1:kommuneIdent>
<kom:kommunenummer>3007</kom:kommunenummer>
</adr1:kommuneIdent>
<adr1:adressekode>43600</adr1:adressekode>
<adr1:nummer>51</adr1:nummer>
</adr:adresseIdent>
<adr:matrikkelContext>
<dom:locale>nb_NO</dom:locale>
<dom:brukOriginaleKoordinater>false</dom:brukOriginaleKoordinater>
<dom:koordinatsystemKodeId>
<dom:value>10</dom:value>
</dom:koordinatsystemKodeId>
<dom:systemVersion>4.11</dom:systemVersion>
<dom:klientIdentifikasjon>kunnskapsbaseEksempel</dom:klientIdentifikasjon>
</adr:matrikkelContext>
</adr:findAdresseIdForIdent>
</soapenv:Body>
</soapenv:Envelope>
Vi får så i retur den unike id-en:
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Header>
<WorkContext xmlns="http://oracle.com/weblogic/soap/workarea/">rO0ABXdSABl3ZWJsb2dpYy5hcHAubWF0cmlra2VsZWFyAAAA1gAAACN3ZWJsb2dpYy53b3JrYXJlYS5TdHJpbmdXb3JrQ29udGV4dAAINC4xMS4wLjUAAA==</WorkContext>
</S:Header>
<S:Body>
<ns2:findAdresseIdForIdentResponse xmlns="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain" xmlns:ns2="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/service/adresse" xmlns:ns3="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/exception" xmlns:ns4="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/geometri" xmlns:ns5="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/matrikkelenhet" xmlns:ns6="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/adresse" xmlns:ns7="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/util" xmlns:ns8="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/forretning" xmlns:ns9="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kommunetillegg" xmlns:ns10="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bygning" xmlns:ns11="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/sefrak" xmlns:ns12="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kulturminne" xmlns:ns13="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/grunnforurensing" xmlns:ns14="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bruker" xmlns:ns15="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kommune" xmlns:ns16="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/konsesjon" xmlns:ns17="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/metadata" xmlns:ns18="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/person" xmlns:ns19="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kommunetillegg/koder" xmlns:ns20="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kodeliste" xmlns:ns21="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/aktivitetsliste" xmlns:ns22="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/elektronisktinglysing" xmlns:ns23="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/adresse/koder" xmlns:ns24="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bygning/koder" xmlns:ns25="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/endringslogg" xmlns:ns26="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/jobb" xmlns:ns27="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/geometri/koder" xmlns:ns28="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bruker/koder" xmlns:ns29="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/matrikkelenhet/koder" xmlns:ns30="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/sefrak/koder" xmlns:ns31="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/rapport/koder" xmlns:ns32="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/person/koder">
<ns2:return xsi:type="ns6:VegadresseId" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<value>6243964233</value>
</ns2:return>
</ns2:findAdresseIdForIdentResponse>
</S:Body>
</S:Envelope>
Vi ser at typen på id-en er VegadresseId.
2. Finn bruksenheter for adresseID-en vår
Bruker tjenesten BruksenhetService sin metode findBruksenheterForAdresse for å finne de unike id-ene til bruksenheter tilknyttet adressen
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:byg="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/service/bygning" xmlns:dom="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain">
<soapenv:Header/>
<soapenv:Body>
<byg:findBruksenheterForAdresse>
<byg:adresseId>
<dom:value>6243964233</dom:value>
</byg:adresseId>
<byg:matrikkelContext>
<dom:locale>no_NO</dom:locale>
<dom:brukOriginaleKoordinater>false</dom:brukOriginaleKoordinater>
<dom:koordinatsystemKodeId>
<dom:value>10</dom:value>
</dom:koordinatsystemKodeId>
<dom:systemVersion>4.11</dom:systemVersion>
<dom:klientIdentifikasjon>kunnskapsbaseEksempel</dom:klientIdentifikasjon>
</byg:matrikkelContext>
</byg:findBruksenheterForAdresse>
</soapenv:Body>
</soapenv:Envelope>
Vi får da tilbake en god del bruksenhetId-er
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Header>
<WorkContext xmlns="http://oracle.com/weblogic/soap/workarea/">rO0ABXdSABl3ZWJsb2dpYy5hcHAubWF0cmlra2VsZWFyAAAA1gAAACN3ZWJsb2dpYy53b3JrYXJlYS5TdHJpbmdXb3JrQ29udGV4dAAINC4xMS4wLjUAAA==</WorkContext>
</S:Header>
<S:Body>
<ns3:findBruksenheterForAdresseResponse xmlns="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain" xmlns:ns2="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/matrikkelenhet" xmlns:ns3="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/service/bygning" xmlns:ns4="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bygning" xmlns:ns5="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/exception" xmlns:ns6="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/geometri" xmlns:ns7="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/adresse" xmlns:ns8="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/util" xmlns:ns9="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/forretning" xmlns:ns10="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kommunetillegg" xmlns:ns11="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/sefrak" xmlns:ns12="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kulturminne" xmlns:ns13="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/grunnforurensing" xmlns:ns14="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bruker" xmlns:ns15="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kommune" xmlns:ns16="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/konsesjon" xmlns:ns17="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/metadata" xmlns:ns18="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/person" xmlns:ns19="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kommunetillegg/koder" xmlns:ns20="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kodeliste" xmlns:ns21="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/aktivitetsliste" xmlns:ns22="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/elektronisktinglysing" xmlns:ns23="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/adresse/koder" xmlns:ns24="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bygning/koder" xmlns:ns25="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/endringslogg" xmlns:ns26="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/jobb" xmlns:ns27="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/geometri/koder" xmlns:ns28="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bruker/koder" xmlns:ns29="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/matrikkelenhet/koder" xmlns:ns30="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/sefrak/koder" xmlns:ns31="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/rapport/koder" xmlns:ns32="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/person/koder">
<ns3:return>
<ns4:item>
<value>6244231246</value>
</ns4:item>
<ns4:item>
<value>6244231247</value>
</ns4:item>
<ns4:item>
<value>6244231244</value>
</ns4:item>
<ns4:item>
<value>6244231245</value>
</ns4:item>
<ns4:item>
<value>6244231243</value>
</ns4:item>
<ns4:item>
<value>6244263144</value>
</ns4:item>
<ns4:item>
<value>6244263145</value>
</ns4:item>
<ns4:item>
<value>6244263142</value>
</ns4:item>
<ns4:item>
<value>6244263143</value>
</ns4:item>
<ns4:item>
<value>6244263141</value>
</ns4:item>
<ns4:item>
<value>6243985700</value>
</ns4:item>
<ns4:item>
<value>6244231250</value>
</ns4:item>
<ns4:item>
<value>6244231251</value>
</ns4:item>
<ns4:item>
<value>6244231248</value>
</ns4:item>
<ns4:item>
<value>6244231249</value>
</ns4:item>
</ns3:return>
</ns3:findBruksenheterForAdresseResponse>
</S:Body>
</S:Envelope>
3: Hente ut bruksenhetene for å finne matrikkelenheter
Vi benytter nå StoreService sin getObjects-metode for å hente ut bruksenhetene. Legg merke til at vi må type id-ene tilsvarende i responsen i 1) over for å få tjenesten til å skjønne hva som skjer. Vi begrenser oss her til de fem første slik at det ikke blir alt for mye å vise i kallet.
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:stor="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/service/store"
xmlns:dom="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain">
<soapenv:Header/>
<soapenv:Body>
<stor:getObjects>
<stor:ids>
<dom:item
xsi:type="byg:BruksenhetId"
xmlns:byg="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bygning"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<dom:value>6244231246</dom:value>
</dom:item>
<dom:item
xsi:type="byg:BruksenhetId"
xmlns:byg="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bygning"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<dom:value>6244231247</dom:value>
</dom:item>
<dom:item
xsi:type="byg:BruksenhetId"
xmlns:byg="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bygning"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<dom:value>6244231244</dom:value>
</dom:item>
<dom:item
xsi:type="byg:BruksenhetId"
xmlns:byg="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bygning"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<dom:value>6244231245</dom:value>
</dom:item>
<dom:item
xsi:type="byg:BruksenhetId"
xmlns:byg="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bygning"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<dom:value>6244231243</dom:value>
</dom:item>
</stor:ids>
<stor:matrikkelContext>
<dom:locale>no_NO</dom:locale>
<dom:brukOriginaleKoordinater>false</dom:brukOriginaleKoordinater>
<dom:koordinatsystemKodeId>
<dom:value>10</dom:value>
</dom:koordinatsystemKodeId>
<dom:systemVersion>4.11.0</dom:systemVersion>
<dom:klientIdentifikasjon>kunnskapsbaseEksempel</dom:klientIdentifikasjon>
</stor:matrikkelContext>
</stor:getObjects>
</soapenv:Body>
</soapenv:Envelope>
Vi får så tilbake bruksenhetene. Viser her kun utdrag av én av bruksenhetene da dette tar mye plass
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Header>
<WorkContext xmlns="http://oracle.com/weblogic/soap/workarea/">rO0ABXdSABl3ZWJsb2dpYy5hcHAubWF0cmlra2VsZWFyAAAA1gAAACN3ZWJsb2dpYy53b3JrYXJlYS5TdHJpbmdXb3JrQ29udGV4dAAINC4xMS4wLjUAAA==</WorkContext>
</S:Header>
<S:Body>
<ns2:getObjectsResponse xmlns="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain" xmlns:ns2="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/service/store" xmlns:ns3="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/adresse" xmlns:ns4="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/person" xmlns:ns5="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/geometri" xmlns:ns6="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/matrikkelenhet" xmlns:ns7="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/util" xmlns:ns8="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/forretning" xmlns:ns9="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kommunetillegg" xmlns:ns10="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bygning" xmlns:ns11="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/sefrak" xmlns:ns12="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kulturminne" xmlns:ns13="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/grunnforurensing" xmlns:ns14="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bruker" xmlns:ns15="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kommune" xmlns:ns16="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/konsesjon" xmlns:ns17="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/metadata" xmlns:ns18="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kommunetillegg/koder" xmlns:ns19="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kodeliste" xmlns:ns20="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/aktivitetsliste" xmlns:ns21="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/elektronisktinglysing" xmlns:ns22="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/adresse/koder" xmlns:ns23="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/matrikkelenhet/koder" xmlns:ns24="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bygning/koder" xmlns:ns25="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/person/koder" xmlns:ns26="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/endringslogg" xmlns:ns27="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/jobb" xmlns:ns28="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/geometri/koder" xmlns:ns29="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bruker/koder" xmlns:ns30="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/sefrak/koder" xmlns:ns31="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/rapport/koder" xmlns:ns32="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/exception">
<ns2:return>
<item xsi:type="ns10:Bruksenhet" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<id xsi:type="ns10:BruksenhetId">
<value>6244231246</value>
</id>
<metadata>
<item>kostraVirksomhetId</item>
<item>kjokkentilgangId</item>
<item>adresseId</item>
<item>antallRom</item>
<item>skalUtga</item>
<item>etasjenummer</item>
<item>etasjeplanKodeId</item>
<item>byggSkjermingsverdig</item>
<item>id</item>
<item>sluttdato</item>
<item>versjon</item>
<item>uuid</item>
<item>matrikkelenhetId</item>
<item>kostraLeieareal</item>
<item>lopenr</item>
<item>avsluttetAv</item>
<item>kostraFunksjonKodeId</item>
<item>oppdatertAv</item>
<item>byggId</item>
<item>bruksenhetstypeKodeId</item>
<item>bruksAreal</item>
<item>antallBad</item>
<item>versjonId</item>
<item>oppdateringsdato</item>
<item>antallWC</item>
</metadata>
<oppdateringsdato>
<timestamp>2020-06-16T03:23:46.070000000+02:00</timestamp>
</oppdateringsdato>
<versjonId>4</versjonId>
<oppdatertAv>smatmynd</oppdatertAv>
<versjon>1592270626070</versjon>
<ns10:byggId>
<value>6243985699</value>
</ns10:byggId>
<ns10:etasjeplanKodeId>
<value>1</value>
</ns10:etasjeplanKodeId>
<ns10:etasjenummer>2</ns10:etasjenummer>
<ns10:lopenummer>1</ns10:lopenummer>
<ns10:adresseId>
<value>6243964233</value>
</ns10:adresseId>
<ns10:matrikkelenhetId>
<value>6283352523</value>
</ns10:matrikkelenhetId>
<ns10:bruksenhetstypeKodeId>
<value>0</value>
</ns10:bruksenhetstypeKodeId>
<ns10:antallRom>2</ns10:antallRom>
<ns10:antallBad>4</ns10:antallBad>
<ns10:antallWC>3</ns10:antallWC>
<ns10:bruksareal>100.0</ns10:bruksareal>
<ns10:kjokkentilgangId>
<value>1</value>
</ns10:kjokkentilgangId>
<ns10:skalUtga>false</ns10:skalUtga>
<ns10:byggSkjermingsverdig>false</ns10:byggSkjermingsverdig>
<ns10:uuid>
<navnerom>https://data.geonorge.no/matrikkel</navnerom>
<uuid>0c056e66-4d00-5a7f-a539-d0a89507c123</uuid>
</ns10:uuid>
<ns10:kostraFunksjonKodeId>
<value>0</value>
</ns10:kostraFunksjonKodeId>
<ns10:kostraLeieareal>false</ns10:kostraLeieareal>
</item>
</ns2:return>
</ns2:getObjectsResponse>
</S:Body>
</S:Envelope>
Det vi er mest interessert i her er feltet “ns10:matrikkelenhetId”. Dette inneholder pekeren til matrikkelenhet som vi er interessert i. (Vi har også endret litt på innholdet i bruksenheten her for å ikke ha ekte data åpent slik.)
4: Hent ut matrikkelenheter
Vi kjører nå et nytt kall til StoreService sin getObjects metode for å hente ut matrikkelenhetene våre. Igjen begrenser vi det i eksemplet her, men det vil jo da være en lang liste med matrikkelenheter vi henter ut.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:stor="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/service/store" xmlns:dom="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain">
<soapenv:Header/>
<soapenv:Body>
<stor:getObjects>
<stor:ids>
<dom:item xsi:type="mat:MatrikkelenhetId"
xmlns:mat="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/matrikkelenhet"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<dom:value>6283352523</dom:value>
</dom:item>
</stor:ids>
<stor:matrikkelContext>
<dom:locale>no_NO</dom:locale>
<dom:brukOriginaleKoordinater>false</dom:brukOriginaleKoordinater>
<dom:koordinatsystemKodeId>
<dom:value>10</dom:value>
</dom:koordinatsystemKodeId>
<dom:systemVersion>4.11.0</dom:systemVersion>
<dom:klientIdentifikasjon>kunnskapsbaseEksempel</dom:klientIdentifikasjon>
</stor:matrikkelContext>
</stor:getObjects>
</soapenv:Body>
</soapenv:Envelope>
Vi får så matrikkelenheten tilbake og den ser slik ut
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Header>
<WorkContext xmlns="http://oracle.com/weblogic/soap/workarea/">rO0ABXdSABl3ZWJsb2dpYy5hcHAubWF0cmlra2VsZWFyAAAA1gAAACN3ZWJsb2dpYy53b3JrYXJlYS5TdHJpbmdXb3JrQ29udGV4dAAINC4xMS4wLjUAAA==</WorkContext>
</S:Header>
<S:Body>
<ns2:getObjectsResponse xmlns="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain" xmlns:ns2="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/service/store" xmlns:ns3="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/adresse" xmlns:ns4="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/person" xmlns:ns5="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/geometri" xmlns:ns6="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/matrikkelenhet" xmlns:ns7="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/util" xmlns:ns8="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/forretning" xmlns:ns9="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kommunetillegg" xmlns:ns10="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bygning" xmlns:ns11="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/sefrak" xmlns:ns12="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kulturminne" xmlns:ns13="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/grunnforurensing" xmlns:ns14="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bruker" xmlns:ns15="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kommune" xmlns:ns16="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/konsesjon" xmlns:ns17="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/metadata" xmlns:ns18="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kommunetillegg/koder" xmlns:ns19="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kodeliste" xmlns:ns20="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/aktivitetsliste" xmlns:ns21="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/elektronisktinglysing" xmlns:ns22="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/adresse/koder" xmlns:ns23="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/matrikkelenhet/koder" xmlns:ns24="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bygning/koder" xmlns:ns25="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/person/koder" xmlns:ns26="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/endringslogg" xmlns:ns27="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/jobb" xmlns:ns28="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/geometri/koder" xmlns:ns29="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bruker/koder" xmlns:ns30="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/sefrak/koder" xmlns:ns31="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/rapport/koder" xmlns:ns32="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/exception">
<ns2:return>
<item xsi:type="ns6:Seksjon" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<id xsi:type="ns6:SeksjonId">
<value>6283352523</value>
</id>
<metadata>
<item>fristMatrikkelforingsKrav</item>
<item>anleggsprojeksjonsFlaterForMatrikkelenhet</item>
<item>versjon</item>
<item>teigerForMatrikkelenhet</item>
<item>nymatrikulert</item>
<item>formalSeksjonKodeId</item>
<item>harAvtaleGrensePunktfeste</item>
<item>oppdateringsdato</item>
<item>harAvtaleStedbundenRettighet</item>
<item>oppmalingIkkeFullfort</item>
<item>tilleggsareal</item>
<item>mangelMatrikkelforingsKrav</item>
<item>uuid</item>
<item>underSammenslaingBestar</item>
<item>avsluttetAv</item>
<item>harAnmerketKlage</item>
<item>inngarISamlaFastEiendom</item>
<item>stedsnummer</item>
<item>harAktiveFestegrunner</item>
<item>tinglyst</item>
<item>fristOppmaling</item>
<item>sluttdato</item>
<item>harRegistrertGrunnerverv</item>
<item>bruksnavn</item>
<item>oppdatertAv</item>
<item>utgatt</item>
<item>etterML9BTilH</item>
<item>harGrunnforurensing</item>
<item>sameieBrok</item>
<item>kommunalTilleggsdel</item>
<item>id</item>
<item>harKulturminne</item>
<item>fristGrensepunktmerking</item>
<item>underSammenslaingUtgar</item>
<item>grensepunktmerkingMangler</item>
<item>seksjonertMatrikkelenhetIds</item>
<item>matrikkelnummer</item>
<item>skyld</item>
<item>erSeksjonert</item>
<item>historiskOppgittAreal</item>
<item>versjonId</item>
<item>etableringsDato</item>
<item>harRegistrertJordskifteKrevd</item>
<item>eierforhold</item>
<item>historiskArealkildeId</item>
<item>etterML9BTilH</item>
</metadata>
<oppdateringsdato>
<timestamp>2021-10-08T04:08:30.677000000+02:00</timestamp>
</oppdateringsdato>
<versjonId>6</versjonId>
<oppdatertAv>eksternregister2</oppdatertAv>
<versjon>1633658910677</versjon>
<ns6:matrikkelnummer>
<metadata>
<item>seksjonsnummer</item>
<item>kommuneId</item>
<item>bruksnummer</item>
<item>festenummer</item>
<item>gardsnummer</item>
</metadata>
<ns6:kommuneId>
<value>3007</value>
</ns6:kommuneId>
<ns6:gardsnummer>38</ns6:gardsnummer>
<ns6:bruksnummer>226</ns6:bruksnummer>
<ns6:festenummer>0</ns6:festenummer>
<ns6:seksjonsnummer>5</ns6:seksjonsnummer>
</ns6:matrikkelnummer>
<ns6:etableringsdato>
<date>2019-09-16</date>
</ns6:etableringsdato>
<ns6:historiskOppgittAreal>0.0</ns6:historiskOppgittAreal>
<ns6:historiskArealkildeId>
<value>0</value>
</ns6:historiskArealkildeId>
<ns6:tinglyst>true</ns6:tinglyst>
<ns6:skyld>0.0</ns6:skyld>
<ns6:teigerForMatrikkelenhet/>
<ns6:eierforhold>
<ns6:item xsi:type="ns6:PersonTinglystEierforhold">
<metadata>
<item>oppdateringsdato</item>
<item>id</item>
<item>andel</item>
<item>versjonId</item>
<item>kommuneId</item>
<item>andelsnr</item>
<item>oppdatertAv</item>
<item>avsluttetAv</item>
<item>datofra</item>
<item>sluttdato</item>
<item>eierId</item>
<item>eierforholdKodeId</item>
<item>uuid</item>
</metadata>
<oppdateringsdato>
<timestamp>2021-10-08T04:08:30.677000000+02:00</timestamp>
</oppdateringsdato>
<versjonId>1</versjonId>
<oppdatertAv>eksternregister2</oppdatertAv>
<ns6:id>6406252206</ns6:id>
<ns6:kommuneId>
<value>3007</value>
</ns6:kommuneId>
<ns6:eierforholdKodeId>
<value>0</value>
</ns6:eierforholdKodeId>
<ns6:uuid>
<navnerom>https://data.geonorge.no/matrikkel</navnerom>
<uuid>326782eb-3612-5dc6-b410-25119642a2d8</uuid>
</ns6:uuid>
<ns6:andel>
<ns7:teller>3</ns7:teller>
<ns7:nevner>4</ns7:nevner>
</ns6:andel>
<ns6:datoFra>
<date>2019-10-07</date>
</ns6:datoFra>
<ns6:eierId>
<value>6452196988</value>
</ns6:eierId>
<ns6:andelsnummer>2</ns6:andelsnummer>
</ns6:item>
<ns6:item xsi:type="ns6:PersonTinglystEierforhold">
<metadata>
<item>oppdateringsdato</item>
<item>id</item>
<item>andel</item>
<item>versjonId</item>
<item>kommuneId</item>
<item>andelsnr</item>
<item>oppdatertAv</item>
<item>avsluttetAv</item>
<item>datofra</item>
<item>sluttdato</item>
<item>eierId</item>
<item>eierforholdKodeId</item>
<item>uuid</item>
</metadata>
<oppdateringsdato>
<timestamp>2021-10-08T04:08:30.677000000+02:00</timestamp>
</oppdateringsdato>
<versjonId>1</versjonId>
<oppdatertAv>eksternregister2</oppdatertAv>
<ns6:id>6406252207</ns6:id>
<ns6:kommuneId>
<value>3007</value>
</ns6:kommuneId>
<ns6:eierforholdKodeId>
<value>0</value>
</ns6:eierforholdKodeId>
<ns6:uuid>
<navnerom>https://data.geonorge.no/matrikkel</navnerom>
<uuid>6b103244-9042-5318-8fd9-698b7e3b2ca7</uuid>
</ns6:uuid>
<ns6:andel>
<ns7:teller>1</ns7:teller>
<ns7:nevner>4</ns7:nevner>
</ns6:andel>
<ns6:datoFra>
<date>2019-10-07</date>
</ns6:datoFra>
<ns6:eierId>
<value>6452543591</value>
</ns6:eierId>
<ns6:andelsnummer>3</ns6:andelsnummer>
</ns6:item>
<ns6:item xsi:type="ns6:JuridiskPersonIkkeTinglystEierforhold">
<metadata>
<item>uuid</item>
<item>sluttdato</item>
<item>id</item>
<item>oppdatertAv</item>
<item>datotil</item>
<item>eierforholdKodeId</item>
<item>versjonId</item>
<item>andel</item>
<item>oppdateringsdato</item>
<item>kommuneId</item>
<item>eierId</item>
<item>datofra</item>
<item>avsluttetAv</item>
</metadata>
<oppdateringsdato>
<timestamp>2020-06-04T18:43:01.133000000+02:00</timestamp>
</oppdateringsdato>
<versjonId>1</versjonId>
<oppdatertAv>smatmynd</oppdatertAv>
<ns6:id>6366532821</ns6:id>
<ns6:kommuneId>
<value>3007</value>
</ns6:kommuneId>
<ns6:eierforholdKodeId>
<value>11</value>
</ns6:eierforholdKodeId>
<ns6:uuid>
<navnerom>https://data.geonorge.no/matrikkel</navnerom>
<uuid>1f3f37f4-ae85-5cd1-b815-e48a4ec64aa1</uuid>
</ns6:uuid>
<ns6:andel>
<ns7:teller>1</ns7:teller>
<ns7:nevner>1</ns7:nevner>
</ns6:andel>
<ns6:datoTil>
<date>2019-09-18</date>
</ns6:datoTil>
<ns6:eierId>
<value>9352321</value>
</ns6:eierId>
</ns6:item>
</ns6:eierforhold>
<ns6:erSeksjonert>false</ns6:erSeksjonert>
<ns6:harAktiveFestegrunner>false</ns6:harAktiveFestegrunner>
<ns6:harAnmerketKlage>false</ns6:harAnmerketKlage>
<ns6:harRegistrertGrunnerverv>false</ns6:harRegistrertGrunnerverv>
<ns6:harRegistrertJordskifteKrevd>false</ns6:harRegistrertJordskifteKrevd>
<ns6:inngarISamlaFastEiendom>false</ns6:inngarISamlaFastEiendom>
<ns6:harGrunnforurensing>false</ns6:harGrunnforurensing>
<ns6:harKulturminne>false</ns6:harKulturminne>
<ns6:harAvtaleGrensePunktfeste>false</ns6:harAvtaleGrensePunktfeste>
<ns6:harAvtaleStedbundenRettighet>false</ns6:harAvtaleStedbundenRettighet>
<ns6:utgatt>false</ns6:utgatt>
<ns6:underSammenslaingBestar>false</ns6:underSammenslaingBestar>
<ns6:underSammenslaingUtgar>false</ns6:underSammenslaingUtgar>
<ns6:oppmalingIkkeFullfort>false</ns6:oppmalingIkkeFullfort>
<ns6:grensepunktmerkingMangler>false</ns6:grensepunktmerkingMangler>
<ns6:mangelMatrikkelforingskrav>false</ns6:mangelMatrikkelforingskrav>
<ns6:nymatrikulert>false</ns6:nymatrikulert>
<ns6:etterML9BTilH>false</ns6:etterML9BTilH>
<ns6:kommunalTilleggsdel>
<metadata>
<item>kommentarer</item>
<item>kartblader</item>
<item>undereiendommerIds</item>
<item>brukAvGrunnKodeId</item>
<item>matrikkelenhetReferanser</item>
</metadata>
<ns9:kartblader/>
<ns9:brukAvGrunnKodeId>
<value>2</value>
</ns9:brukAvGrunnKodeId>
<ns9:kommentarer/>
<ns9:matrikkelenhetReferanser>
<ns9:item>
<metadata>
<item>oppdateringsdato</item>
<item>id</item>
<item>referanse</item>
<item>oppdatertAv</item>
<item>uuid</item>
<item>matrikkelenhetReferanseKodeId</item>
<item>versjonId</item>
<item>sluttdato</item>
<item>avsluttetAv</item>
</metadata>
<oppdateringsdato>
<timestamp>2019-08-21T14:39:39.277000000+02:00</timestamp>
</oppdateringsdato>
<versjonId>1</versjonId>
<oppdatertAv>0605soa</oppdatertAv>
<ns9:id>6283361369</ns9:id>
<ns9:matrikkelenhetReferanseKodeId>
<value>7</value>
</ns9:matrikkelenhetReferanseKodeId>
<ns9:referanse>19/3150</ns9:referanse>
</ns9:item>
</ns9:matrikkelenhetReferanser>
<ns9:undereiendommerIds/>
</ns6:kommunalTilleggsdel>
<ns6:uuid>
<navnerom>https://data.geonorge.no/matrikkel</navnerom>
<uuid>be13b709-6927-539b-a66d-d0ee9c4961c4</uuid>
</ns6:uuid>
<ns6:sameiebrok>
<ns7:teller>93</ns7:teller>
<ns7:nevner>2428</ns7:nevner>
</ns6:sameiebrok>
<ns6:formalSeksjonKodeId>
<value>1</value>
</ns6:formalSeksjonKodeId>
<ns6:seksjonertMatrikkelenhetIds>
<ns6:item>
<value>606089362</value>
</ns6:item>
</ns6:seksjonertMatrikkelenhetIds>
<ns6:tilleggsareal>true</ns6:tilleggsareal>
<ns6:anleggsprojeksjonsflaterForMatrikkelenhet/>
</item>
</ns2:return>
</ns2:getObjectsResponse>
</S:Body>
</S:Envelope>
Her er det mye informasjon, men det vi er interessert i er jo eierne. Vi kan da se på feltet “ns6:eierforhold“. Her ligger informasjon om hvem som eier matrikkelenheten, og hvilke type eierforhold vi snakker om. Om det er tinglyst eller ikke-tinglyst og annet. Vi ser at dette er eierforhold av typen “PersonTinglystEierforhold” og “JuridiskPersonIkkeTinglystEierforhold” men vi kan se på det sistnevnte at feltet “datoTil” er utfylt. Det betyr at dette er et historisk eierforhold og er ikke interessant for oss nå. På hvert eierforhold finnes det et felt med navn “eierId”. Her ligger pekeren til person som vi er på jakt etter. Da har vi to personId-er som vi kan hente ut. (Vi har også her endret litt på innholdet i objektet fra “virkeligheten” for å ikke ha alt for mye åpent.)
5: Hent ut eierne
Vi benytter StoreService sin getObjects metode på nytt for å hente ut personene som er eiere
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:stor="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/service/store" xmlns:dom="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain">
<soapenv:Header/>
<soapenv:Body>
<stor:getObjects>
<stor:ids>
<dom:item xsi:type="per:PersonId"
xmlns:per="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/person"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<dom:value>6452196988</dom:value>
</dom:item>
<dom:item xsi:type="per:PersonId"
xmlns:per="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/person"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<dom:value>6452543591</dom:value>
</dom:item>
</stor:ids>
<stor:matrikkelContext>
<dom:locale>no_NO</dom:locale>
<dom:brukOriginaleKoordinater>false</dom:brukOriginaleKoordinater>
<dom:koordinatsystemKodeId>
<dom:value>10</dom:value>
</dom:koordinatsystemKodeId>
<dom:systemVersion>4.11.0</dom:systemVersion>
<dom:klientIdentifikasjon>kunnskapsbaseEksempel</dom:klientIdentifikasjon>
</stor:matrikkelContext>
</stor:getObjects>
</soapenv:Body>
</soapenv:Envelope>
Vi får da endelig tilbake personene som eier matrikkelenheten:
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Header>
<WorkContext xmlns="http://oracle.com/weblogic/soap/workarea/">rO0ABXdSABl3ZWJsb2dpYy5hcHAubWF0cmlra2VsZWFyAAAA1gAAACN3ZWJsb2dpYy53b3JrYXJlYS5TdHJpbmdXb3JrQ29udGV4dAAINC4xMS4wLjUAAA==</WorkContext>
</S:Header>
<S:Body>
<ns2:getObjectsResponse xmlns="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain" xmlns:ns2="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/service/store" xmlns:ns3="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/adresse" xmlns:ns4="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/person" xmlns:ns5="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/geometri" xmlns:ns6="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/matrikkelenhet" xmlns:ns7="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/util" xmlns:ns8="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/forretning" xmlns:ns9="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kommunetillegg" xmlns:ns10="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bygning" xmlns:ns11="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/sefrak" xmlns:ns12="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kulturminne" xmlns:ns13="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/grunnforurensing" xmlns:ns14="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bruker" xmlns:ns15="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kommune" xmlns:ns16="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/konsesjon" xmlns:ns17="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/metadata" xmlns:ns18="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kommunetillegg/koder" xmlns:ns19="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/kodeliste" xmlns:ns20="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/aktivitetsliste" xmlns:ns21="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/elektronisktinglysing" xmlns:ns22="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/adresse/koder" xmlns:ns23="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/matrikkelenhet/koder" xmlns:ns24="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bygning/koder" xmlns:ns25="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/person/koder" xmlns:ns26="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/endringslogg" xmlns:ns27="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/jobb" xmlns:ns28="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/geometri/koder" xmlns:ns29="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/bruker/koder" xmlns:ns30="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/sefrak/koder" xmlns:ns31="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/domain/rapport/koder" xmlns:ns32="http://matrikkel.statkart.no/matrikkelapi/wsapi/v1/exception">
<ns2:return>
<item xsi:type="ns4:FysiskPerson" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<id xsi:type="ns4:FysiskPersonId">
<value>6452543591</value>
</id>
<metadata>
<item>sluttdato</item>
<item>avsluttetAv</item>
<item>postadresse</item>
<item>uuid</item>
<item>navn</item>
<item>oppdatertAv</item>
<item>spesifisertRegTypeKodeId</item>
<item>oppdateringsdato</item>
<item>nummer</item>
<item>bostedsadresse</item>
<item>id</item>
<item>versjonId</item>
<item>etternavn</item>
<item>versjon</item>
<item>fornavn</item>
<item>personStatusKodeId</item>
<item>hjemlandsAdresse</item>
</metadata>
<oppdateringsdato>
<timestamp>2013-10-27T01:00:00.000000000+02:00</timestamp>
</oppdateringsdato>
<versjonId>1</versjonId>
<oppdatertAv>smatmynd</oppdatertAv>
<versjon>1382828400000</versjon>
<ns4:nummer>30916795145</ns4:nummer>
<ns4:navn>FETTER FLOTT</ns4:navn>
<ns4:postadresse>
<metadata>
<item>adresselinje1</item>
<item>adresselinje3</item>
<item>postnummeromradeId</item>
<item>adresselinje2</item>
<item>landKodeId</item>
</metadata>
<ns4:adresselinje2>Lille-Skorøya 54</ns4:adresselinje2>
<ns4:adresselinje3>9135 VANNVÅG</ns4:adresselinje3>
<ns4:postnummeromradeId>
<value>1009872</value>
</ns4:postnummeromradeId>
<ns4:landKodeId>
<value>5001</value>
</ns4:landKodeId>
</ns4:postadresse>
<ns4:uuid>
<navnerom>https://data.geonorge.no/matrikkel</navnerom>
<uuid>62098f6c-c3e1-4667-94d6-0d7910d4ffd6</uuid>
</ns4:uuid>
<ns4:etternavn>FETTER</ns4:etternavn>
<ns4:fornavn>FLOTT</ns4:fornavn>
<ns4:spesifisertRegTypeKodeId>
<value>10</value>
</ns4:spesifisertRegTypeKodeId>
<ns4:bostedsadresse>
<metadata>
<item>husbokstav</item>
<item>bruksnummer</item>
<item>undernummer</item>
<item>festenummer</item>
<item>kommunenummer</item>
<item>adressekode</item>
<item>husnummer</item>
<item>bruksenhetsnummer</item>
<item>gardsnummer</item>
<item>postnummer</item>
</metadata>
<ns4:kommunenummer>5423</ns4:kommunenummer>
<ns4:adressekode>1085</ns4:adressekode>
<ns4:husnummer>54</ns4:husnummer>
<ns4:gardsnummer>0</ns4:gardsnummer>
<ns4:bruksnummer>0</ns4:bruksnummer>
<ns4:festenummer>0</ns4:festenummer>
<ns4:undernummer>0</ns4:undernummer>
<ns4:bruksenhetsnummer>H0101</ns4:bruksenhetsnummer>
<ns4:postnummer>9135</ns4:postnummer>
</ns4:bostedsadresse>
<ns4:personStatusKodeId>
<value>1</value>
</ns4:personStatusKodeId>
</item>
<item xsi:type="ns4:FysiskPerson" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<id xsi:type="ns4:FysiskPersonId">
<value>6452196988</value>
</id>
<metadata>
<item>sluttdato</item>
<item>avsluttetAv</item>
<item>postadresse</item>
<item>uuid</item>
<item>navn</item>
<item>oppdatertAv</item>
<item>spesifisertRegTypeKodeId</item>
<item>oppdateringsdato</item>
<item>nummer</item>
<item>bostedsadresse</item>
<item>id</item>
<item>versjonId</item>
<item>etternavn</item>
<item>versjon</item>
<item>fornavn</item>
<item>personStatusKodeId</item>
<item>hjemlandsAdresse</item>
</metadata>
<oppdateringsdato>
<timestamp>2013-10-27T01:00:00.000000000+02:00</timestamp>
</oppdateringsdato>
<versjonId>1</versjonId>
<oppdatertAv>smatmynd</oppdatertAv>
<versjon>1382828400000</versjon>
<ns4:nummer>45855900770</ns4:nummer>
<ns4:navn>GRAN FROM</ns4:navn>
<ns4:postadresse>
<metadata>
<item>adresselinje1</item>
<item>adresselinje3</item>
<item>postnummeromradeId</item>
<item>adresselinje2</item>
<item>landKodeId</item>
</metadata>
<ns4:adresselinje2>Reksterveien 12</ns4:adresselinje2>
<ns4:adresselinje3>7178 STOKKØY</ns4:adresselinje3>
<ns4:postnummeromradeId>
<value>1008136</value>
</ns4:postnummeromradeId>
<ns4:landKodeId>
<value>5001</value>
</ns4:landKodeId>
</ns4:postadresse>
<ns4:uuid>
<navnerom>https://data.geonorge.no/matrikkel</navnerom>
<uuid>f1aeca44-2aea-419d-9a0d-4b82afcd63c2</uuid>
</ns4:uuid>
<ns4:etternavn>GRAN</ns4:etternavn>
<ns4:fornavn>FROM</ns4:fornavn>
<ns4:spesifisertRegTypeKodeId>
<value>0</value>
</ns4:spesifisertRegTypeKodeId>
<ns4:bostedsadresse>
<metadata>
<item>husbokstav</item>
<item>bruksnummer</item>
<item>undernummer</item>
<item>festenummer</item>
<item>kommunenummer</item>
<item>adressekode</item>
<item>husnummer</item>
<item>bruksenhetsnummer</item>
<item>gardsnummer</item>
<item>postnummer</item>
</metadata>
<ns4:kommunenummer>0000</ns4:kommunenummer>
<ns4:adressekode>0</ns4:adressekode>
<ns4:husnummer>0</ns4:husnummer>
<ns4:gardsnummer>0</ns4:gardsnummer>
<ns4:bruksnummer>0</ns4:bruksnummer>
<ns4:festenummer>0</ns4:festenummer>
<ns4:undernummer>0</ns4:undernummer>
</ns4:bostedsadresse>
<ns4:personStatusKodeId>
<value>10</value>
</ns4:personStatusKodeId>
</item>
</ns2:return>
</ns2:getObjectsResponse>
</S:Body>
</S:Envelope>
Vi kan da se at FLOTT FETTER og FROM GRAN er eiere av en leilighet i bygget som vi endte opp med. Vi må gjøre tilsvarende for de andre matrikkelenhetene fra bruksenhetene for å finne alle eiere.
Hva skal koordinatsystemkodeid være?
I utgangspunktet skal man bruke KodelisteService for å finne alle kodelister og kodene i dem. Så kan man velge den av dem som er riktig å angi.
Dessverre har det oppstått en høna-og-egget-situasjon. Alle tjenestekall krever at man oppgir en MatrikkelContext, og i MatrikkelContext må man oppgi KoordinatsystemKodeId for det koordinatsystemet man vil ha dataene i. Dette gjelder også for KodelisteService.
For å komme i gang, så er følgende en liste over koordinatsystemkodeid-verdier som vi anser som relevant for bruk mot matrikkelen i dag:
- 10: EUREF sone 32 (SOSI kode 22)
- 11: EUREF sone 33 (SOSI kode 23)
- 13: EUREF sone 35 (SOSI kode 25)
- 24: EUREF geografisk (SOSI kode 84)
Massivoppdateringer
Kartverket har mottatt henvendelse som gjelder maskinell oppdatering av enkelte datafelt i matrikkelen. I og med dette er et tema som diskuteres rundt omkring i fagmiljøet vil vi presisere følgende:
- All massivoppdatering av matrikkelen skal testes og godkjennes av Kartverket.
- All slik oppdatering skal skje av "programvarebrukere", og ikke personlige brukere.
- All slik massivoppdatering skal avtales med Kartverket slik at det utføres på tidspunkter der belastningene på systemene er minimale. Endringene flyter også ut i ulike distribusjonsløsninger, og må også tilpasses belastningene på disse.
- Vi minner også om bestemmelsen i matrikkelforskriften § 4 tredje ledd i den forbindelse: "Kommune som overlater til andre å føre matrikkelen, skal gi forhåndsmelding om dette til Statens kartverk." Dette gjelder i de tilfellene der kommunen overlater til firma å foreta massivoppdateringer av enkeltfelter i matrikkelen.
Hvordan hente ut bygningsdata ved hjelp av bygningsnummer
Først må man finne bygningens interne id fra bygningsnummeret ved å bruke BygningService.findByggIdForIdent. Deretter hentes selve bygningsboblen med StoreService. Så må man navigere til andre bobler man også er interessert i ved å bruke id-feltene og gjøre nye kall til StoreService, f.eks bruksenheter og kommuner. En trenger antagelig også noen koder som enten kan hentes enkeltvis via StoreService eller alle på en gang via KodelisteService og så caches i en periode. Man bør i det minste oppfriske denne cachen hver gang vi legger ut en ny versjon.
Mer informasjon om boblekonseptet finnes her.
Hvordan finne bolignummer på seksjonert eiendom
Fra denne lenken
Finn bruksenhetsnummer (bolignummer) | Kartverket.no kan man se at bolignummer også kalles bruksenhetsnummer. For å få dette ut må man navigere i modellen fra seksjonen til bruksenheten denne er tilknyttet. En bruksenhet har pekere ut til bygningen den ligger i, men også adressen og matrikkelenheten den hører til.Hvis man da har seksjonen kan man bruke tjenesten
BruksenhetServiceWS for å hente ut bruksenhetid-ene og ved å benytte StoreService for å hente denne ut har du informasjonen som skal til for å bygge opp bolignummeret. Hvis du ikke ønsker å sette dette sammen selv, men bare vil ha den fulle offisielle adressen, kan du gjøre et kall til BruksenhetServiceWS når du har bruksenhetid-en.OBS! Ikke alle seksjoner har bolignummer. Næringsseksjoner har naturlig nok ikke det. Kanskje har de ikke bruksenhetsnummer heller, da registrering av bruksenheter for ikke-boliger ikke er like utfyllende. Samleseksjoner har også gjerne flere bruksenhetsnummer hvis man bare følger oppskriften over. Da er det gjerne et lag til i mellom seksjoneringen og boligene, som for eksempel et borettslag. Dette er mer en eiendomsrettslig greie enn en teknisk greie, så snakk med fagpersoner innen eiendomsrett om hvordan dette skal håndteres på et forretningsmessig plan.
Adresse på bruksenhet
Spørsmål: Ser at bruksenheten <id> ikke har registrert adresse, men den er registrert på matrikkelen.
I hvilke tilfeller blir ikke adressen registrert på bruksenheten?
Svar: Alle adresser i matrikkelen er knyttet til en matrikkelenhet. Dersom matrikkelenheten har aktive bygninger, kan adressen være registrert på bruksenhet. Om adressen er registrert på bruksenhet avhenger av bruksenhetstypen:
Bruksenhetstype Bolig og Ikke godkjent bolig: Bruksenheten har (nesten) alltid adresse, mer enn 99,8% har adresse. Bruksenhetstype Fritidsbolig: Bruksenheten har som oftest adresse, mer enn 95% har adresse.
Andre bruksenhetstyper har sjelden adresse
Hvordan gå fra matrikkelenhetId til en fullstendig adresse
Hvordan kan man gå fra matrikkelenhetId til en fullstendig adresse som f.eks "Kirkeveien 40, 0368 Oslo" ?
Det er bruksenhet som er koblingen mellom matrikkelenhet og adresse så det er denne vi må benytte for å få tak i informasjonen du ber om. Hvis du har matrikkelenhetId-en allerede er det et par steg som må til:
- findBruksenheterForMatrikkelenhet benytt så denne for å finne de aktuelle bruksenhetene.
- Ta så returen fra tjenesten over og fôr den inn i StoreService sin getObjects-metode. Du får nå bruksenhetene ut og disse har i seg peker til matrikkelenheten de hører til og til adressen.
- Du kan så benytte StoreService igjen til å hente ut adressen for hver bruksenhet. Hvis disse er av typen Vegadresse vil de igjen ha en peker til sin veg. På vegen finnes det et felt adressenavn som i ditt eksempel vil være “Kirkeveien”.
- For å hente ut postnummer og poststed må vi se på kretsene som er tilknyttet adressen. Det finnes en liste av KretsId på adressen og hvis du henter disse ut via StoreService vil en av disse være av typen Postnummeromrade. Her er kretsnummer postnummer og kretsnavn er poststed.
Hvordan får man H-nummeret til en bruksenhet?
På bruksenheten vi hentet ut over her ligger det noen felter med navn etasjeplanKodeId, etasjenummer og lopenummer. Hvis vi slår disse tre sammen får vi bruksenhetsnummeret. Du må benytte deg av StoreService for å hente ut kodeverdien for etasjeplankoden og du kan så sette sammen H0101 eller hva dette nå blir. Legg merke til at det er ledende 0 i formatteringen av disse.
En matrikkelenhet/bruksenhet kan enten være leilighet, enebolig, rekkehus osv. Hvordan kan man hente ut denne type informasjon?
På bruksenheten ligger det et felt med navn bruksenhetstypeKodeId. Hvis du henter ut kodeverdien av denne ved å bruke StoreService kan du se hvilken type bruksenhet dette er. Det er relativt begrenset hvor mye informasjon du kan få ut av dette, men det vil bli bedre i fremtiden.
Det kan være greit å benytte seg av KodelisteService for å slippe å måtte hente disse kodene ut via StoreService hele tiden.
Adresse for seksjoner i borettslag/sameie
Spørsmål: Enheter som tilhører et borettslag / sameie har ingen adresser knyttet til matrikkelen, men borettslaget / sameiet har ofte flere adresser - hvordan kan jeg vite hvilken adresse som tilhører seksjonen?
Nå man har et eierseksjonsameie, så er alle adresser knyttet til de seksjonerte (vanligvis bare en) matrikkelenhetene. For å finne ut hvilken adresse som står på hver seksjon, om noen, så må man se på bruksenhetene som er knyttet til seksjonene (findBruksenheterForMatrikkelenhet(er) på BruksenhetService, eventuelt findBoligerForMatrikkelenhet(er), men vær sikker på at du da ikke går glipp av noe). Bruksenhet peker videre på adressen.
Nå skal det sies at bruksenheter kan i seg selv være en adresse. Det som heter Adresse i matrikkelen (med subtypene Vegadresse og Matrikkeladresse) vil, dersom den er tilknyttet en bygning, representere ytterdøra. Dersom det bare er én bruksenhet innenfor den døra, så er det nok til å utgjøre den offisielle adressen. Dersom det er flere bruksenheter bak ytterdøra, som i en blokk, så vil man også ta med bruksenhetsnummeret i den offisielle adressen.
BruksenhetService inneholder også en tjeneste for å beregne hva den offisielle adressen (som en tekst) er for en bruksenhet. Dette er ikke så rett frem, spesielt slik bygningsdata er modellert i matrikkelen.
Har hvert enkelt bygning EN adresse, mens hele eiendommen (samme gårds/bruks-nummer) kan ha flere?
Spørsmål: Har hver enkelt bygning EN adresse, mens hele eiendommen (samme gårds/bruks-nummer) kan ha flere?
En bygning kan ha null, en eller flere adresser. Hver bruksenhet i bygningen kan ha null eller en adresse. Flere bruksenheter kan ha samme Adresse, men vil ha hver sin
offisielle adresse (med mindre det er en unummerert bruksenhet). Det er kun krav om adresser for boligbruksenheter, men det er vanligvis adresser for næringsvirksomhet. Hittil står det nok dårlig til med registrering av separate bruksenheter der det er flere næringslokaler i samme bygning, kanskje spesielt for kjøpesentre. Alle bygninger må ha en bruksenhet, om enn bare en unummerert bruksenhet.En bygning kan ligge på en eller flere matrikkelenheter, hvorav noen av dem kan være “ukjent matrikkelenhet”, representert ved gårdsnummer 0. Den kan også være tilknyttet en eller flere matrikkelenheter, inkludert ukjent. Matrikkelen har bare bygningspunkter, så den har begrenset informasjon om hva bygningen faktisk ligger på. Det kan være null, en eller flere bygninger tilknyttet en matrikkelenhet.
Adresser er knyttet til én og bare én matrikkelenhet, men kan brukes av bruksenheter på andre matrikkelenheter. For eierseksjonssameier må det være slik, da bruksenhetene er knyttet til seksjonene, mens adressen er knyttet til den matrikkelenheten seksjonene er seksjonert på. Det kan være null, en eller flere adresser knyttet til en matrikkelenhet.
For å finne adresser knyttet direkte til en matrikkelenhet, så kan man bruke
AdresseService.findAdresserForMatrikkelenhet (eller flertallsvarianten om man vil finne for flere matrikkelenheter om gangen). For å finne bruksenheter knyttet til en matrikkelenhet, så kan man bruke BruksenhetService.findBruksenheterForMatrikkelenhet (eller flertallsvarianten). Bruksenhetene inneholder byggId for bygning(sendring)en de er en del av, så man trenger ikke bruke en tjeneste for å finne byggene, bare StoreService som vanlig for å hente.Dessverre er bygningsmodellen noe komplisert å forholde seg til. I tillegg til bygninger, så har vi bygningsendringer. Bygningsendringer dokumenterer endringer gjort på bygninger, men bruker også bruksenhetsinstanser for å representere endringene på bruksenhetene (fremfor å for eksempel ha en egen bruksenhetsendring-type). Hvis man kun er interessert i endelige bygninger og bruksenheter, så bør man ignorere bruksenheter på bygningsendringer og bygg av typen bygningsendring. Man kan da ende opp med å ikke finne noe som er så nylig ferdigstilt at matrikkelen ikke er oppdatert enda. Først når bygningsendringen registreres som ferdigstilt blir den endringer på bruksenheter overført til selve bygningen. (Kompliserte greier. Vi prøver å gjøre dette bedre i kommende ny bygningsmodell, men det er nok noe år unna enda. Selv om det kanskje blir mer komplisert på andre måter, slik som kanskje bruksenheter som spenner over flere bygninger.)