MVT Mapbox Vector Tiles

Dieses Feature ist aktuell (Jan 2026) in Arbeit, die unten durchgestrichene dargestellten Funktionen sind noch nicht implementiert. Für eine produktive Nutzung genügt die Qualität derzeit noch nicht.

Wir gehen nicht davon aus, eine 100%tige Umsetzung aller Stil-Spezifiktationen umsetzen zu können. Ggf. wird diese Funktion auch wieder eingestellt.

Ermöglicht den Zugriff auf Vector-Tiles mit Unterstützung der Reprojektion.

Die Tiles müssen im Protocoll-Buffer Format der Spezifikation Encoding tiled vector data 2.1 vorliegen

Wir gehen vom Abfruf des Style-JSON aus und folgen den dort angegebenen Quellen. Filter auf die Layer sind möglich.

Da es hier um ein serverseitigiges rendern geht, ist das Installieren der vom Stil verwendeten Schriftarten auf dem Server erforderlich.

(Untersütze) Features

Arten der Layer-Style

• Fill
• Line
• Symbol
• Circle
• Heatmap
• Fill-Extrusion
• Building
• Raster
• Raster-Particle
• Hillshade
• Model
• Background
• Sky
• Slot
• Clip

Layout und Paint-Attribute

• Filter
• Expressions/Funktionen der Attribut-Eigenschaften
• erweiterte Symbol/Text Positionierungen
• Symbol/Text Freistellung

... diverse andere

Argumente

Typname: MVT

• url: Die Endpunkt Url zu dem Style-JSON.

• maxSimultanRequests (4) : Maximale Anzahl gleichzeitiger GetTile Anforderungen pro Zeichenvorgang (hier nur der Donwload)

• cacheDuration (60): Cache-Dauer einer Kachel in Sekunden, der Standard ist 5 Tage, mit 0 kann das Caching deaktiviert werden.

• serverUser (""): optionaler Benutzername für die Anmeldung am Dienst

• serverPwd (""): wenn serverUser angegeben ist, dann muss ein Kennwort übergeben werden, leere Kennwörter sind nicht zulässig

• proxyUri (""): optionale Url zu einem Http-Proxyserver z.B. http://proxy:8888

• proxyUser(""): optionaler Benutzername für die Anmeldung am proxyUri

• proxyPwd(""): wenn proxyUser angegeben ist, dann muss ein Kennwort übergeben werden, leere Kennwörter sind nicht zulässig

• proxyBypassList (null): optionale Bypass-Liste, wenn ein Proxyserver eingestellt ist.

• timeoutMilliseconds (30000): Http-Timeout für die Zugriffe auf den Dienst

• useDefaultProxy (false): Standard-Proxy des Betriebssystems verwenden

Implementierungsdetails

Bei der Zeichenanforderung werden die benötigten Tiles ermittelt und abgerufen.

• bei aktiviertem Caching wird im lokalen Cache geschaut, ob die Kachel (Key ist nur die URL) bereits im Lokalem Cache vorhanden ist

• ... sonst wird diese entsprechend der URL abgerufen

  • es wird der MimeType application/x-protobuf oder application/octet-stream erwartete.
  • wenn der Http-Statuscode 404 ermittelt wird und in der Antwort <Code>NoSuchKey</Code> oder <ServiceExceptionReport enthalten ist, wird dies nicht als Fehler behandelt, sondern als "NULL-Tile".

• die Geometriedaten werden für alle Kacheln gelesen und ggf. umprojeziert.

• dann erfolgt das Rendering über alle Style-Layer des Style-Dokumentes, ggf. gefilter über die Layernamen.

Ladevorgang

Der Zugriff auf einen Dienst läuft immer in dieser Form ab:

• Abrufen des Style-JSON (1x mal)

Beispiel

{"ni_color":{
	"onExist":"ReplaceExisting",
	"type":"MVT",
	"url":"https://basisvisualisierung.niedersachsen.de/services/basiskarte/styles/vt-style-color.json"
 }}