Handleiding PDOK gebruik ten behoeve van Afnemers

Handleiding PDOK gebruik ten behoeve van Afnemers

Dit document is bedoeld voor online gebruik.

Datum: 10 december 2012 Versie: 1.1 Status: definitief

Versiehistorie Versie

Datum

Wijzigingen ten opzichte van de vorige versie

1.0

10-12-2012

Startversie

1.1

10-12-2012

Links (doorverwijzingen naar www.pdok.nl) uitgebreid

Inhoudsopgave Versiehistorie ...................................................................................................................................................... 2 1 Inleiding ........................................................................................................................................................ 4 1.1 Leeswijzer .............................................................................................................................................. 4 1.2 Versiebeheer ......................................................................................................................................... 4 2 Toegang tot PDOK ..................................................................................................................................... 5 2.1 PDOK Loket ........................................................................................................................................... 5 2.2 Nationaal Georegister......................................................................................................................... 5 3 PDOK producten ........................................................................................................................................ 6 3.1 URL’s en metadata PDOK services................................................................................................. 6 3.2 Omgeving............................................................................................................................................... 6 3.3 Projectie ................................................................................................................................................. 6 3.4 Koppelvlakken ...................................................................................................................................... 6 3.4.1 Tiling........................................................................................................................................................ 7 4 Gebruik PDOK services............................................................................................................................ 8 4.1 Connectiviteit ........................................................................................................................................ 8 4.1.1 Methode 1: Connectie testen in Browser ...................................................................................... 9 4.1.2 Methode 2: Connectie testen in GIS applicatie ...........................................................................10 4.2 Functionele test...................................................................................................................................11 4.3 Applicatie test ......................................................................................................................................13

3

Handleiding PDOK gebruik

1 Inleiding Met deze handleiding kunnen gebruikers van PDOK zelf aan de slag. Deze handleiding is bedoeld voor gebruikers van PDOK Basis, PDOK Educatief en PDOK Fair Use. Alle in dit document gebruikte voorbeelden betreffen open PDOK services. Deze handleiding bevat: • de aanpak voor aansluiten op PDOK, tips en trucs; • informatie over de gehanteerde standaarden met verwijzingen naar relevante websites; • voorbeelden van service requests (bv GetMap…); • voorbeelden om in een GIS pakket PDOK services te benaderen; De producten van PDOK zijn geoservices voor ophalen van kaartbeelden of andere locatiediensten. PDOK levert services die voldoen aan de Nederlandse service profielen (zie http://www.geonovum.nl/geostandaarden/services/destandaarden). Voor gebruikers is het van belang of de PDOK services ook functioneel werken in de eigen applicatie, maar dat blijft een eigen verantwoordelijkheid. PDOK levert onder andere met deze handleiding de handvatten om de PDOK services in de eigen omgeving toe te passen.

1.1 Leeswijzer Deze gebruikershandleiding verwijst in hoofdstuk 2 naar twee websites met meer informatie over PDOK. In hoofdstuk 3 staan de achtergrond van PDOK en haar producten beschreven. Gebruikers met meer ervaring die snel aan de slag willen kunnen meteen naar hoofdstuk 4 over het Gebruik van PDOK services.

1.2 Versiebeheer Deze handleiding is aan verandering onderhevig. Om die reden is het raadzaam om te verifiëren of u beschikt over de laatste versie, die beschikbaar is via http://pdok.nl/nl/hoe/bibliotheek.

4


2 Toegang tot PDOK Met betrekking tot het gebruik van PDOK zijn er twee belangrijke websites:

2.1

PDOK Loket

Het PDOK Loket (http://www.pdok.nl) is de centrale ingang voor alle PDOK informatie. Via het loket zijn handleidingen beschikbaar over het gebruik van de verschillende diensten. Tevens is er een helpfunctie met veelgestelde vragen en antwoorden beschikbaar (www.pdok.nl/nl/hoe/veelgestelde-vragen). Er is een forum waarin gebruikers elkaar met raad en daad terzijde staan. Dit forum bereikt u via het PDOK Loket (http://www.pdok.nl/nl/forum).

2.2

Nationaal Georegister

Het Nationaal Georegister (NGR) is de landelijke catalogus om geo-informatie te vinden. Metadata van vele ruimtelijke datasets worden hier gepubliceerd. Uiteraard maken de PDOK services ook deel uit van deze catalogus. De website van het Nationaal Georegister is www.nationaalgeoregister.nl.

5


3 PDOK producten In dit hoofdstuk vindt u inhoudelijke informatie over de PDOK services. Deze informatie is ook terug te vinden op de drie in het voorgaande hoofdstuk besproken websites, maar een aantal relevante aspecten worden hier samengevat. In het bijzonder in de Producten en Diensten Catalogus (PDC) is veel informatie te vinden. De PDC is bereikbaar via http://www.pdok.nl/nl/hoe/bibliotheek.

3.1

URL’s en metadata PDOK services

Op het PDOK Loket (http://pdok.nl/nl/producten/pdok-services/overzicht-urls) is een overzicht gegeven van de PDOK services inclusief koppel-url’s en verwijzingen naar de metadata in het Nationaal Georegister (NGR). Een andere ingang tot deze informatie is het Nationaal Georegister (NGR) (http://www.nationaalgeoregister.nl). Door te zoeken op “PDOK” vind u de bijbehorende metadata voor services. Een doorkoppeling naar de metadata voor data is helaas nog niet gerealiseerd. Hiervoor moet u zoeken op de naam van PDOK service of onderliggende dataset.

3.2

Omgeving

De PDOK services worden gehost bij het Kadaster. Het Kadaster is als PDOK beheerorganisatie ook verantwoordelijk voor het leveren en het beheren van de PDOK diensten.

3.3

Projectie

De PDOK services worden in meerde projecties aangeboden, wat verschilt per service. Voor alle services wordt RD_new (EPSG=28992) ondersteund. De exacte lijst met ondersteunde projecties per service is op te vragen door middel van een GetCapabilities request. Meer informatie over de GetCapabilities request vindt u verderop in dit document. Op de website http://www.epsg-registry.org/ kunt u meer informatie vinden over de EPSG codes van de verschillende projecties.

3.4

Koppelvlakken

Deze paragraaf biedt inzicht in welke koppelvlakken PDOK ondersteunt met verwijzingen naar achtergrondinformatie. Voor toelichting op standaarden zie ook www.geonovum.nl/geostandaarden/services/destandaarden.

Tabel 1: Koppelvlakken PDOK Koppelvlak Versie Info WMTS 1.0.0 http://www.opengeospatial.org/standards/wmts TMS 1.0.0 http://wiki.osgeo.org/wiki/Tile_Map_Service_Specification WMS 1.1.1 / 1.3.0 http://www.opengeospatial.org/standards/wms WFS 1.0.0 (GML2) / http://www.opengeospatial.org/standards/wfs 1.1.0 (GML3) WCS 1.1.1 http://www.opengeospatial.org/standards/wcs

6


3.4.1 Tiling Op dit moment wordt één tiling schema ondersteund. Dit is het schema zoals aanbevolen wordt door de werkgroep tiling van Geonovum. De specificaties hiervan zijn te vinden op: http://www.geonovum.nl/sites/default/files/Nederlandse_richtlijn_tiling_-_versie_1.0.pdf en op de wiki van geonovum: http://wiki.geonovum.nl/index.php/Tiling. "De extent van het gebied van de set tiles komt hiermee voor zoomniveau 0 op (uitgedrukt in RD stelsel,uitgaand van linksboven zoals bij WMTS gebruikelijk):linksboven: X=-285.401,920 Y=903.401,920;rechtsonder: X=595.401,920 Y=22.598,080; " Dit is dus inclusief het Nederlands Continentaal Plat (NCP).

7


4 Gebruik PDOK services De eerste stap in dit proces is het bekijken of de PDOK services benaderbaar zijn. Dit wordt beschreven in paragraaf 4.1: Connectiviteit. Als dit succesvol is verlopen kan de functionele test worden gedaan (zie paragraaf 4.2: Functionele test). Let wel: De tweede stap bevat de voorbeelden van de eerste stap. De reden is, dat u zich ook kunt beperken tot alleen het uitvoeren van de eerste stap. De tweede stap bevat meer functionaliteiten zoals: legenda ophalen, informatie van objecten bevragen en capabilities van de service. De tweede stap is bedoeld voor medewerkers met enige ervaring met WMS en GIS applicaties. Als laatste is het mogelijk de URL’s van de PDOK mapservices in een applicatie toe te voegen en hierna de services in de applicatie te testen. Dit vergt specialistische kennis van zaken wat betreft het beheer van de betreffende applicatie.

4.1

Connectiviteit

Er zijn twee methoden om te controleren of de PDOK services bereikbaar zijn: in een webbrowser of met een GIS applicatie. Voordat u gaat testen, met één of beide methodes, probeer PDOK via internet te bereiken. Klik op de volgende link: http://geodata.nationaalgeoregister.nl. Als het goed is krijgt u onderstaande melding in beeld.

Is dit niet het geval dan heeft u waarschijnlijk geen stabiele verbinding met internet.

8


4.1.1 Methode 1: Connectie testen in Browser Klik op de URL in tabel 2 of Knip/Plak de URL in uw browser. Het antwoord moet hetzelfde zijn als weergegeven in de kolom Output.

Tabel 2: Test uw connectiviteit met de PDOK services Service Type Request URL BrtAchterTMS URL van http://geodata.nationaalgeoregister.nl/tms/1.0. grondkaart tile cache 0/brtachtergrondkaart/9/230/308.png8

BrtAchtergrondkaart

WMTS

URL van tile cache

Bestuurlijke grenzen

WMS

GetMap (alle lagen NL)

Natura2000

TMS

URL van tile cache

http://geodata.nationaalgeoregister.nl/tms/1.0. 0/natura2000/0/0/0.png8

Natura2000

WMS

GetMap (Den Helder)

Natura2000

WFS

GetFeature

http://geodata.nationaalgeoregister.nl/natura20 00/ows?service=WMS&version=1.1.1&REQUE ST=GetMap&layers=natura2000&SRS=EPSG: 28992&BBOX=107566,551742,118654,55915 0&WIDTH=1000&HEIGHT=1000&FORMAT=i mage/png http://geodata.nationaalgeoregister.nl/natura20 00/ows?service=WFS&version=1.1.0&REQUE ST=GetFeature&TYPENAME=natura2000:nat ura2000&BBOX=0,300000,250000,650000&m axfeatures=1

Output

http://geodata.nationaalgeoregister.nl/wmts/brt achtergrondkaart?VERSION=1.0.0%20vb:%20 &request=GetTile&format=image/png8&TileMa trixSet=EPSG:28992&TileMatrix=EPSG:28992 :3&layer=brtachtergrondkaart&TileRow=3&Tile Col=3 http://geodata.nationaalgeoregister.nl/bestuurlij kegrenzen/ows?service=WMS&version=1.3.0& REQUEST=GetMap&layers=bestuurlijkegrenz en:provincies_2012&SRS=EPSG:28992&BBO X=0,300000,300000,600000&WIDTH=1000&H EIGHT=1000&FORMAT=image/png

.gml (Alde Feanen)

Let op: de meest actuele en complete overzicht van URL’s vindt u op http://pdok.nl/nl/producten/pdokservices/overzicht-urls

9


4.1.2 Methode 2: Connectie testen in GIS applicatie Gebruik een GIS desktop of GIS webapplicatie en maak verbinding met de PDOK service. (In volgende paragraaf staat een aantal verwijzingen naar voorbeeldapplicaties). Om verbinding te maken met een PDOK service knipt/plakt u de Base URL (zie Tabel 3 of http://pdok.nl/nl/producten/pdok-services/overzicht-urls) van de PDOK service in het invoerveld van uw GIS applicatie. Let op: Hier is de toevoeging “request=GetCapabilities” niet nodig (wordt er vaak dynamisch achtergeplakt). Verschillende GIS pakketten gaan hier anders mee om. Let op: Veel standaard GIS pakketten (zowel OpenSource als commerciële GIS pakketten) ondersteunen nog geen WMTS en TMS. Zie hiervoor de volgende paragraaf hoe u dit kunt testen. Voorbeeld URL PDOK service: natura2000: http://geodata.nationaalgeoregister.nl/natura2000/ows Figuur 1: Voorbeeld van het toevoegen van een WMS service in Quantum GIS

Figuur 2: Voorbeeld van het toevoegen van een WMS in ArcCatalog

Het meest actuele overzicht van de PDOK services wordt bijgehouden op het PDOK Loket (http://pdok.nl/nl/producten/pdok-services/overzicht-urls). Hier zijn ook links te vinden naar de metadata van de services en de metadata van de bijbehorende data.

10


4.2

Functionele test

Met deze test kunt u testen of de PDOK service functioneel benaderbaar is vanuit uw omgeving. De onderstaande URL’s kunt u gebruiken om de test uit te voeren. De URL’s kunt u met uw browser testen, maar ook in een standaard OpenGis client of in een desktop GIS pakket. Let op: Dat de juiste versie van de PDOK services wordt ondersteund. Let op: Er wordt enige ervaring verondersteld met WMS services en kennis van GIS applicaties. Voorbeelden desktop Gis Client voor WMS / WFS: OpenSource • Gaia en uDIG http://wiki.geonovum.nl/index.php/3.6.3_Installeren_GAIA_en_uDig • Quantum GIS (http://www.qgis.org/) (WMS/WFS) Closed Source • ESRI: ArcGIS (WMS / WFS ), Arc Explorer (WMS) • MapInfo (WMS / WMF) • Intergraph: Geomedia (WMS / WFS) Tabel 3 geeft voorbeelden die u kunt gebruiken om met PDOK services te werken. De output kolom beschrijft het te verwachten antwoord van het request. De voorbeelden zijn beperkt tot drie PDOK services: BRT Achtergrondkaart, Bestuurlijke grenzen en Natura2000. Alle binnen PDOK aangeboden koppelvlakken komen hierin voor en gezamelijk behandelen ze alle veel voorkomende requests. Het complete overzicht van PDOK services staat op het PDOK Loket (http://pdok.nl/nl/producten/pdokservices/overzicht-urls). Aan de hand van de in Tabel 3 beschreven voorbeelden kunnen die URL’s ook worden toegepast.

11


Tabel 3: Voorbeelden functionele test PDOK services PDOK service BRT Achtergrond kaart BRT Achtergrond kaart

Type service TMS

Type Request

URL

Capabilities

http://geodata.nationaalgeoregister.nl/tms/1.0 .0/brtachtergrondkaart@EPSG:28992@png8

TMS

URL van tile cache

http://geodata.nationaalgeoregister.nl/tms/1.0 .0/brtachtergrondkaart/3/3/3.png8

BRT Achtergrond kaart

WMTS

URL van tile cache

BrtAchtergrondkaart

TMS

URL van tile cache

http://geodata.nationaalgeoregister.nl/wmts/b rtachtergrondkaart?VERSION=1.0.0%20vb: %20&request=GetTile&format=image/png8& TileMatrixSet=EPSG:28992&TileMatrix=EPS G:28992:3&layer=brtachtergrondkaart&TileR ow=3&TileCol=3 http://geodata.nationaalgeoregister.nl/tms/1.0 .0/brtachtergrondkaart/9/230/308.png8


WMS

GetCapabilitie s

http://geodata.nationaalgeoregister.nl/bestuur lijkegrenzen/ows?request=GetCapabilities&s ervice=WMS&version=1.3.0


WMS

GetMap (alleen laag bestuurlijkegre nzen: buurten)


WMS


WMS

Natura2000

TMS

GetLegendGra phic voor de laag bestuurlijkegre nzen: gemeenten_20 12 GetLegendGra phic voor de laag bestuurlijkegre nzen: provincies_20 12 Capabilities

http://geodata.nationaalgeoregister.nl/bestuur lijkegrenzen/ows?service=WMS&version=1.1 .1&REQUEST=GetMap&layers=bestuurlijkeg renzen:buurten&SRS=EPSG:28992&BBOX= 107566,551742,118654,559150&WIDTH=10 00&HEIGHT=1000&FORMAT=image/png http://geodata.nationaalgeoregister.nl/ bestuurlijkegrenzen/ows?service=WMS &version=1.1.1&REQUEST=GetLegend Graphic&layer=bestuurlijkegrenzen:ge meenten_2012&FORMAT=image/png

Natura2000

TMS

12

URL van tile cache

Output .XML

.XML

http://geodata.nationaalgeoregister.nl/ bestuurlijkegrenzen/ows?service=WMS &version=1.1.1&REQUEST=GetLegend Graphic&layer=bestuurlijkegrenzen:pro vincies_2012&FORMAT=image/png http://geodata.nationaalgeoregister.nl/tms/1.0 .0/natura2000@EPSG:28992@png8 http://geodata.nationaalgeoregister.nl/tms/1.0 .0/natura2000/3/3/3.png8


.XML

Natura2000

TMS

URL van tile cache

http://geodata.nationaalgeoregister.nl/tms/1.0 .0/natura2000/9/230/308.png8

Natura2000

TMS

URL van tile cache

http://geodata.nationaalgeoregister.nl/tms/1.0 .0/natura2000/0/0/0.png8

Natura2000

WMS

GetCapabilitie s

Natura2000

WMS

GetMap

Natura2000

WMS

GetLegendGra phic

Natura2000

WFS

GetCapabilitie s

Natura2000

WFS

DescribeFeatu reType

Natura2000

WFS

GetFeature

http://geodata.nationaalgeoregister.nl/natura2 000/ows?request=GetCapabilities&service= WMS&version=1.3.0 http://geodata.nationaalgeoregister.nl/natura2 000/ows?service=WMS&version=1.1.1&REQ UEST=GetMap&layers=natura2000:natura20 00&SRS=EPSG:28992&BBOX=107566,5517 42,118654,559150&WIDTH=1000&HEIGHT= 1000&FORMAT=image/png http://geodata.nationaalgeoregister.nl/natura2 000/ows?service=WMS&version=1.1.1&REQ UEST=GetLegendGraphic&layer=natura2000 :natura2000&FORMAT=image/png http://geodata.nationaalgeoregister.nl/natura2 000/ows?request=GetCapabilities&service= WFS&version=1.0.0 http://geodata.nationaalgeoregister.nl/natura2 000/ows?service=WFS&version=1.0.0&reque st=DescribeFeatureType&typeName=natura2 000:natura2000 http://geodata.nationaalgeoregister.nl/natura2 000/ows?service=WFS&version=1.0.0&REQ UEST=GetFeature&TYPENAME=natura2000 &BBOX=0,300000,250000,650000&maxfeat ures=1

4.3

Natura2000

.xml

.xml

.gml

Applicatie test

Als laatste kunt u binnen de applicatie de URL’s van de services bekendmaken en de service hier functioneel testen. Het uitvoeren van deze stap is applicatieafhankelijk en hierbij zult u de hulp van uw technisch applicatiebeheerder nodig hebben. Om de PDOK services te benaderen is soms configuratiewerk nodig, zoals het instellen van een proxy server. Indien er foutmeldingen komen raden wij aan eerst de services request die uw applicatie uitstuurt te testen in een browser of een losse OpenGIS tool of GIS desktop applicatie. Hiermee kunt u makkelijker verifiëren of de request van uw applicatie valide is en de output opvangen ter controle. In Firefox is de add-on Firebug handig om de request te volgen. De Fiddler Web Debugger kunt u ook gebruiken om het HTTP verkeer tussen uw applicatie en het internet te monitoren.

13


Handleiding PDOK gebruik ten behoeve van Afnemers

Recommend Documents