Handleiding PDOK gebruik ten behoeve van Afnemers

Transcriptie

1 ten behoeve van Afnemers Dit document is bedoeld voor online gebruik. Datum: 10 december 2012 Versie: 1.1 Status: definitief

2 Versiehistorie Versie Datum Wijzigingen ten opzichte van de vorige versie Startversie Links (doorverwijzingen naar uitgebreid

3 Inhoudsopgave Versiehistorie Inleiding Leeswijzer Versiebeheer Toegang tot PDOK PDOK Loket Nationaal Georegister PDOK producten URL s en metadata PDOK services Omgeving Projectie Koppelvlakken Tiling Gebruik PDOK services Connectiviteit Methode 1: Connectie testen in Browser Methode 2: Connectie testen in GIS applicatie Functionele test Applicatie test

4 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 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 4

5 2 Toegang tot PDOK Met betrekking tot het gebruik van PDOK zijn er twee belangrijke websites: 2.1 PDOK Loket Het PDOK Loket ( 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 ( Er is een forum waarin gebruikers elkaar met raad en daad terzijde staan. Dit forum bereikt u via het PDOK Loket ( 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 5

6 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 URL s en metadata PDOK services Op het PDOK Loket ( 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) ( 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 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 Tabel 1: Koppelvlakken PDOK Koppelvlak Versie Info WMTS TMS WMS / WFS (GML2) / (GML3) WCS

7 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: en op de wiki van geonovum: "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= ,920 Y= ,920;rechtsonder: X= ,920 Y=22.598,080; " Dit is dus inclusief het Nederlands Continentaal Plat (NCP). 7

8 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: 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

9 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 Output BrtAchtergrondkaart TMS URL van tile cache 0/brtachtergrondkaart/9/230/308.png8 BrtAchtergrondkaart Bestuurlijke grenzen WMTS WMS URL van tile cache GetMap (alle lagen NL) Natura2000 TMS URL van tile cache 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 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 0/natura2000/0/0/0.png8 Natura2000 WMS GetMap (Den Helder) 00/ows?service=WMS&version=1.1.1&REQUE ST=GetMap&layers=natura2000&SRS=EPSG: 28992&BBOX=107566,551742,118654, &WIDTH=1000&HEIGHT=1000&FORMAT=i mage/png Natura2000 WFS GetFeature 00/ows?service=WFS&version=1.1.0&REQUE ST=GetFeature&TYPENAME=natura2000:nat ura2000&bbox=0,300000,250000,650000&m axfeatures=1.gml (Alde Feanen) Let op: de meest actuele en complete overzicht van URL s vindt u op 9

10 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 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: 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 ( Hier zijn ook links te vinden naar de metadata van de services en de metadata van de bijbehorende data. 10

11 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 Quantum GIS ( (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 ( Aan de hand van de in Tabel 3 beschreven voorbeelden kunnen die URL s ook worden toegepast. 11

12 Tabel 3: Voorbeelden functionele test PDOK services PDOK service BRT Achtergrond kaart BRT Achtergrond kaart Type service Type Request URL Output TMS Capabilities TMS URL van tile cache BRT Achtergrond kaart BrtAchtergrondkaart WMTS TMS URL van tile cache URL van tile cache 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 Bestuurlijke grenzen WMS GetCapabilitie s lijkegrenzen/ows?request=getcapabilities&s ervice=wms&version=1.3.0.xml Bestuurlijke grenzen Bestuurlijke grenzen Bestuurlijke grenzen WMS WMS WMS GetMap (alleen laag bestuurlijkegre nzen: buurten) GetLegendGra phic voor de laag bestuurlijkegre nzen: gemeenten_20 12 GetLegendGra phic voor de laag bestuurlijkegre nzen: provincies_ lijkegrenzen/ows?service=wms&version=1.1.1&request=getmap&layers=bestuurlijkeg renzen:buurten&srs=epsg:28992&bbox= ,551742,118654,559150&WIDTH=10 00&HEIGHT=1000&FORMAT=image/png bestuurlijkegrenzen/ows?service=wms &version=1.1.1&request=getlegend Graphic&layer=bestuurlijkegrenzen:ge meenten_2012&format=image/png bestuurlijkegrenzen/ows?service=wms &version=1.1.1&request=getlegend Graphic&layer=bestuurlijkegrenzen:pro vincies_2012&format=image/png Natura2000 TMS Capabilities Natura2000 TMS URL van tile cache.0/natura2000/3/3/3.png8.xml 12

13 Natura2000 TMS URL van tile cache Natura2000 TMS URL van tile cache Natura2000 WMS GetCapabilitie s 000/ows?request=GetCapabilities&service= WMS&version=1.3.0 Natura2000 WMS GetMap 000/ows?service=WMS&version=1.1.1&REQ UEST=GetMap&layers=natura2000:natura20 00&SRS=EPSG:28992&BBOX=107566, ,118654,559150&WIDTH=1000&HEIGHT= 1000&FORMAT=image/png Natura2000 WMS GetLegendGra phic Natura2000 WFS GetCapabilitie s Natura2000 WFS DescribeFeatu retype 000/ows?service=WMS&version=1.1.1&REQ UEST=GetLegendGraphic&layer=natura2000 :natura2000&format=image/png 000/ows?request=GetCapabilities&service= WFS&version= /ows?service=WFS&version=1.0.0&reque st=describefeaturetype&typename=natura2 000:natura2000 Natura2000 WFS GetFeature 000/ows?service=WFS&version=1.0.0&REQ UEST=GetFeature&TYPENAME=natura2000 &BBOX=0,300000,250000,650000&maxfeat ures=1 Natura2000.xml.xml.gml 4.3 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