Kaart-tiles: weg bij CARTO (API-key-watermerk) naar vectortiles met eigen label-vrije stijl #145
Labels
No labels
blocked
bug
design
documentation
duplicate
enhancement
future
good first issue
help wanted
invalid
question
refactoring
tracker
wontfix
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set
Reference
jelmer/topoquiz#145
Loading…
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Probleem
CARTO serveert sinds kort een "API KEY REQUIRED"-watermerk over alle basemap-tiles zonder API-key. Geverifieerd op
rastertiles/voyager_nolabels(wat we gebruiken) enrastertiles/light_nolabels: HTTP 200, watermerk in de PNG gebakken. Geen foutcode om op te vangen — de kaart is zichtbaar vervuild, ook op productie.Randvoorwaarden
A7het antwoord), waternamen en landnamen.Afgevallen opties
tile.openstreetmap.org)USE_CARTO_TILES=false-tak)Richting: vectortiles + eigen label-vrije stijl
Bij vectortiles bepalen we de stijl zelf: volledige topografische inhoud, tekstlagen uit.
Precedent: Home Assistant is om dezelfde reden van CARTO weg en gebruikt nu OSM-tiles achter een cachende proxy (
homeassistant/components/map_tiles/), met identificerendeUser-Agentomdat OSM referer-loze browserrequests blokkeert.Bevindingen:
water-ocean,land-residential,land-agriculture,street-*, gebouwen).maplibre-glv6.10.0 +@maplibre/maplibre-gl-leafletv0.1.4 (beide actueel) -> vectorlaag binnen de bestaande Leaflet-kaart; geojson-lagen, markers en klik-logica blijven ongemoeid.De app gebruikte oorspronkelijk
topomania-nonames— een echte topokaart zonder namen. Dezelfde gedachte, op eigen voorwaarden.Tilebron-afweging
Gemeten op dezelfde tile (z10/525/337), gzipped:
cache-controlDuurzaamheidsrisico is begrensd, en anders van aard dan bij CARTO. Dit zijn geen commerciele free tiers die naar betaald kunnen omklappen, maar donatie-gefinancierde publieke infrastructuur. Het risico is capaciteit/blokkade bij zwaar gebruik, niet een prijskaartje. Onze belasting is klein (87 bezoeken/30 dagen). En de uitweg is echt: Shortbread is een gedeeld schema, dus overstappen kost een URL-wijziging — en VersaTiles is volledig zelf-hostbaar, met een documentatiepagina specifiek voor Uberspace.
Voorstel: VersaTiles als primair (kleiner, cachet vriendelijker, EU-hosting), OSM als tweede bron, zelf-hosten als achtervang.
Plan
dev, stijl met tekst/icoonlagen gestript. Verifieren op NL-sets en wereldsets, en vooral dat klik-op-de-kaart exact blijft werken.User-Agent/Refereren caching conform de bronpolicy. Eventueel een proxy op Uberspace zoals HA doet.privacy.html, attributie,sw.js, README/CLAUDE.md.Bijvangst: AVG-gat
privacy.htmlnoemt Uberspace, Matomo en de eigen Git-server en besluit met "geen gegevens doorgegeven aan partijen buiten de EU" — maar de kaartprovider staat er niet bij, terwijl elke kaartweergave het IP-adres van een kind naar CARTO (US) stuurt. Dat gat bestaat vandaag al; deze migratie dicht het.Fase 1 voorlopig bewijs: render-test met MapLibre v6.10.0 + gestripte Colorful-stijl (48 tekst/icoonlagen eruit, 232 over).
Resultaat: een volwaardige topografische kaart zonder één plaatsnaam. Snelwegen, provinciegrenzen, meren, wadden, bebouwing en landgebruik zijn zichtbaar; op z11 (Leeuwarden) ook grachten en het stratenpatroon.
Punten die de integratie raken (nieuw uit de test):
dist/maplibre-gl.js(UMD) meer, en geen default export (import { Map } from ...). Past niet bij een classic<script>-tag; dit wordt een<script type="module">, zoals de boot-module inindex.htmlal is.projection: mercatorzetten, anders liggen de eigen geojson-lagen ernaast.GPUInitializationError. School-Chromebooks ondersteunen dat meestal, maar oude of zwakke modellen kunnen traag zijn. Aan te vullen met een fallback (bijv. de bestaande raster-tak) en een meting op een echt schoolapparaat vóór livegang. Dit is het grootste risico van deze route.maplibre-glis ~1 MB (v5 UMD gemeten: 1,06 MB), plus de stijl van ~168 KB. Meenemen in de PWA-cache (sw.js).Testpagina en screenshots liggen lokaal; nog niet in de repo.
Fase 1 staat op dev (v2.31.1, commits
8696e80en6e09145). Nog niet naar staging/productie.Gedaan:
kaartstijl.jsonzonder enige tekst/icoonlaag (232 lagen, gegenereerd doordata/build-kaartstijl.mjs).vendor/(306 KB gzip) achter een import map; geen CDN in het pad..mjsalstext/javascript, geen console-fouten, geen CARTO-verkeer..htaccess(MIME) bijgewerkt.Onderweg gevonden en opgelost:
options.attribution; de OSM-naamsvermelding ontbrak dus eerst (ODbL). Nu in de stijlbron, en getest tegen de zichtbare attributie.onAddgeregistreerd) en crashte de pagina later. Nu vooraf gecontroleerd.Nog open:
privacy.htmlbelooft "geen gegevens buiten de EU", maar Leaflet komt nog van unpkg.com en de lettertypen van Google Fonts. Beide zien het IP-adres van elk apparaat.Fase 1 live in productie (v2.31.2), release: https://git.jelmer.org/jelmer/topoquiz/releases/tag/v2.31.2
De eerste staging-run (v2.31.1) faalde in CI op vier klik-op-kaart-tests. Nagebootst lokaal met software-WebGL en een geknepen CPU: klik-feedback na 646 ms (1x), 2 s (4x), geen antwoord binnen 90 s (8x). MapLibre hertekent bij elke Leaflet-move en een door de CPU gerenderd frame legt de pagina plat. Dat speelt niet alleen in CI, maar op elk apparaat zonder GPU-versneld WebGL.
Opgelost: de achtergrond start alleen op GPU-versneld WebGL2 (
failIfMajorPerformanceCaveatplus controle van de renderernaam; beide nodig, want Chromium negeert de eerste bij afgedwongen software-GL). Na de fix: feedback in 403 ms op 8x. CI draait de overige ~200 tests nu zonder WebGL en zonder tegelverkeer; alleenbasemap.spec.jszet software-GL aan.Bewuste beperking: een apparaat zonder GPU-versnelling ziet nu een vlak grijze achtergrond met alleen onze eigen lagen, geen topografische kaart. Aan te pakken in fase 2/3: label-vrije rastertegels als terugval, of tegels op de server voorrenderen.
Open: fase 2 (wegen-contrast op set 5.9), fase 3 (proxy/caching), fase 4 (afhechten). Onafhankelijk hiervan: AVG-gat door unpkg.com en Google Fonts.
Fase 3 (tegelproxy) staat op dev (v2.32.0, commit
28bf2f3), nog niet op staging/productie.tiles.phpop Uberspace: strikt gevalideerdez/x/yals enige invoer, alleen voor eigen pagina's, cache in~/tilecachebuiten de webroot, gedeeld door dev en prod.~/users/jelmer). Cache-limiet daarom hard op 250 MB (oudste tegels eruit); een tegel is 50-130 KB en een sessie raakt er ~6 (gemeten 300 KB). Quota na de test ongewijzigd (7625M).php-clien faalt hard als het ontbreekt (nog niet in CI gedraaid: Ubuntu jammy heeft PHP 8.1, Uberspace 8.3).privacy.htmlbijgewerkt: VersaTiles ziet alleen onze server.Nog open: fase 4 (afhechten) en het AVG-gat in #147 (unpkg.com, Google Fonts).
Afgerond, alle vier de fasen live (v2.31.2 t/m v2.32.0).
kaartstijl.json(232 lagen, 0 tekstlagen), self-hosted invendor/ROAD_STYLEtiles.php, cache buiten de webroot met harde limiet 250 MB, slot per tegel, stale bij storing; 26 testsWatermerk weg, geen plaatsnamen op de kaart, en het IP-adres van een kind bereikt VersaTiles niet meer. Gemeten op productie: 6 tegels, 6x HIT, 0 rechtstreekse verzoeken.
Bewust niet gedaan of apart gevolgd:
future), beslissing op basis van het Matomo-eventkaart.permissions:in de CI: #146.