Zum Inhalt springen

Das Magazin für Web-Handwerker Dienstag, 17. November 2026

DevOps & Server

Protomaps: Weg von der Abrechnung pro Kartenaufruf

Angesichts der Abrechnung pro Kartenaufruf bei kommerziellen Karten-APIs hat ein Entwickler das Selbst-Hosting eigener Kartenkacheln über das Format PMTiles dokumentiert. Sein Erfahrungsbericht beziffert die monatlichen Kosten für eine vollständige Weltkarte auf rund fünf Dollar.

Die steigenden Kosten der nach Kartenaufrufen abrechnenden kommerziellen Karten-APIs treiben einen Teil der Entwickler zum Selbst-Hosting. Ein kürzlich in der Community geteilter technischer Beitrag beschreibt, wie sich eigene Kartenkacheln aus einem einfachen S3-kompatiblen Speicher ausliefern lassen, ganz ohne dedizierten Kachelserver, dank des Formats PMTiles des Projekts Protomaps.

Das Problem: Bezahlen pro Kartenaufruf

Kommerzielle Karten-APIs wie Mapbox berechnen in der Regel ab Überschreiten einer kostenlosen Stufe etwa fünf Dollar pro tausend Kartenaufrufe. Bei einem Endkundenprojekt mit plötzlichem Traffic-Peak kann die Rechnung innerhalb weniger Stunden in die Höhe schnellen, ohne dass eine Kostenbremse rechtzeitig greift.

PMTiles: eine einzige Datei, ausgeliefert über Byte-Bereiche

Das Format PMTiles bündelt einen kompletten Kachelsatz in einer einzigen Datei. Der Browser der besuchenden Person lädt dank HTTP-Bereichsanfragen (Range) nur die Bytes herunter, die dem angezeigten Ausschnitt und Zoomstufe entsprechen. Ein Anwendungsserver ist nicht nötig: Ein einfacher statischer Speicher, der solche Anfragen beantworten kann, genügt, sofern das vorgeschaltete CDN diese Antworten zwischenspeichert.

PostenKommerzielle Karten-APISelbst gehostetes PMTiles (S3-kompatibles CDN)
AbrechnungsmodellPro Kartenaufruf, ab Überschreiten einer kostenlosen StufeNach verbrauchtem Speicher und Bandbreite
Vollständige Weltkarte (~139 GB)Nicht anwendbar (nutzungsbasierte Abrechnung)Etwa 5 $/Monat Speicher mit Replikation
Anzeige einer europäischen StadtZählt als ein abrechenbarer AufrufEtwa 5 MB übertragen, rund 0,00005 $
Benötigte ServerkomponenteKeine, vom Anbieter verwaltetKeine, nur statischer Speicher mit Unterstützung für Byte-Bereiche

Einrichtung auf einem S3-kompatiblen Speicher

Das dokumentierte Verfahren nutzt ein Kommandozeilen-Synchronisationswerkzeug, ähnlich denen in diesem Überblick über CLI-Werkzeuge für die Webentwicklung, um die große Datei in den Speicher zu übertragen, und anschließend die Konfiguration einer CDN-Pull-Zone darüber:

rclone config create bunnycdn s3 \
  provider=Other \
  access_key_id="<zonen-name>" \
  secret_access_key="<speicher-schluessel>" \
  endpoint="https://<primaer-region>-s3.storage.bunnycdn.com"

rclone copyurl --multi-thread-chunk-size=256M \
  https://build.protomaps.com/latest.pmtiles bunnycdn:karten/welt.pmtiles

Auf Seiten des CDN entscheiden drei Einstellungen über den Erfolg: das ausdrückliche Aktivieren des Cachings von Bereichsanfragen für große Objekte, die Einschränkung erlaubter Referrer, damit Dritte die Karte nicht auf der eigenen Seite einbetten können, und eine Drosselung der Downloadgeschwindigkeit nach den ersten Megabyte, um den vollständigen Download der Datei unattraktiv zu machen. Im Browser erfolgt die Einbindung über die Bibliothek MapLibre GL und das Paket pmtiles, das das zum bereichsweisen Lesen der Datei nötige Protokoll registriert. Der Ansatz erinnert in seiner Kosten- und Verantwortungslogik an den für das vollständige Selbst-Hosten einer WordPress-Site beschriebenen.

Eine 139 GB große Kartendatei kann im Hosting rund fünf Dollar im Monat kosten, gegenüber einer Abrechnung, die bei einem kommerziellen Anbieter direkt dem Traffic folgt.

Das Kommandozeilen-Importwerkzeug kann bei instabiler Verbindung ab einigen Dutzend Gigabyte fehlschlagen: Die Übertragung sollte besser von einem entfernten Server als von einem eigenen Rechner aus gestartet werden, in einer Sitzung, die einen Verbindungsabbruch übersteht.

Grenzen, die man kennen sollte

Selbst-Hosting verlagert die Verantwortung für Verfügbarkeit und Aktualität der Daten auf das Team, das es betreibt: Die Welt-Extrakte von Protomaps werden regelmäßig neu erstellt, doch eine Aktualisierung bedeutet, die Datei ganz oder teilweise erneut herunterzuladen oder neu zu berechnen. Für ein Projekt, das nur einen begrenzten geografischen Bereich benötigt, kann das Kommandozeilenwerkzeug go-pmtiles einen präzisen Ausschnitt extrahieren und die zu hostende Dateigröße deutlich verringern, was spätere Aktualisierungen entsprechend vereinfacht.

Das Wichtigste in Kürze

PMTiles verlagert die Kosten einer interaktiven Karte von abgerechneten Aufrufen hin zu reinem Speicher und reiner Bandbreite, wobei die Serverkomponente auf statischen Speicher reduziert wird. Die Ersparnis ist bei hohem oder unvorhersehbarem Traffic real, auf Kosten einer größeren Verantwortung für die Aktualität der Daten und die feingranulare CDN-Konfiguration.

Ich erkenne hier ein Muster wieder, das ich bei anderen Infrastrukturbausteinen für meine freiberuflichen Kunden bereits anwende: Sobald ein Anbieter nutzungsbasiert für Daten abrechnet, die sich auch statisch ausliefern lassen, rechnet sich Selbst-Hosting hinter einem ordentlichen CDN schon lange, bevor der Traffic wirklich massiv wird. Die Umstellung erfordert im Vorfeld etwas mehr Sorgfalt, nimmt dem Budget eines Projekts, das einen Abrechnungs-Peak nicht immer abfedern kann, aber einen unkalkulierbaren Kostenposten. — Simon Janvier

Weiterführende Informationen

Der vollständige Erfahrungsbericht mit Zahlen und CDN-Konfiguration ist im Blog des Autors verfügbar.

Teilen LinkedIn Bluesky Hacker News E-mail

Ebenfalls lesenswert