Dokumentasjon for InnsynAPI for Matrikkelen

Dette dokumentet inneholder dokumentasjon av innsynsapi for matrikkelsystemet. Dette api'et består av 3 forskjellige deler:

• Web Map Service (WMS) for uthenting av matrikkelkartet som rasterkart
• Web Feature Service (WFS) for uthenting av matrikkelkartet som vektorkart
• SOAP Web Services for uthenting av egenskaper for objektene i Matrikkelen

Matrikkelens innsynsapi gir mulighet for å hente ut utvalgte deler av matrikkelens datagrunnlag.

Web Feature Service

• GetCapabilities request for WFS
• DescribeFeatureType request for WFS
• Her er dokumentasjon av de forskjellige feltene
• Det er gjort optimaliseringer for WFS-kall for Geoserver. For å få best ytelse på kall bør man følge noen enkle regler. Disse er bekrevet her.

Web Map service

• GetCapabilities request for WMS
• Eksempel på GetMap spørring i Nittedal kommune
• Eksempel på GetMap spørring i Fredrikstad kommune

For TeigWFS-laget er det lagt inn tre alternative tegnestiler som man kan bruke istedenfor standardtegnestilen:

TeigUtenFyll

Tegner teigomriss og representasjonspunkt med matrikkelnummer, men fyller ikke teigene. Denne tegnestilen gjør det lettere å se eventuelle underliggende lag.

Matrikkelnummer

Tegner kun opp teigenes representasjonspunkt. Denne tegnestilen er nyttig hvis man vil ha tegnet opp matrikkelnummer, men ikke vil ha teiggrensene fordi disse hentes fra TeiggrenseWFS.

TeigMnrMangler

Tegner teigomriss og farger teiger som hører til matrikkelenheter hvor matrikkelnummer mangler. Blå tilhører MnrVannMangler/vannteiger og røde tilhører MnrMangler/eierløse teiger.

For å bruke en alternativ stil oppgir man navnet på stilen i WMS-kallets STYLES-parameter. Hvis man henter flere lag om gangen, må man passe på at stilen kommer på tilsvarende plass i STYLES som det laget står på i LAYERS-parameteren. F.eks. ...LAYERS=TEIGWFS,TEIGGRENSEWFS&STYLES=Matrikkelnummer,... For å få fullt utbytte av teiger uten fyll, må man også sørge for å be om at bildet man får tilbake skal inneholde gjennomsiktighet ved å angi TRANSPARENT=true.

Webservices med tilgang for alle brukere med rettigheter til innsyn i matrikkelen

• Dokumentasjon av webservice for adresseinformasjon   wsdl
• Dokumentasjon av webservice for bygningsinformasjon   wsdl
• Dokumentasjon av webservice for informasjon om matrikkelenheter   wsdl
• Dokumentasjon av webservice for komplekse søk   wsdl
• Dokumentasjon av webservice for informasjon om kommuner   wsdl
• Dokumentasjon av webservice for informasjon om kodelister   wsdl
• Dokumentasjon av webservice for informasjon om rettighetene til pålogget bruker   wsdl

Webservice med tilgang for alle brukere med rettigheter til å hente ut rapporter

• Dokumentasjon av webservice for bestilling og opphenting av rapporter    wsdl

Webservice med tilgang for alle brukere med rettigheter til innsyn i eierforhold

• Dokumentasjon av webservice for informasjon om eierforhold   wsdl

Webservice med tilgang for alle brukere med rettigheter til innsyn i kommunale tilleggsdata

• Dokumentasjon av webservice for informasjon om kommunale tilleggsdata   wsdl

Generering av webservice proxies for .NET

Verktøyet wsdl.exe for .NET har noen begrensninger ved generering av webservice-proxy-klasser som gjør at ikke alle typer blir generert når man benytter /sharetypes. En måte å omgå dette problemet er å inkludere en ekstra wsdl-fil som inneholder alle definerte typer. Denne filen må da være den første filen i kommoandoen. Da vil alle typer bli generert. I tillegg til alle typene definerer denne ekstra wsdlen også en fiktiv webservice. Denne kan ikke brukes. Eksempel på kommando for generering vha. /sharetypes:

wsdl  /namespace:InnsynWS /out:src.gen\InnsynWebServices.cs /sharetypes  SharetypeFixWebService.wsdl AdresseWebService.wsdl BygningWebService.wsdl EierforholdWebService.wsdl KodelisteWebService.wsdl KommuneWebService.wsdl KommunetilleggWebService.wsdl MatrikkelenhetWebService.wsdl MatrikkelsokWebService.wsdl RapportWebService.wsdl RettighetWebService.wsdl

XML Schema for web tjenestene finnes i WSDL-dokumentene (se over).
I tillegg bør du lese tekstlig dokumentasjon av XML skjemaene.

Det er ikke egne UML diagrammer for innsynsapi, da datamodellen for innsyn er basert på den underliggende domenemodellen for matrikkelen.
UML diagrammer for domenemodellen finnes her, og detaljert tekstlig dokumentasjon finnes her.