DOK-analyse - GeoanalyseDOK
Beskrivelse av tjenesten
Tjeneste for analyse av en eiendom eller et områder mot kartdata som inngår i Det Offentlige Kartgrunnlaget (DOK).
Man angir en eiendom, et planområde eller et egendefinert område inn, og får utført en analyse over hvilke DOK-datasett som ligger innenfor. Analysen er tilgjengelig både som webapplikasjon, som ArcGIS-geoprosesseringstjeneste og som REST-tjeneste - se Tre måter å kjøre analysen på. Resultatet er en oversikt over alle datasett man traff (med eller uten buffer), alle man ikke fikk treff på og hvor langt unna nærmeste er, samt en PDF-rapport med alt av resultater.
DOK-analysen er basert på datasett som inngår i DOK og som er gjort tilgjengelige fra dataeier. Noen datasett har ikke innhold som gir relevant informasjon for skjønn eller avgjørelser i saker etter aktuelle lovverk, og inngår ikke i analysen. Der kommuner har valgt DOK-datasett som enten er kandidater til - eller tatt ut av DOK, vil disse inngå der de har vært tilgjengelige for nedlasting fra dataeier.
Kilde / opphavsrett
Geodata AS - Rettighetshavere DOK.
Oppdateringsfrekvens
Se dokumentasjon av de ulike DOK-karttjenestene for informasjon om oppdateringsfrekvens, f.eks. DOK - Befolkning eller DOK - Energi.
Tjenesteadresser
| Type tjeneste | URL |
|---|---|
| ArcGIS Geoprosesseringstjeneste (GeoanalyseDOK) | https://services.geodataonline.no/arcgis/rest/services/Geoanalyse/GeoanalyseDOK/GPServer |
| REST/JSON (swagger) | https://dokanalyse.geodataonline.no/swagger/v1/index.html |
| Webapplikasjon | https://dokanalyse.geodataonline.no/ |
Tre måter å kjøre analysen på
Analysen finnes i tre varianter. Alle tre kjører samme analyse på samme datagrunnlag, men de er ment for ulik bruk, og de to grensesnittene tilbyr ikke samme funksjonalitet.
| Variant | Ment for | Resultat |
|---|---|---|
| Webapplikasjon - https://dokanalyse.geodataonline.no/ | Manuell bruk i nettleser. | Analyse på skjerm, med PDF-rapport. |
Geoprosesseringstjenesten GeoanalyseDOK | Bruk fra ArcGIS Pro og andre ArcGIS-klienter. | PDF-rapport, og treffene som ArcGIS-featureklasser man kan jobbe videre med i kartet. |
REST-tjenesten dokanalyse | Integrasjon i egne systemer. | JSON med datasett og treff. Mest funksjonalitet, men ingen ferdige featureklasser. |
GeoanalyseDOK gjør ikke analysen selv - den kaller REST-tjenesten dokanalyse og gjør om svaret til
ArcGIS-featureklasser. Det betyr at REST-tjenesten kan kalles direkte hvis man ønsker det, og at den
har flere muligheter enn geoprosesseringstjenesten eksponerer. Se
forskjeller mellom de to.
Geoprosesseringstjenesten GeoanalyseDOK
Hvor finner jeg verktøyene i ArcGIS Pro
Legg først til Geodata Online som en "ArcGIS Server Connection", slik det er beskrevet under Hvordan komme i gang.
Verktøykassen ligger da under mappen Geoanalyse, med navnet GeoanalyseDOK, og inneholder to verktøy:
| Verktøy | Bruk |
|---|---|
| Matrikkel | DOK-analyse for en angitt matrikkelenhet (eiendom), oppgitt med kommune-, gårds- og bruksnummer. |
| Geometri | DOK-analyse for en geometri man digitaliserer selv - et punkt, en linje eller et område. |
Verktøyene kjøres som asynkrone geoprosesseringsjobber, så analysen kjører på serveren og ikke i Pro.
Koordinatsystem
Verktøyene har ingen parameter for koordinatsystem, og de tar ikke hensyn til Output Coordinate System under Environments - den innstillingen blir ignorert.
Utdata-featureklassene kommer i UTM33 (EPSG:25833). Unntaket er at et datasett som i sin helhet er lagret i et annet koordinatsystem, leveres i sitt eget - noen få DOK-datasett (bl.a. dreneringslinjene) er lagret i UTM32. Blandede resultater konverteres til UTM33.
Jobber man i et UTM32-kart, må man altså regne med å reprojisere resultatet selv.
Inn-geometrien kan derimot gis i flere koordinatsystemer. Disse er støttet:
| EPSG | Koordinatsystem |
|---|---|
| 25832 | UTM sone 32, EUREF89 |
| 25833 | UTM sone 33, EUREF89 |
| 25835 | UTM sone 35, EUREF89 |
| 4258 | EUREF89 (geografiske koordinater) |
Andre koordinatsystemer avvises. Det gjelder blant annet WGS84 (EPSG:4326) og Web Mercator (EPSG:3857), som er vanlige i kart hentet fra ArcGIS Online - kjører man analysen fra et slikt kart, feiler jobben.
Buffer
Buffer angir hvor mange meter utenfor inn-geometrien analysen skal se etter treff.
Bufferet legges på selve geometrien - for Matrikkel vil det si eiendomsgrensene til
matrikkelenheten, for Geometri den geometrien man har digitalisert.
Bufferet settes til 1 meter dersom det oppgis som 0 eller lavere. Det finnes altså ingen analyse helt uten buffer, og standardverdien 0 gir i praksis 1 meter.
Resultater
Begge verktøyene gir de samme fire utdataene:
- Rapport (
report) - PDF-rapporten som er produsert. - Punkt, Linje og Område (
Punkt_output,Linje_output,Omrade_output) - featureklasser med treffene, delt opp etter geometritype. Er det ingen treff av en type, kommer featureklassen tom.
Alle fire ligger under Parameters i resultatet fra verktøyet, og featureklassene legges til i kartet.
ArcGIS Pro laster ned PDF-rapporten til en ArcGISProTemp-mappe. Filnavnet ser permanent ut,
men mappen er ikke det - skal rapporten beholdes eller sendes videre, må den lagres et annet sted.
Featureklassene har med informasjon om hvilket DOK-datasett hvert treff kommer fra, i disse feltene:
| Felt | Innhold |
|---|---|
dokDataset | Navnet på DOK-datasettet. |
datasetId | Id til datasettet. |
theme | Temaet datasettet hører til. |
dokUrl | Lenke til datasettet. |
metadataUrl | Lenke til metadata for datasettet. |
uuid | Datasettets uuid. |
Parametere til geoprosesseringstjenesten
Matrikkel
| Navn | Påkrevd | Forklaring |
|---|---|---|
| Buffer | Ja | Antall meter buffer utenfor eiendomsgrensene. Verdier under 1 behandles som 1 meter. |
| Kommunenummer | Ja | Kommunenummer til eiendommen. |
| Gardsnummer | Ja | Gårdsnummer til eiendommen. |
| Bruksnummer | Ja | Bruksnummer til eiendommen. |
| Festenummer | Nei | Festenummer til eiendommen. |
| Seksjonsnummer | Nei | Seksjonsnummer til eiendommen. |
| Inkluder ikke-godkjente datasett | Nei | Tar med datasett som ikke er godkjent som DOK. Av som standard. |
| URL til logo som skal benyttes | Nei | Lenke til logo som skal brukes i PDF-rapporten i stedet for standardlogoen. |
| Rapport (output) | - | PDF-rapporten som har blitt produsert. |
| Punkt (output) | - | Featureklasse med alle punkt-data som faller innenfor eiendommen med buffer. |
| Linje (output) | - | Featureklasse med alle linje-data som faller innenfor eiendommen med buffer. |
| Område (output) | - | Featureklasse med alle polygon-data som faller innenfor eiendommen med buffer. |
Geometri - punkt, linje eller flate
| Navn | Påkrevd | Forklaring |
|---|---|---|
| Buffer | Ja | Antall meter buffer utenfor geometrien. Verdier under 1 behandles som 1 meter. |
| Punkt | Nei | Punkt det skal kjøres analyse på. |
| Linje | Nei | Linje det skal kjøres analyse på. |
| Område | Nei | Område det skal kjøres analyse på. |
| Inkluder ikke-godkjente datasett | Nei | Tar med datasett som ikke er godkjent som DOK. Av som standard. |
| URL til logo som skal benyttes | Nei | Lenke til logo som skal brukes i PDF-rapporten i stedet for standardlogoen. |
| Rapport (output) | - | PDF-rapporten som har blitt produsert. |
| Punkt (output) | - | Featureklasse med alle punkt-data som faller innenfor geometrien med buffer. |
| Linje (output) | - | Featureklasse med alle linje-data som faller innenfor geometrien med buffer. |
| Område (output) | - | Featureklasse med alle polygon-data som faller innenfor geometrien med buffer. |
Punkt, Linje og Område er tre alternativer - man fyller ut ett av dem, og det skal
inneholde én feature. Fyller man ut flere, eller sender inn flere features,
stopper verktøyet med meldingen "Exactly one geometry supported as input".
REST-tjenesten dokanalyse
REST-tjenesten er ment for integrasjon i egne løsninger, og er den som gjør selve analysen. Full dokumentasjon av inn- og utdata ligger i swagger-dokumentasjonen.
Alle kall krever et Geodata Online-token, som sendes med som query-parameteren token.
Endepunkter
| Endepunkt | Analyse på |
|---|---|
POST /Query/Geometry | En geometri man sender inn. |
POST /Query/Matrikkel og GET /Query/Matrikkel | En matrikkelenhet, oppgitt med kommune-, gårds- og bruksnummer. |
POST /Query/Matrikkel/Point | Matrikkelenheten som ligger under et punkt man sender inn. |
GET /Query/Plan | Et planområde. |
Forskjeller fra geoprosesseringstjenesten
Geoprosesseringstjenesten dekker bare de to første endepunktene, og eksponerer et utvalg av parameterne. Kaller man REST-tjenesten direkte, får man i tillegg blant annet:
- Analyse på planområde og på punkt (
/Query/Plan,/Query/Matrikkel/Point). - Å velge hvilke datasett analysen skal omfatte - enkeltdatasett, tema, eller kommunens egen DOK-liste, samt å utelate datasett.
- Å slå av rapporten. Geoprosesseringstjenesten produserer alltid PDF-rapport; over REST er rapport valgfritt.
- Å ta med datasett fra en ekstern featuretjeneste i analysen.
- Nærmeste treff utenfor bufferet, kartutsnitt, tegneregler og alle felter fra kildedataene.
Til gjengjeld er det geoprosesseringstjenesten som gjør resultatet om til ferdige ArcGIS-featureklasser. Kaller man REST-tjenesten direkte, får man JSON, og må selv lage featureklasser av treffene.
Ved analyse på matrikkelenhet hentes eiendomsgeometrien i UTM33 (EPSG:25833), uavhengig av hva som oppgis. For analyse på egen geometri bestemmes koordinatsystemet av geometrien man sender inn - se Koordinatsystem for hvilke som er støttet.