Nederlands WFS Profiel
Version 1.0
Nederlands WFS Profiel 1.0 Ravi: een profiel Ravi, netwerk voor geo-informatie Stichting Ravi is een netwerkorganisatie in het publieke domein en richt zich op de ruimtelijke ontwikkeling van Nederland. Ravi vervult een katalyserende rol bij het zoeken naar oplossingen voor maatschappelijke vraagstukken in het geo-werkveld. Hierbij stimuleert Ravi het bedrijfsleven om zich te vernieuwen en met oplossingen te komen die aansluiten bij de maatschappelijke behoeften. Ravi secretariaat Het Ravi secretariaat in Amersfoort vervult een sleutelfunctie: het ondersteunt het bestuur, initieert strategische discussies, scant nieuwe ontwikkelingen en innoveert; het secretariaat heeft een netwerk-, verwijs- en informatiefunctie.
Versie: 1.0 Datum: 27 oktober 2006 Auteur: Marcel de Rink (Ravi) Reviewers: Klankbordgroep “Geoservices profielen voor Nederlandse GII” Stichting Ravi, netwerk voor geo-informatie Postbus 508 3800 AM Amersfoort telefoon: 033 4604100 internet: http://www.ravi.nl
2
Nederlands WFS Profiel 1.0
Inhoudsopgave Versiebeschrijving................................................................................................................................. 4 1 .... Onderwerp en toepassingsgebied ............................................................................................... 5 2 .... Afkortingen ..................................................................................................................................... 6 3 .... Normatieve verwijzing ................................................................................................................... 7 4 .... Nederlands WFS Profiel................................................................................................................. 8 4.1 Verplichte kenmerken 8 Bijlage A: Toelichting verplichte kenmerken...................................................................................... 9 Bijlage B: Service Exception Codes.................................................................................................. 10
3
Nederlands WFS Profiel 1.0 Versiebeschrijving Versienummer Dit Nederlandse WFS profiel is ontwikkeld vanuit discussies en documentatie. De discussies hebben plaats gevonden tijdens de workshops, waarbij de documentatie genoemd bij normatieve verwijzing en dit profiel ter discussie heeft gestaan.
Jaar
Versienummer
Versiebeschrijving
2006
1.0
Nederlands WFS profiel
Versiebeheer Dit Nederlandse WFS profiel is niet statisch. De standaard wordt daarom onder beheer gebracht om wijzigingen naar behoefte en op basis van voorstellen gestructureerd door te voeren. Ravi, als beherende instantie, zal de wijzigingen in deze standaard registreren.
4
Nederlands WFS Profiel 1.0 1 Onderwerp en toepassingsgebied Een Web Feature Service (WFS) is een interface voor het opvragen, aanleveren en editen van geografische vector data, afkomstig van databanken, gebruik makend van Internet technologie. De WFS maakt gebruik van de op eXtensible Markup Language (XML) gebaseerde Geography Markup Language (GML) voor dataoverdracht. De specificatie voor de Web Feature Service is en wordt ontwikkeld door het Open Geospatial Consortium. In praktijk blijken ongewenste vrijheidsgraden in de WFS specificaties aanwezig. Hierdoor zijn meerdere interpretaties en implementaties mogelijk. Gevolg is dat de interoperabiliteit in gevaar komt. Om de Web Feature Services in praktijk naadloos te kunnen gebruiken, dienen bijvoorbeeld afspraken gemaakt te worden over: • op welke wijze Web Feature Services gelijktijdig informatie kunnen tonen; • de afstemming tussen de metadatastandaarden en de metadata in de Capabilities van de WFS; • standaard instellingen en functionaliteiten van de WFS verwacht vanuit een cliënt of WMS. Doel hiervan is het eenvoudig en eenduidig gebruik van de WFS in een Nationale Geo Informatie Infrastructuur waarbij de WFS is afgestemd op de overige componenten (van de NGII). Om dit doel te kunnen bereiken is dit Nederlandse WFS profiel geschreven. Tijdens de ontwikkeling van dit profiel zijn diverse ontwikkelingen vanuit het OGC meegenomen. Aangezien de techniek voortschrijdt en er aanvullingen kunnen komen vanuit Europa, vernieuwde specificaties ontwikkeld worden door het OGC en nieuwe normen ontwikkeld kunnen worden vanuit ISO, is dit profiel dynamisch van aard.
5
Nederlands WFS Profiel 1.0 2 Afkortingen CRS
Coordinate Reference System
EPSG European Petroleum Survey Group GIF
Graphics Interchange Format
GML
Geography Markup Language
HTTP
Hypertext Transfer Protocol
JPEG
Joint Photographic Experts Group
MIME
Multipurpose Internet Mail Extensions
OGC
Open Geospatial Consortium
PNG
Portable Network Graphics
SLD
Styled Layer Descriptor
URL
Uniform Resource Locator
WGS
World Geodetic System
WFS
Web Feature Service
WMS
Web Map Service
XML
eXtensible Markup Language
6
Nederlands WFS Profiel 1.0 3 Normatieve verwijzing De volgende normen en literatuur zijn gebruikt bij de definiëring van dit profiel: -
Cox, S., Cuthbert, A., Lake, R., and Martell, R. (eds.), Geography Markup Language (GML) Implementation Specification 2.0, OGC Document #01-029, February 2001,
.
-
EPSG (October 2005), European Petroleum Survey Group Geodesy Parameters, version 6.8, Lott, R., Ravanas, B., Cain, J., Simonson, G, and Nicolai, R., eds., available from
-
IETF RFC 2045 (November 1996), Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies, Freed, N. and Borenstein, N., eds., available at http://www.ietf.org/rfc/rfc2045.txt
-
GDI NRW, 2004, Specifikation – Basis-WFS-Profil, 1.0
-
OGC, OGC Web Services Common Specification, version 1.0, OGC 05-008
-
OGC, Filter Encoding Implementation Specification, version 1.1.0, OGC 04-095
-
OGC, Web Feature Service Implementation Specification, version 1.1.0, OGC 04-094
-
Ravi, 2006, Nederlandse metadatastandaard voor geografie, versie 1.1 beschikbaar op http://www.ravi.nl.
-
Ravi, 2006, Nederlandse metadatastandaard voor services, versie 1.0., beschikbaar op http://www.ravi.nl.
7
Nederlands WFS Profiel 1.0 4 Nederlands WFS Profiel Dit profiel is ontwikkeld voor het garanderen van optimale interoperabiliteit tussen Web Feature Services in Nederland. In dit hoofdstuk worden de verplichte kenmerken van de Web Feature Service beschreven. Doel van dit profiel is het definiëren van een WFS profiel wat zo eenvoudig is dat de technologische drempel voor software en service ontwikkelaars zo laag mogelijk is en tegelijkertijd zo helder dat WFS technologie voor Nederland eenduidig kan plaatsvinden.
4.1 Verplichte kenmerken 1) De Basis – WFS dient minimaal te voldoen aan de OpenGIS Web Feature Service Implementation Specification, version 1.1.0. (bij een hogere versie moet de compatibiliteit met oudere versies verzekerd zijn.) Het attribuut VERSION bevat het gebruikte versienummer. 2) De Basis – WFS dient de volgende operaties te ondersteunen: GetCapabilities, DescribeFeatureType en GetFeature. 3) De operaties GetCapabilities, DescribeFeatureType en GetFeature dienen over het HTTP/GET en HTTP/POST protocol beschikbaar te zijn. 4) Via HTTP/GET dient de mogelijkheid geboden te worden door middel van een filter een lijst van Feature(ID)s te verkrijgen. Daarnaast dient het mogelijk te zijn deze individuele features op te vragen op basis van FeatureId. 5) De WFS dient bij de GetFeature – operatie gebruik te maken van Filter Encoding Implementation Specification 1.1.0. 6) De WFS dient gebruikt te kunnen worden zonder gebruik van VENDOR SPECIFIC PARAMETERS. Wanneer via de
elementen de vendor specifieke extensies gebruikt worden, dient dit alleen te kunnen wanneer deze “SafeToIgnore” zijn. 7) De volgende projecties dienen allemaal ondersteund te worden door de WFS: a. Voor nationale toepassingen dient de data af te kunnen worden gebeeld in Amersfoort / RD New (RD-stelsel, EPSG:28992). b. Voor Europese en mondiale applicaties ondersteunt de WFS het WGS84 coördinatenstelsel (longitude, latitude geprojecteerd als rechte hoek coördinaten x, y) gebaseerd op ETRS89 (EPSG:4326). 8) De WFS dient toegankelijk te zijn via URL. 9) De WFS dient metadata over de service en data beschikbaar te stellen: a. De MetadataURL dient te verwijzen naar een metadata XML-bestand opgebouwd volgens de Nederlandse metadatastandaard voor geografie [Ravi, 2006]. b. De metadata over services dient opgeslagen te worden in de Capabilities. Voor de beschikbare metadata elementen dient de Nederlandse metadatastandaard voor services [Ravi, 2006] gevolgd te worden. 10) De WFS dient Service Exception Codes te genereren zoals weergegeven in Bijlage B : Service Exception Codes
8
Nederlands WFS Profiel 1.0 Bijlage A: Toelichting verplichte kenmerken Kenmerk nummer
Toelichting
1
Deze specificatie is geschreven op OGC WFS implementatie 1.1.0 (OGC 04-095). Indien nieuwere specificaties in de praktijk toegepast worden, wordt het profiel geactualiseerd volgens de actualisatie procedure. De relatief nieuwe WFS 1.1.0 implementatie is gekozen vanwege de technische mogelijkheden voor ondersteuning van gebruik van sectorale informatiemodellen.
7a, 7b
De verplichte projecties uit het CEN WMS profiel zijn opgenomen. De aanbevolen projecties (TM zone 31 Noord (EPSG:3043) en TM zone 32 Noord (EPSG:3044)) zijn niet opgenomen. Een toekomstige Web Coordinate Transformation Service zou hier in de toekomst een oplossing kunnen bieden. Meer aanbevolen Coördinaat Referentie Systemen worden genoemd in het Nederlands WMS profiel.
9a
De MetadataURL dient te verwijzen naar een xml-file die voldoet aan de Nederlandse metadatastandaard voor data. Deze XML file kan door de catalogue service geharvest worden waardoor gezocht kan worden op de metadata elementen. Voor elke metadataURL dient het Metadata “type” aangeduid te worden met “TC211”.
9b
In de Capabilities wordt de metadata voor services opgeslagen. Helaas is het niet mogelijk om alle verplichte elementen in de Capabilities op te slaan. De elementen die wel opgeslagen worden dienen conform de Nederlandse metadatastandaard voor services opgeslagen te worden, waarbij als type “TC211” opgevoerd dient te worden. Daarnaast wordt aanbevolen om een XML file te creëren conform de Nederlandse metadatastandaard voor services. Deze metadata dient vervolgens door een catalogue services geharvest te worden waardoor gezocht kan worden op de metadata elementen. Noot: De volgende elementen uit de Nederlandse metadatastandaard voor services kunnen niet worden opgeslagen in de Capabilities: metadata taal, datestamp, metadatastandaard naam, metadatastandaard versie, status, thema’s (kan eventueel naar keywords).
10
In Bijlage B: Service Exception Codes staan een aantal afgesproken Exception Codes voor Nederland weergegeven. Deze foutmeldingen dienen minimaal weergegeven te worden voor dit type Exceptions. Indien een Exception niet in deze lijst voor komt, dient deze Engelstalig te zijn en opgebouwd te zijn in overeenkomstige structuur met de overige Exceptions.
9
Nederlands WFS Profiel 1.0 Bijlage B: Service Exception Codes De responses van de xml “service exception” dienen gevalideerd te worden en te voldoen aan het “response schema” uit clause 8 van de OGC Web Services Common Implementation Specification (OGC 05-008).
Tabel B.1 — Standard exception codes [gebaseerd op Table 1 — Standard exception codes and meanings, ogc 05-008] Exception Code
Betekenis
OperationNotSupported
Het “request” vraagt naar een operatie die niet ondersteund wordt door de server
VersionNegotiationFailed
De lijst van versies in de “acceptVersions” parameter waarde bevat geen versie die door de server wordt ondersteund
CurrentUpdateSequence
Waarde of (optionele) “updateSequence” parameter in het GetCapabilities request is gelijk aan de huidige waarde van de service metadata “updateSequence”
InvalidUpdateSequence
Waarde of (optionele) “updateSequence” parameter in het GetCapabilities request is hoger dan de huidige waarde van de service metadata “updateSequence”
MissingParameterValue
De request bevat geen parameter waarde en de server heeft geen default waarde voor de betreffende parameter
InvalidParameterValue
De request bevat een niet toegestane parameter waarde
InvalidFormat
De request vraagt een formaat wat niet wordt geserveerd door de server
NoApplicableCode
Er wordt geen andere exception code gespecificeerd door de service. Er is geen andere exception code beschikbaar
10
