BGT Vectortiles (OGC API)

[Anouk]

BGT nu ook beschikbaar als VectorTiles via PDOK (OGC API)

PDOK stelt in opdracht van de Basisregistratie Grootschalige Topografie (BGT) de OGC API Tiles en OGC API Styles beschikbaar voor iedereen. VectorTiles is een relatief nieuwe OGC API standaard voor het maken van verbeeldingen die door systemen zijn te gebruiken. Hiermee kun je als afnemer oneindig veel visualisaties zelf maken en deze integreren in toepassingen zoals viewers en applicaties. Om die reden vind je binnen de VectorTiles veel informatie van BGT-objecten. Voor een vliegende start zijn varianten van de standaard- en achtergrondvisualisaties beschikbaar gesteld, die ook naar eigen inzichten kunnen worden gewijzigd.

Waar kan je de BGT VectorTiles OGC API vinden?

De BGT VectorTiles OGC API’s zijn te vinden op de website van PDOK of direct te benaderen via https://api.pdok.nl/lv/bgt/ogc/v0_1/ . Vanuit dit startpunt kan je als afnemer navigeren naar onder andere de OGC API Tiles en OGC API Styles.

Om afnemers een eerste beeld te geven is een demoviewer beschikbaar waarin deze VectorTiles zijn opgenomen. Een demonstratie van de demoviewer is tijdens de Open Geo Informatiedag 2022 bij Geonovum gegeven.

Huidige realisatie

De BGT VectorTiles (OGC API) zijn beschikbaar gesteld in een eerste versie. De data bevat actuele objecten en attributen in RD-formaat en wordt tweewekelijks (maandag en donderdag) bijgewerkt. Nog niet alle onderdelen uit deze specificaties zijn geïmplementeerd. Een deel hiervan wordt nog gepland en een deel is achterwege gelaten omdat deze niet van toepassing of nuttig is (wat aansluit bij het modulaire aspect van de OGC API’s).
De onderdelen die nu wel geïmplementeerd zijn staan expliciet als “conformance classes” benoemd in het conformance endpoint. Wanneer wordt voldaan aan een conformance class, dan is ernaar gestreefd om zoveel mogelijk recommendations te volgen.

Noemenswaardige conformance classes waaraan is voldaan zijn:

• Common: JSON - de JSON encoding voor de machine-to-machine communicatie.
• Styles: Core – de (metadata over) beschikbare styles.
• Styles: Mapbox – het Mapbox formaat op basis waarvan de styles worden uitgeserveerd.
• Tiles: Core - de TilematrixSet op basis waarvan de Tiles worden geserveerd op een matrix/row/col dan wel z/x/y endpoint, met NetherlandsRDNewQuad.
• Tiles: TileSet en Tiles: TileSets List – de (metadata over) de beschikbare Tilesets.
• Tiles: Mapbox Vector Tiles – het MVT formaat wat gebruikt wordt om de Tiles te serveren.

Noemenswaardige conformance classes waaraan nog niet is voldaan zijn:

• Common: Core - het valideren van query parameters gebeurt nog niet. De rest van deze conformance is wel geïmplementeerd.
• Common: HTML – vooralsnog is op machine-to-machine communicatie gefocust en daarvoor is Common: JSON geïmplementeerd.
• Common: OpenAPI 3.0 - de OpenAPI specificatie is nog niet geserveerd in HTML, enkel in JSON formaat.

Toekomstige ambitie

PDOK wil voldoen aan de OGC API Tiles specificatie, maar deze is nog in ontwikkeling waardoor de BGT Vectortiles (OGC API) zal blijven meebewegen. Dit betekent dat aan de huidige versie nog non-breaking onderdelen kunnen worden toegevoegd zoals de ontbrekende conformance classes, verhogen van updatefrequentie en andere projecties.

Daar waar wel sprake is van een breaking change zal PDOK de API middels een nieuwe versie aanbieden. Aankondiging hiervan vindt via de gebruikelijke kanalen (website, geoforum en twitter) plaats, waarbij afnemers een half jaar de tijd krijgen om over te stappen naar de nieuwe versie.

Deel je op dit forum je ervaringen?

[ebeere]

Beste @Anouk,

Betekend het dat we de BGT net als de BAG binnenkort als WFS kunnen downloaden?

[wouter.visscher]

@ebeere

Betekend het dat we de BGT net als de BAG binnenkort als WFS kunnen downloaden?

Nee, de BGT Vectortiles zijn ‘alleen’ geschikt voor de verbeelding/visualisatie/stylen. De geometry van de objecten binnen de vectortile zijn ook versimpeld (dit is inherent met het gebruik van deze technology) er zijn dan ook niet van dezelfde kwaliteit als die uit de download API komen.

Het betreft hier ook de OGC API Tiles, niet de OGC API Features, dus operaties/calls als GetFeatureByID, Paging, enz… zitten ook niet in dit koppelvlak. Het betreft een ZXY koppelvlak als bijvoorbeeld WMTS.

[Anton]

In de demo viewer zijn de labels de verkeerde kant op geroteerd:

[roela]

De hoek bij de labels is op dit moment in graden counterclockwise. Mapbox styles verwacht clockwise. De demo viewer zullen we voorlopig aanpassen om het te converteren. We bekijken nog even hoe we dit handig oplossen.

[Anouk]

Ik ben toch wel benieuwd hoe de ervaringen zijn met deze nieuwe service? Zijn er nog meer bevindingen in de GeoCommunity?

[Anton]

Ik heb nog geen tijd gehad om er naar te kijken. Ben ook wel benieuwd. Is er ook te zien hoe vaak de service al wordt aangeroepen?

[Anouk]

Jazeker kunnen we dat, maar in de rapportage zal deze in Q4 worden opgenomen.

[Anouk]

Op de website van PDOK is de eerste productieversie van de vectortile viewer toegevoegd. Kijk op https://www.pdok.nl/
Wil je direct een blik werpen zonder te surfen, kijk dan hier: PDOK Vectortiles Viewer.

[Erik]

Tot voor kort gebruikte ik de demo versie met tiles in mercator projectie tot veel genoegen, maar die is helaas niet meer beschikbaar. En tot mijn spijt maakt de productieversie gebruik van RD, hetgeen in veel SW niet handig is. Bijv. maplibre ondersteunt alleen mercator projectie. Momenteel moet ik dus gebruikmaken van mijn zelf gehoste vector tiles (o.b.v. een script dat gebruikmaakt van maptiler).

Is er al een datum bekend waarop de mercator projectie aangeboden gaat worden?

[Anouk]

Hai Erik, dank voor je reactie en je vraag.
Inderdaad zijn de BGT vectortiles (nog) niet hetzelfde als de demoversie. Er is nog geen geïntegreerde BRT-BGT bron in productie en inderdaad geen webmercator, daarentegen is er wel een verhoogde actualiteit en tonen we landsdekkende informatie met de BGT.

Wij zijn op dit moment bezig om enkele issues met de BGT vectortiles te onderzoeken, waaronder de webmercator projectie. Dit doen we in het kader van de realisatie van de BAG vectortiles die we in Q1 hopen te lanceren. Daarna gaan we met deze nieuwe inzichten kijken of we daarmee ook de BGT kunnen verbeteren. Die verbeteractiviteiten staan gepland in Q2, maar das wel een PLANNING of misschien beter: onze ambitie!

[Erik]

Dankjewel Anouk voor je snelle reactie. Helaas is de wachttijd op de tiles wat minder positief - wat is eigenlijk de hoofdreden dat dit zo lang duurt? Het lijkt namelijk iets tamelijks eenvoudig om een tweede folder te genereren met de tiles in mercator projectie, hetgeen in de meeste tools zelfs de standaard is (dus RD gebruiken lijkt me meer werk te kosten).

[Anouk]

Je aanname is niet correct.
Voor de realisatie van de OGC API Tiles en Styles wordt een volledig nieuwe verwerking bij PDOK neergezet. Het doel is om op termijn elke dataset met haar specifieke kenmerken op basis hiervan te realiseren. De BGT als RD-brondata kenmerkt zich door de enorme omvang van de data. Een foldertje erbij zou je denken, dat klinkt simpel, maar is het niet. Want alles moet wel in tegels opgevraagd kunnen worden.
Houd svp nog even vol, we zien al lichtpuntjes voor komend kwartaal.

[Anouk]

Webmercator???
Check inmiddels de lancering van de meest recente API’s op: PDOK lanceert de BGT Vector Tiles (OGC API) 1.0 versie en op: BAG nu ook beschikbaar als Vector Tiles via PDOK (OGC API’s).

Voor de early adopters (afnemers van de 0.1 versie) graag zo snel mogelijk overstappen naar deze api’s. Zoals vermeld voldoen deze volledig aan de specificaties en ontvang je meer functionaliteit!