Stichting RIONED is initiatiefnemer en eigenaar van dit GitHub-project, Eric Oosterom is de verantwoordelijk projectmanager.
Vragen over deze website en het GWSW kunt u stellen via [email protected].
Versie:
20211108 - Toegevoegd hoofdstuk 3.1.3 en 3.1.4 Opmaken van datasets in QGIS en ArcGIS
20211003 – Afstemming tabel met symbolen op GWSW release 1.5.2. Zie hoofdstuk 2.3
20210802 - Toegevoegd hoofdstukken:
3.3 Publiceren van GWSW dataset op PDOK,
3.3.1 Testen van een nieuwe dataset,
3.3.2 Toekennen gebruikersrechten aan gebruiker “PDOK”.
20210521 - Tabel met symbolen bijgewerkt op basis werkgroepoverleggen
Geo-thema's gedetailleerd.
Uitlevering PDOK gespecificeerd
20201027 - Geo-thema Default gewijzigd. Zie hoofdstuk 2.1
20200528 - Specificatie selecties per thema toegevoegd
20190924 - Andere hoofdstuk indeling, tekstcorrecties
20190909 - Reviews op symbologie verwerkt, eerste versie vastgesteld. Zie hoofdstuk 2.3.
20190818 - Aangepaste URL voor nulmeting-resultaat.
20190311 - Nieuwe functie apps.gwsw.nl (menu-item GWSW Geo) opgenomen. URL's opvragen GeoPackage opnieuw gecorrigeerd.
20190308 - URL's opvragen GeoPackage gecorrigeerd
20190307 - Hoofdstuk 1 anders ingedeeld. Optie GeoPackage toegevoegd. Figuren GWSW Server bijgewerkt
20190107 - Tabel met relevante URI's verplaatst naar data.gwsw.nl
20181220 - Default symbolen voor onbekende objecten toegevoegd. Symbooltabel nu gereed om ter visie te leggen.
20181002 - Opmerkingen werkgroep overleg dd 20181001
20180908 - Thema "Nulmeting" ipv ReportVali
20180830 - Uitwerking thema Kengetallen (op basis datastory met Kadaster)
20180815 - Nieuwe URI strategie, eerste opzet generieke symbolen, uitwerking GIS-thema's
20180509 - Opmerkingen werkgroep doorgevoerd: thema's ipv views, laagindeling naar geometrievorm, symbolentabellen uitgebreid met alle GWSW-types
20180508 - Symbolen Rotterdam toegevoegd
20180416 - Opmerkingen Mark verwerkt (zie ook mailing)
20180308 - Symbolen Sweco toegevoegd
20180227 - Specificatie GIS Views toegevoegd
20171011 - Tips voor gebruik QGIS
20170602 - URL’s in tabel gecorrigeerd (geodata ipv data)
20170513 - Geactualiseerd (laatste ontwikkelingen verwerkt)
20170203 - Beschrijving Server en Geoserver samengevoegd
20170119 - Verbetering teksten
20170109 - Validatie-procedure
20161213 - Diverse aanvullingen
20161107 - Opmerkingen Matthé
20161106 - Eerste opzet
GWSW Geo - Beschrijving 1
1 Het Gegevenswoordenboek Stedelijk Water 3
1.1 Terminologie 4
1.2 Applicatie GWSW Geo 5
2 Inrichting GWSW Geo 7
2.1 Geo-thema's op GWSW Datasets 7
2.1.1 Specificaties van de Geo-thema's en GIS-lagen: 7
2.1.2 Uitlevering naar PDOK 8
2.1.3 Aanroep GWSW Geo (URI-strategie) 9
2.2 GWSW Datasets als GeoPackage downloaden 10
2.2.1 Website GWSW Apps 10
2.2.2 REST API 10
2.3 GWSW Symbolen 11
3 Toepassen van GWSW Geo 17
3.1 GWSW Geo in de praktijk (voorbeelden met QGIS) 17
3.1.1 WFS Protocol 17
3.1.2 Omvangrijke datasets in QGIS 18
3.1.3 Testen met WFS 18
3.1.4 Publicatie via PDOK 19
3.2 Presenteren Nulmeting-resultaat 20
3.3 Publiceren van GWSW dataset op PDOK 20
3.3.1 Testen van een nieuwe dataset voorafgaand aan de doorlevering naar PDOK 20
3.3.2 Toekennen gebruikersrechten aan gebruiker “PDOK” 21
Bijlage: Inventarisatie gebruikte symbolen 23
**
**
Het Gegevenswoordenboek Stedelijk Water (GWSW) is een ontologie, een speciale datastructuur die systemen (stelsels) en processen op het gebied van stedelijk waterbeheer beschrijft.
Het GWSW is een open datastandaard volgens het linked data principe die door Stichting RIONED namens de sector is ontwikkeld. Het is onderdeel van het Semantisch Web en is gemodelleerd in RDF/RDFS/OWL-2. Meer informatie daarover vindt u https://www.riool.net/gegevenswoordenboek-stedelijk-water .
Sinds medio 2015 is bij Stichting RIONED de GWSW Server in bedrijf. Deze semantische server staat onder beheer van RIONED en wordt gebruikt bij proefnemingen voor het GWSW-project.
De server biedt de mogelijkheid om de GWSW-Ontologie in combinatie met stedelijk-water-gegevens (zogenaamde datasets) te raadplegen, te ontwikkelen en toe te passen.
Er zijn vijf websites op de GWSW Server geïnstalleerd:
-
Raadplegen GWSW: https://data.gwsw.nl en https://geodata.gwsw.nl
-
Ontwikkelen GWSW: https://review.gwsw.nl/webprotege (aanroep via data.gwsw.nl)
-
Toepassen GWSW: https://apps.gwsw.nl en https://sparql.gwsw.nl
De gangbare beheersystemen zijn of worden afgestemd op uitwisseling van gegevens conform het GWSW-uitwisselingsprotocol OroX. Daarmee is het mogelijk geworden om neutrale bronbestanden (met gemeentelijke gegevens) en generieke functies in te richten. De GWSW-Server vervult daarin een centrale rol. Stichting RIONED heeft deze server ingericht voor de brede toepassing van het GWSW.
De GWSW Server vervult een rol als “SPARQL-endpoint”, SPARQL is een query-taal en service-protocol ontworpen voor de RDF/RDFS/OWL-2 database-taal. Daarmee kunnen (onder andere) gegevens vanaf de GWSW-Server worden opgevraagd. Op dit “endpoint” zijn dus zowel de ontologie als de brongegevens van gemeentes geïnstalleerd. Meer over het gebruik van het SPARQL-endpoint vindt u op https://apps.gwsw.nl .
De GWSW Server is nu nog experimenteel van aard. Het SPARQL-endpoint kan in de toekomst decentraal (bij bronhouders, regionaal) of centraal (Kadaster, VNG, private partij of toch via Stichting RIONED) geïnstalleerd worden. De GWSW ontologie blijft in beheer bij Stichting RIONED en wordt centraal ontsloten.
De GWSW ontologie is ingericht voor de discipline Stedelijk Water met de beheerders als eerste doelgroep. De gebruikte termen in GWSW Geo zijn uiteraard gebaseerd op de GWSW ontologie. Via de GIS views wordt echter gekoppeld met andere disciplines en gebruikersgroepen, dat kan verwarring in de betekenis van termen opleveren.
Het GWSW beschrijft éénduidig de gebruikte termen met bijhorende definities. Hierna volgt een toelichting van enkele GWSW-concepten waarvan de betekenis afhankelijk van de invalshoek mogelijk kan verschillen.
Rioleringsgebied
De definitie volgens het GWSW (gedeeltelijk afgeleid van IRIS-RIOKEN):
Het gebied waarbinnen één of meerdere inliggende rioolstelsel(s) het afvalwater naar één gemaal of overnamepunt transporteert/teren. Een rioleringsgebied kan een enkelvoudig gebied zijn, maar kan ook meerdere rioleringsgebieden omvatten.
Een gebied is zodanig gekozen dat het voldoende inzicht geeft in de belasting van oppervlaktewater en overnamepunt.
De aanduiding "gebied" is hier belangrijk. In het GWSW is dit een ruimtelijk object en wezenlijk verschillend van een fysiek object zoals een rioolstelsel. Een ruimte kan een fysiek object "bevatten", een rioleringsgebied bevat één of meerdere rioolstelsels.
Een rioleringsgebied kan ook andere rioleringsgebieden bevatten, het is een ruim begrip.
Bemalingsgebied
In het GWSW is als definitie (conform de NEN 3300) opgenomen:
Een rioleringsgebied waaruit het afvalwater door een gemaal wordt verwijderd.
Het is dus soort rioleringsgebied (een specialisatie daarvan), het overnamepunt wordt in dit geval gevormd door een gemaal.
In november 2016 is de eerste versie van GWSW Geo gelanceerd. De applicatie GWSW Geo levert (“serveert”) op aanvraag gegevens in geo-formaat vanuit de GWSW database. Voor het opvragen van deze gegevens wordt een datasetnaam meegegeven, meestal de gemeentenaam.
GWSW Geo is op de achtergrond een NodeJS-applicatie (oorspronkelijk was dat een Python-app) voor het uitvoeren van SPARQL queries en het omzetten van gegevens naar een presentatieformaat. GWSW Geo bevraagt het SPARQL-Endpoint, die serveert de gevraagde gegevens in JSON. Deze gegevens worden door GWSW Geo vervolgens in GML-formaat afgeleverd.
De webservice is conform het WFS protocol ingericht. Dit protocol is ontwikkeld door het Open Geospatial Consortium (OGC) en regelt het berichtenverkeer van geografische (vector)gegevens.
Het WFS protocol wordt ook in Nederland breed toegepast, het platform PDOK (publieke dienstverlening op de kaart) is daarvan een belangrijk voorbeeld. Allerlei publieke gegevens zoals het Actueel Hoogtebestand Nederland (AHN1/2) en de Basisregistratie Grootschalige Topografie (BGT) zijn via WFS eenvoudig te op te vragen.
Webservice-protocollen: WMS en WFS
Het Open Geospatial Consortium (OGC) heeft standaard protocollen voor de uitwisseling van ruimtelijke informatie ontwikkeld.
Het WMS protocol staat voor Web Map Service, daarmee kunnen kaartbeelden worden opgevraagd en kan per locatie (via een get-service) objectinformatie worden geleverd.
Het WFS protocol staat voor Web Feature Service, daarmee kunnen de individuele geo-objecten inclusief administratieve gegevens worden opgevraagd. Daarmee kan het kaartbeeld achteraf, op basis van de objectgegevens, worden opgemaakt en kunnen ruimtelijke analyses op de objecten worden uitgevoerd. Het WFS protocol voorziet ook in edit-mogelijkheden.
Voor GWSW Geo is de logische keus het WFS protocol maar dan wel in readonly-modus. De GIS gebruiker kan de GWSW data niet wijzigen maar kan wel analyses op een verzameling objecten uitvoeren.
Zoals genoemd is het WFS protocol ontwikkeld voor de uitwisseling van geografische vectordata. De data wordt als punt, lijn, vlak per “feature” meegegeven. Het WFS is dus objectgericht, in tegenstelling tot bijvoorbeeld het WMS protocol voor de uitwisseling van rasterdata.
De geografische brongegevens zijn in neutrale vorm op de GWSW Server geïnstalleerd en op te vragen met het SPARQL Endpoint (applicatie GraphDB). Met de querytaal SPARQL vraagt GWSW Geo de gegevens op en levert deze vervolgens (als service) aan de klant.
Het WFS protocol beschrijft de wijze van uitwisseling met gestandaardiseerde vragen (“requests”) en antwoorden. GWSW Geo handelt de volgende WFS-requests af:
-
GetCapabilities – GWSW Geo retourneert (in xml-vorm) een overzicht van de beschikbare gestandaardiseerde vragen.
-
DescribeFeatureType – GWSW Geo retourneert (in xsd-vorm) de definitie van de te leveren GML-bestanden. Bijvoorbeeld welke kenmerken per “feature” meegeleverd worden.
-
Getfeature – GWSW Geo maakt en verstuurt een GML-bestand met de gevraagde gegevensset.
De requests worden naar de URL van GWSW Geo verstuurd, het standaardadres is
Op basis van de vraagstelling en de te gebruiken opslaglokatie wordt vervolgens een GML-bestand aangemaakt en geretourneerd naar de vraagsteller. De GML-vorm waarin de gegevens uiteindelijk worden geleverd is een XML-bestand gericht op de uitwisseling van geografische gegevens (GML = Geography Markup Language).
De applicatie GWSW Geo levert (“serveert”) op aanvraag GWSW-gegevens conform het breed toegepaste WFS protocol. GWSW Geo biedt daarbij een keuze uit een aantal presentatievormen (thema's of in GIS-termen "group-layers") die door middel van queries (“gestandaardiseerde vragen”) afgeleid worden van de datasets op de GWSW Server.
Afhankelijk van de eindgebruiker zijn er vijf thema's gedefinieerd:
Geo-thema | Doelgroep | Omschrijving |
---|---|---|
default (zonder naam) |
Adviseurs, databeheerders | Volledige weergave van de gangbare dataset-inhoud. Bevat alle objecten met een geometrie. |
beheer | Beheerders in de afvalwaterketen |
Gebieden, hoofdriolering, overstorten, uitlaten, gemalen, randvoorzieningen. Met een uitgebreide set kenmerken. |
netwerk | Modelleur | Netwerkweergave (knooppunten, verbindingen) voor modelinstumentaria |
aansluiting | Inwoners | Aansluitleidingen perceel en kolk |
kengetallen | Beheerders in de afvalwaterketen |
Kengetallen per rioleringsgebied Wordt herzien in GWSW 1.6 |
nulmeting | Databeheerders | Rapportage nulmeting. |
In de volgende paragrafen zijn de details van de Geo-thema's beschreven.
GIS-laag | Omschrijving inhoud | Specificatie selectie | Attributen | Geo-metrie | |
---|---|---|---|---|---|
Geo-thema Default: URL = https://geodata.gwsw.nl/{dataset} | |||||
Het thema Default is bedoeld om de inhoud van gangbare GWSW-datasets zo volledig mogelijk weer te geven, bijvoorbeeld ter controle van de opbouw. Voor inrichting van het thema Default zijn de volgende uitgangspunten gehanteerd:
|
|||||
Buitengrens | Gebied, bouwwerk, put, … | Individuen met kenmerk gwsw:Buitengrens | Alle in datasets gangbare attributen | Buiten-grens | |
Punt_deel | Deksel, Overstortdrempel, Pomp, … | Onderdelen van de indivduen met kenmerk gwsw:Punt | Alle in datasets gangbare attributen | Punt | |
Punt | Put, bouwwerk, … | Individuen met kenmerk gwsw:Punt | Alle in datasets gangbare attributen | Punt | |
Lijn | Leiding, … | Individuen met kenmerk gwsw:Lijn | Alle in datasets gangbare attributen | Lijn | |
Geo-thema Beheer: URL = https://geodata.gwsw.nl/{dataset}/beheer | |||||
Gebied | Gebied, systeem, stelsel | Alle individuen met kenmerk gwsw:Gebiedsorientatie | Conform GWSW-MDS | Buiten-grens | |
Put | Rioolput | Individuen van het type (subtype van) gwsw:Rioolput. | Conform GWSW-MDS | Punt | |
Leiding | Leiding in de hoofdriolering | Individuen van het type (subtype van) gwsw:Leiding uitgezonderd (subtype van) gwsw:Aansluitleiding en (subtype van) gwsw:Goot. | Conform GWSW-MDS | Lijn | |
Lozing | Constructie met externe lozing | Individuen van het type gwsw:ExterneOverstortput of gwsw:Overstortput of (subtype van) gwsw:Uitlaatconstructie. | Conform GWSW-MDS | Punt | |
Pomp | Constructie met pomp | Individuen van het type (subtype van) gwsw:Pompput of (subtype van) gwsw:Gemaal of individuen die als deel een (subtype van) gwsw:Pomp hebben. | Conform GWSW-MDS | Punt | |
Bouwwerk | Randvoorziening, RWZI | Individuen van het type (subtype van) gwsw:Bouwwerk | Conform GWSW-MDS | Punt | |
Geo-thema Netwerk: URL = https://geodata.gwsw.nl/{dataset}/netwerk | |||||
Knooppunt | Put, compartiment, uitlaat | Individuen van het type (subtype van) gwsw:Rioolput of (subtype van) gwsw:Kolk of (subtype van) gwsw:Bouwwerk. P.M. Moet Kolk er wel in? Niet alle bouwwerken horen erbij |
Conform GWSW-Hyd | Punt | |
Verbinding | Leiding, pomp, wand | Individuen van het type (subtype van) gwsw:Leiding. P.M. Nog aanscherpen? |
Conform GWSW-Hyd | Lijn | |
Kunstwerk | Hydraulisch component pomp, wand, … | Individuen van het type gwsw:UitlaatPunt en individuen (onderdelen) van het type (subtype van) gwsw:Doorlaat of een (subtype van) gwsw:Pomp of een (subtype van) gwsw:Overstortdrempel. | Conform GWSW-Hyd | Punt | |
Geo-thema Aansluiting: URL = https://geodata.gwsw.nl/{dataset}/aansluiting | |||||
Aansluiting | Inlaat bij aansluiting | Individuen van het type (subtype van) gwsw:Inlaat die deel zijn een (subtype van) gwsw:Aansluiting. | Stelsel, Naam, Subtype, Datum, Materiaal, Afmetingen | Punt | |
Aansluiting_Put | Put en hulpstukken bij aansluiting | Individuen die deel zijn van een (subtype van) gwsw:Aansluiting en het kenmerk gwsw:Punt hebben | Punt | ||
Aansluiting_Leiding | Aansluitleiding, goot | Individuen van het type (subtype van) gwsw:Aansluitleiding of (subtype van) gwsw:Goot | Lijn | ||
Geo-thema Kentallen: URL = https://geodata.gwsw.nl/{dataset}/kengetallen | |||||
Gebied | Rioleringsgebied | P.M. (nog uitwerken, wordt herzien in GWSW 1.6) | Naam, LengteLeidingen, Buurten + conform GWSW-RioKen | Buiten-grens | |
Buurt | Buurt met CBS-gegevens | P.M. (nog uitwerken, wordt herzien in GWSW 1.6) | Naam, Rioleringsgebied, Gemeente, Wijk, AantalInwoners, AantalHuishoudens, AantalBedrijven, AantalRecreatie | Buiten-grens | |
Geo-thema Nulmeting: URL = https://geodata.gwsw.nl/{dataset}/nulmeting | |||||
Put | Put in rapport Nulmeting | Rapportmeldingen van het type vali:Violation en de property vali:punt | Naam, Subtype, Type melding, Kenmerk, Opmerking | Punt | |
Leiding | Leiding in rapport Nulmeting | Rapportmeldingen van het type vali:Violation en de property vali:lijn | Naam, Subtype, Type melding, Kenmerk, Opmerking | Lijn | |
De GWSW Server heeft een verbinding met het PDOK platform. Op dit moment staat op PDOK de dataset Stedelijk Water (ook riolering), waarin het Geo-thema Beheer is opgenomen.
Vanaf GWSW 1.6 start ook een proefneming met de uitlevering van aansluiting-gegevens, van enkele gemeenten (waaronder Den Haag) zijn die gegevens nu beschikbaar.
Daarnaast is er de wens van het Waterschapshuis om de gegevens van de afvalwaterketen op een duidelijker plek (dataset) binnen PDOK te plaatsen.
In de volgende tabel is een voorstel voor de PDOK presentatie opgenomen.
PDOK dataset | Opgenomen lagen (thema:laagnaam) | |
---|---|---|
Stedelijk Water (ook riolering) (uitlevering inclusief Waterschapsgegevens) |
Beheer:Gebied Beheer:Bouwwerk Beheer:Put Beheer:Leiding Aansluiting:Aansluiting_Leiding |
|
Waterschappen Afvalwaterketen (uitlevering Waterschapsgegevens) |
In ontwikkeling ism het Waterschapshuis |
De basis URL voor de aanroep van GWSW Geo is https://geodata.gwsw.nl/{dataset} .
Hierin wordt de term {dataset} vervangen door de naam van de betreffende opslagplaats op de GWSW Server, vaak een gemeentenaam. Standaard wordt uitgegaan van een aanvraag conform het WFS-protocol, vooralsnog wordt ook alleen dat protocol ondersteund. De aanvraag https://geodata.gwsw.nl/{dataset} wordt geïnterpreteerd als https://geodata.gwsw.nl/{dataset}?service=WFS .
Let op, de dataset-namen zijn hoofdletter-gevoelig, de naam "juinen" verwijst naar een andere dataset dan die onder de naam "Juinen". De database-beheerder zal echter in de praktijk dat soort dubbelingen vermijden.
Aan de URL worden submappen toegevoegd om de verschillende thema's te benaderen. Zie voor de submapnaam de kolom "Thema" in de vorige tabel. Bijvoorbeeld het thema "netwerk" wordt geselecteerd met de URL: https://geodata.gwsw.nl/{dataset}/netwerk .
Elk thema bestaat vervolgens uit één of meer GIS-lagen. Deze lagen zijn ingedeeld naar de object- en geometriesoort: punten (putten, uitlaten, pompputten, reservoirs), lijnen (leidingen) en vlakken (gebieden). Objecten met gelijke geometriesoort en een grote overeenkomst in attributen worden gebundeld in een GIS-laag.
Een GeoPackage bevat een gestandaardiseerde opslag van geografische data in een SQLite database-container. Het kan zowel vector- als rasterdata bevatten. Net als het WFS protocol is ook GeoPackage een ontwikkeling van het Open Geospatial Consortium (OGC). Een GeoPackage bestaat fysiek uit één bestand met de extensie .gpkg. De gangbare GIS'en kunnen een GeoPackage laden, die optie staat dan vaak onder menu-items als "Open database".
De GWSW Server levert een GeoPackage-bestand op basis van de opgegeven GWSW Dataset. Ook hier zijn de Geo-thema's toepasbaar (zie vorige paragraaf).
Een verzoek aan de GWSW-server voor levering van een GeoPackage-bestand gebeurt op https://apps.gwsw.nl , onder menu-item GWSW Geo. Op basis van de GWSW Dataset en het gewenste Geo-thema downloadt u een GeoPackage-bestand.
Dezelfde functionaliteit is ook beschikbaar als REST service, voor de rechtstreekse aanroep vanuit een webbrowser of andere applicaties gebruikt u de volgende aanroepen:
P.M. : Nog uitwerken conform OAS3
Een GeoPackage wordt bij de GWSW Server opgevraagd met:
HTTP method = GET
URL = https://geodata.gwsw.nl/{dataset}[/{thema}]?request=getGeoPackage . Het Geo-thema is ook hier optioneel, als het ontbreekt wordt het default thema gebruikt.
Response-inhoud bij HTTP 200 = HTML string met een proces-id, de proces-status en de URL voor de vervolgaanvraag. De proces-status kan zijn "running" of "error".
Met het proces-id (een nummer) is de status van de bewerking op te vragen:
HTTP method = GET
URL = https://geodata.gwsw.nl/{dataset}[/{thema}]?request=getGeoPackage&process={proces-id} .
Response-inhoud bij HTTP 200 = HTML string met een proces-id, de proces-status en de URL voor de vervolgaanvraag. De proces-status kan zijn "running", "error" of "succeeded".
Als de status "succeeded" is bereikt wordt het GeoPackage opgevraagd:
HTTP method = GET
URL = https://geodata.gwsw.nl/{dataset}[/{thema}]?request=getGeoPackage&process={proces-id}&download .
Response-inhoud bij HTTP 200 = Binair bestand Geopackage.
In de bijlage staat een globale inventarisatie van de in gebruik zijnde symbolen binnen het vakgebied Stedelijk Water. Die verzameling toont aan dat er geen sprake is van (nationale) consensus over de toepassing van deze symbolen. Met de GWSW Symbolen willen we die brede consensus wel bereiken.
Uitgangspunten
-
De GWSW Symbolen omvatten de symbolen voor objecten met punt-geometrie, de kleuren en lijndikte voor objecten met lijn-geometrie en de inkleuring van objecten met vlak-geometrie
-
De GWSW Symbolen zijn altijd gekoppeld aan het objecttype, alleen dat objecttype bepaalt het te hanteren symbool
-
De GWSW Symbolen zijn afgestemd op geografische presentaties op globale schaal. Bij gedetailleerde GIS-presentaties is het bijvoorbeeld mogelijk om bij inzoomen te variëren in lijntype zodat de kleuren niet meer het enige onderscheid vormen. Voor GWSW Geo, gericht op GIS presentaties, is vooralsnog gekozen om eenvoudige basisvormen voor de meest voorkomende objecttypes aan te houden. We gaan uit van een presentatie op globale schaal.
Uit de uitgangspunten wordt al duidelijk dat de GWSW Symbolen zich beperken tot de basisvorm. Er is natuurlijk altijd ruimte voor externe applicaties om de geo-stijl verder uit te werken in combinatie met de gewenste GIS-analyse.
Afstemming op de Nederlandse CAD Standaard voor de GWW-sector (NLCS)
Zie voor het NLCS: https://www.gww-nlcs.nl/
De gehanteerde lijnkleuren bij leidingtypes zijn conform de NLCS, waar nodig aangevuld met nieuwe leidingtypes waar de NLCS op wordt afgestemd. In dat laatste geval is dat in de tabel vermeld.
De NLCS-lijntypes zijn specifiek op CAD afgestemd, die zijn minder bruikbaar voor GIS presentaties met GWSW Geo. Voor GWSW Geo gebruiken we alleen de doorgetrokken lijn.
De putsymbolen zijn afgestemd op de meest voorkomende in schematekeningen (‘best practice”). De NLCS-putsymbolen zijn specifiek op CAD afgestemd, die zijn minder bruikbaar voor GIS presentaties met GWSW Geo.
Voor de terminologie van puttypes en leidingtypes is het GWSW leidend, de NLCS wordt hierop afgestemd.
De volgende tabel bevat de GWSW Geo Symbolen per Geo-thema. Aan enkele put- en leidingtypes is nog geen uniek symbool of lijntype toegekend, daarvoor geldt vooralsnog het default symbool of lijntype. Wijzigingen in presentaties tov de voorgaande versie van het document zijn in rood aangegeven
**
**
De aanroep van GWSW Geo vanuit een GIS-applicatie (zoals QGIS) is eenvoudig. Geef in QGIS de WFS-verbinding een naam en vermeld vervolgens de URL van GWSW Geo. Aan de URL alleen nog de te gebruiken dataset (gemeentenaam) toevoegen, in dit voorbeeld Juinen.
Vervolgens ontvangt QGIS van GWSW Geo een overzicht van de mogelijke GIS-lagen:
Na keuze van de lagen (selecteer ze allen en gebruik de knop “Toevoegen”) maakt het GIS nieuwe gegevenslagen aan met daarin de opgevraagde gegevens. QGIS verwerkt hiertoe het door GWSW Geo aangeleverde GML-bestand.
Gebruik daarna zo nodig de knop A om in te zoomen op de nieuwe GIS-lagen en de knop B om gegevens ("attributes") op te vragen per object (“feature”).
Via het WFS protocol:
Voor grote hoeveelheden objecten kan een WFS-aanvraag vrij lang duren, bij het opvragen van bijvoorbeeld meer dan 30.000 putten kan de “time-out voor netwerkaanvragen (ms)” de standaard waarde van 60000 (= 60 sec) overschrijden. Verhoog deze waarde dan naar bijvoorbeeld 600.000 (= 6 min). De parameter is te vinden onder menu-item Extra/Opties/Netwerk.
Via een GeoPackage database (zie hst. 1.2):
De GWSW Server kan de geoinformatie van een dataset ook als GeoPackage leveren. Dat is ook relevant bij omvangrijke datasets. Een GeoPackage database is in QGIS (en andere GIS'en) te openen:
Op de website https://apps.gwsw.nl/ wordt de GWSW Geo symbologie beschikaar gesteld in SLD-vorm (OpenGIS Styled Layer Descriptor). Zo’n SLD bestand is eenvoudig te laden in QGIS en bijvoorbeeld Geoserver. Daarbij worden de symbolen rechtstreeks vanaf de GWSW server gedownload en is daarmee altijd gekoppeld aan de actuele GWSW Geo symbologie. De SLD’s zijn direct te downloaden via https://apps.gwsw.nl/doc/GWSW%20Geo%20symbologie.zip
Voor het toekennen van de styling aan de kaartlagen wordt vanuit de laageigenschappen de SLD geladen met de functie “Stijl laden”
De opmaak wordt dan geactieveerd en de symbolen worden ingeladen vanaf de GWSW Server.
Door een fout in de SLD module van QGIS wordt het Default filter niet goed ingeladen, er wordt namelijk geen filter toegekend vanuit de SLD. Dit kan hersteld worden door dubbel te klikken op de Default regel en het filter te veranderen in Anders, de filterwaarde ELSE wordt nu correct toegekend.
Objecten die nu niet voldoen aan de filters voor de GWSW Geo symboliek krijgen de default styling mee. Hierdoor worden altijd alle aanwezige objecten in de dataset opgemaakt en weergegeven op de kaart.
Voor gebruik in ArcGIS Pro wordt nog gewerkt aan het opzetten van een style bilbiotheek, de huidige layerfiles op de website zijn verouderd en sluiten daarmee ook niet meer naadloos aan op GWSW Geo.
Voor testwerk kan ook de "count" parameter aan de WFS-URL worden toegevoegd. Deze parameter
bepaalt het maximum aantal in te lezen features per GIS-laag. In QGIS wordt die parameter als volgt meegegeven:
Alvorens een dataset van een gemeente wordt toegevoegd aan de lijst voor doorlevering naar PDOK, wordt eerst getest of het bestand correct kan worden omgezet naar gpkg-bestand op basis van het GWSW-Geo thema Beheer.
De GWSW Server levert periodiek de gewijzigde datasets aan de PDOK Server, dit bestand bevat alle datasets waarvan de eigenaar publicatie op PDOK heeft toegestaan.
Zodra er een nieuwe upload is gedaan wordt dezelfde avond (om 23:00h) een nieuw Geopackage aan PDOK aangeboden.
Zie verder https://www.pdok.nl/viewer/ , selecteer daar de dataset "Stedelijk Water (ook riolering)". De gegevens worden zichtbaar na voldoende inzoomen, bijvoorbeeld op de gemeente Den Haag of Utrecht.
Met behulp van de GWSW Apps kan de gegevenskwaliteit getoetst worden aan de kwaliteitsnormen die in de GWSW Ontologie zijn opgenomen.
De toetsing van de kwaliteit gebeurt binnen een bepaald toepassingsgebied. Binnen het GWSW wordt dit aangeduid met de “conformiteitsklasse”. Een verzoek aan de GWSW-server voor de nulmeting gebeurt op https://apps.gwsw.nl/
De resultaten van de nulmeting kunnen vervolgens via GWSW Geo in geografische vorm worden getoond. Gebruik daarvoor in een GIS-systeem de volgende wfs-aanroep:
https://geodata.gwsw.nl/{dataset}/nulmeting
De parameter {dataset} is de naam van de dataset waarop de Nulmeting is uitgevoerd. De procedure is identiek aan het eerder behandelde wfs-protocol. De URL wordt na afronding van de GWSW Nulmeting op de website https://apps.gwsw.nl getoond. Het eenvoudigste is die URL-tekst te kopiëren voor de WFS-aanroep vanuit het GIS. GWSW Geo gebruikt voor de presentatie het nulmeting-rapport, dat is een database met onder andere resultaten per geo-object. Zo'n rapport wordt naar verloop van tijd opgeruimd, in dat geval is vooraf een nieuwe nulmeting noodzakelijk.
Op de GWSW-server wordt dagelijks een scan uitgevoerd voor bestanden die in aanmerking komen voor een upload naar PDOK. Het gaat hier om .ttl-bestanden van gemeenten die toestemming hebben gegeven om de data op PDOK beschikbaar te stellen. De scan wordt door de app GwswServer (Javascript “GwswServer.js” in de submap C:\MiscApps\NodejsApps\NodejsGWSW) uitgevoerd op de data in de GraphDB database. Binnen de GraphDB database is een gebruiker aangemaakt met de naam “PDOK”. De app GwswServer identificeert de GWSW Datasets waarop de gebruiker “PDOK” leesrechten heeft gekregen.
Nadat de bestanden door de app GwswServer voor upload zijn geïdentificeerd worden deze geconverteerd naar het .gpkg-formaat. Daarna worden de bestand samengebracht in één bestand. Dit is één .gpkg-bestand waarin de bestanden van meerdere gemeenten kunnen worden ondergebracht. Het gezamenlijke .gpkg-bestand wordt klaargezet op de GWSW-server voor upload naar PDOK. (Vanuit de optiek van PDOK-server betreft dit een download naar PDOK) De download wordt door PDOK gestart, zodra de app GwswServer een verzoek daartoe verstuurt. D.w.z. de app GwswServer stuurt het verzoek en PDOK initieert vervolgens de download. Dit gebeurt op een rustig tijdstip (rond 23:00 uur) PDOK stuurt bericht terug dat de download geslaagd is.
De GraphDB-Administrator (Admin) stelt de rechten in voor de gebruikers van de GraphDB database, waaronder de rechten van de gebruiker “PDOK”. Wanneer een gemeente toestemming geeft om hun dataset te publiceren op PDOK, krijgt de gebruiker “PDOK” leesrechten op het betreffende bestand. De procedure voor Admin om gebruikersrechten toe te kennen aan gebruikers, is beschreven in hoofdstuk 3.3.2
Alvorens een dataset van een gemeente wordt toegevoegd aan de lijst voor doorlevering naar PDOK, wordt eerst getest of het bestand kan worden omgezet naar gpkg-bestand. Nadat het nieuwe gpkg-bestand is gecreëerd, wordt dit bestand ter controle ingelezen binnen een GIS-applicatie. Het gpkg-bestand wordt aangemaakt met de apps GWSW Geo op de GWSW-website met de URL https://apps.gwsw.nl Vervolgens wordt het gpkg-bestand getest met de applicatie QGIS. De volgende acties worden uitgevoerd om het gpkg-bestand te creëren:
1. Op de startpagina van https://apps.gwsw.nl wordt het veld <Geef de naam van de dataset>
ingevuld met de bestandsnaam van de betreffende gemeente. (Doorgaans is de bestandsnaam
gelijk aan de naam van de gemeente)
2. Nadat het bestand is herkend, verschijnt onder dit veld de tekst <Dataset aanwezig>. In de
menubalk van de startpagina kan nu de apps <GWSW Geo> worden geopend.
3. Op de webpagina van GWSW Geo wordt binnen het veld <Geef de naam van de dataset> de
bestandnaam van de gemeente, die is ingevoerd op de vorige webpagina, automatische ingevuld. Wanneer dit niet gebeurt, kan de naam van het bestand handmatig worden ingevoerd in dit veld.
4. Nadat de bestandsnaam in het veld <Geef de naam van de dataset> is ingevuld, worden de twee
keuzes gemaakt om het juiste gpkg-bestand te genereren: Dit zijn:
- Toe te passen geo-thema: <Beheer>
- Type geografisch bestand: <GeoPackage (gpkg)>
5. Het button <Download geo-bestand> wordt geactiveerd. Het gpkg-bestand wordt aangemaakt
en overgebracht naar de download-submap op het systeem van de beheerder.
Het nieuwe gpkg-bestand wordt nu gecontroleerd door dit in te lezen binnen de GIS-applicatie QGIS. In het hoofdmenu van QGIS wordt gekozen voor <Kaartlagen>. Vanuit dit submenu wordt gekozen voor <Laag toevoegen> en <Vectorlaag toevoegen> In het submenu <Vectorlaag toevoegen> wordt de bestandsnaam van het gpkg-bestand ingevoerd binnen het veld <Dataset>. Vervolgens wordt het button <Open> geactiveerd. Hierna verschijnt het submenu <Selecteer toe te voegen vectorlagen>. In dit submenu wordt gekozen voor <Alles selecteren> en <OK>. Het gpkg-bestand wordt ingelezen binnen QGIS en de gekozen vectorlagen verschijnen in de linker menubalk. Het gpkg-bestand kan nu zichtbaar worden gemaakt binnen QGIS.
De GraphDB-Administrator (admin) kent de leesrechten toe aan GWSW-gebruiker “PDOK”. Alle nieuwe en gewijzigde datasets waar de gebruiker “PDOK” leesrechten heeft gekregen, worden uitgeleverd aan PDOK. De volgende acties worden uitgevoerd om een dataset toe te voegen aan de lijst voor uitlevering naar PDOK:
1. Er wordt aangelogd op GraphDB als Admin
- Start : https://sparql.gwsw.nl <Login>
- Gebruikersnaam : admin
- Wachtwoord :
2. Selecteer in linker menu <Users and Access>
3. Zoek op deze webpagina in de kolom Username naar het user-id naar “PDOK”. Ga in de regel van het user-id “PDOK” naar <Edit user>. Vervolgens komt men op de webpagina “Edit user: PDOK” / “Repository rights”.
4. Zoek binnen “Repository rights” naar de naam van de nieuwe dataset. Hier worden twee buttons weergegeven voor respectievelijk de “read” en “write” rechten van het user-id “PDOK” op de nieuwe dataset.
5. Markeer het button voor “read” rechten (geef “read” rechten aan het user-id “PDOK”) en ga naar linksonder op deze webpagina.
6. Selecteer <Save> om de rechten voor “PDOK” op te slaan. Rechtsonder op de webpagina verschijnt de mededeling “The user-id PDOK was updated”.
Er is geen nationale concensus over de toepassing van standaardsymbolen voor de objecttypes Stedelijk Water. Er zijn dan ook veel verschillende symboolsets in gebruik. De NLCS geldt als CAD standaard voor de Nederlandse GWW-sector maar wordt in de stedelijk water wereld nauwelijks toegepast.
In de volgende tabellen zijn de te onderscheiden objecttypes opgenomen met daarbij voorbeelden van de gebruikte symbolen.
Tabel: Soorten put
Tabel: Soorten onderdeel
Tabel: Soorten bouwwerk
Tabel: Soorten leiding