Onze techniek

Open Source Software
We verantwoorden uitgebreid waar we het kaartmateriaal en de andere gegevens vandaan hebben gehaald. Een project als dit was onmogelijk geweest zonder open source software componenten. Die verdienen ook een bronvermelding. En misschien ben je ook nieuwsgierig hoe we dit gebouwd hebben. Daarom hier een beknopt softwarearchitectuurdocument. We weten dat met onbeperkte middelen een veel mooiere architectuur mogelijk is. Toch zijn we trots op wat we met zeer beperkte middelen hebben opgezet.
De Database
We gebruiken een iets aangepaste variant van het Switch to OSM voorbeeldproject. Het belangrijkste verschil is dat we voor de onderhoudbaarheid van de installatie de processen in Docker containers draaien. Het onderhoud van de database en de tileserver draaien ieder in een aparte container. Zo houden we de op OpenStreetMap gerichte afhankelijkheden binnen de containers en kan het geheel op een kale server draaien. De andere software componenten draaien overigens ook in Docker containers. De PostgreSQL 15 database engine draait op de Docker host die voor database server speelt. Dit is omdat dat veel goedkoper is dan een aparte database server te gebruiken.
De database is een gewone osm2pgsql database van Europa. Omdat die ook de tiles voor de website moet leveren zijn de coördinaten in WebMercator projectie. Naast de standaard osm2pgsql tabellen houden we de eigenschappen van de relations en hun bounding box bij. (Met een SQL script dat we na de OpenStreetMap updates draaien.) Die informatie hebben we nodig om de (wandel)routes weer te geven. Om beter bij naam te kunnen zoeken hebben we standaard Postgres trigram indexen op de name kolommen van de osm2pgsql database gezet. Dat maakt het bijwerken van de database wat langzamer, maar het zoeken veel sneller.
Tile Server
Voor de website draaien we een gewone OpenStreetmap tileserver. (Apache, mod_tile, renderd, mapnik.) Vanwege de snelheid (traagheid) van het bijwerken door renderd beperkten we het diepste zoom-niveau tot 13. De Tile Server draait in een Docker container achter een Apache reverse proxy.
Feature Server
Voor het zoeken op de website ontwikkelden we een Feature Server. Functioneel is die enigszins verwant aan een WFS server, maar alle details zijn anders. De query-taal is gebaseerd op CSS selectors. Dat komt doordat een eerdere versie was geïnspireerd door de Overpass server. De queries worden uitgevoerd op de osm2pgsql database en de antwoorden zijn altijd een FeatureCollection in GeoJSON formaat. Dit is een ad-hoc Java software component gebaseerd op Spring Boot, JAX-RS, Java Topology Suite (JTS), een beetje GeoTools, plain JDBC, PostGIS en PostgreSQL. (Standaard persistence frameworks zijn niet zo geschikt voor ad-hoc geografische queries.) Voor het schrijven van GeoJSON ontwikkelden we een Jackson module die netjes wordt opgepikt door het Service Provider Interface. De Feature Server draait in een Docker container achter een Apache reverse proxy.
Map Server
De kaarten tekenen we met een speciaal daarvoor ontwikkelde Map Server. Die produceert, in tegenstelling tot een WMS server, geen tegels voor in de web browser, maar hele kaarten in PDF- of SVG-formaat. Om een kaart te maken combineert de Map Server de routegegevens uit de OpenStreetmap database met een zelf getekende achtergrondkaart. De Map Server is een ad-hoc Java software component gebaseerd op Spring Boot 4, JAX-RS, Java Topology Suite (JTS), GeoTools, OpenHtmlToPDF, PDFBox, PDFBoxGraphics2D en de eigen Feature Server. Hoogtelijnen, hoogte-vermeldingen en reliëf-schaduwen leiden we direct af van de Sonny's LiDAR Digital Terrain Models of Europe gegevens. De Map Server draait in een Docker container achter een Apache reverse proxy.
Bestellingen
De Bestellingen component is een saaie administratieve ad-hoc Java software component met een Back-End gebaseerd op Spring Boot 4, JAX-RS, Thymeleaf, OpenHtmlToPDF, PDFBox, MyBatis, PostgreSQL, Java Mail en de Mollie payments Java API. De Bestellingen component handelt de bestellingen af en laat de Map Server een PDF kaart maken die kan worden gedownload. De klant krijgt een email met een factuur en download-links naar de PDF kaart en de factuur. De Bestellingen component draait in een Docker container achter een Apache reverse proxy.
De Front-End van de bestellingen-component is onderdeel van de Angular Front-End Web Applicatie.
Web Applicatie
De Web Applicatie is een Single Page webapplicatie gebaseerd op Angular 22, Bootstrap 5, OpenLayers, GeoJSON en proj4js. Alle communicatie van de Web Applicatie passeert door een Apache webserver: die dient ook als reverse proxy voor de andere componenten.
Web Server
We draaien een Apache web server in een Docker container. Al het HTTP(S) verkeer komt daar terecht. Dit is om een veiliger gevoel te hebben: Iemand die het lukt om in de webserver in te breken breekt in in een kooi. Om de rest van de wereld te bereiken moet hij ook nog uitbreken uit de container naar de host. De Web Server geeft toegang tot de statische Angular applicatie en de file downloads. Verder geeft hij als reverse proxy alle aanroepen naar de andere componenten door. Het HTTPS certificaat wordt met Let's Encrypt beheerd. De standaard Let's Encrypt certbot distributie komt als snap. Die werken niet goed in containers. Daarom gebruiken we de basisversie.
Inrichting
Het geheel draait op Debian Linux 12 (bookworm) in een forse VPS. (16 cores, 48GB RAM, 1.5TB SSD). De Docker container images zijn gebaseerd op debian:bookworm-slim. Dat kan economischer. We kozen Debian omdat de OpenStreetMap componenten daar standaard in zitten. En het voelt ook wel veilig in alle containers hetzelfde OS te draaien. Performance is bevredigend, maar het kan beter. Dat komt vooral doordat de SSD wat langzaam is voor de database. Om op tijd klaar te zijn met tekenen van de OpenStreetMap tegels voor de web applicatie hebben we het zoom-niveau beperkt tot 13.
Het geheel is een systemd service die niet veel meer doet dan docker-compose aanroepen voor het starten van de verschillende (stateless) containers. Het bijwerken van de osm2pgsql database en het hertekenen van de tegels wordt in de host gestart door een cron-job. De processen zelf draaien in de database- en tile-server Docker containers.