Support Vector Tiles (via Mapbox Style JSONs) by Phocacius · Pull Request #1748 · mapbender/mapbender

Phocacius · 2025-07-16T15:02:15Z

This PR enables a new data source to be used: Vector Tiles using the Mapbox Style JSON Specification.

Preconditions

checkout New data source vector tiles mapbender-starter#155 and run composer install (or manually enable the VectorTilesBundle and run composer update, the mapbender/openlayers6-es5 needs to be present in version >= 10.6.1.2)
create new database tables for vector tiles: bin/console doctrine:schema:update --force

Things that work

Embedding in db or yaml applications
Usage in overview
Rotating while keeping labels correctly aligned (using Alt+Shift+Mouse)
Feature Info

Things that don't work (yet)

Legend
Print

Other changes

Refactored mapbender.source.js into separate files for each class
Refactored feature info handling: All sources now return a promise and the feature info handling is done directly in the source class instead of in the featureinfo element
Fix keyboard navigation in scale selector
Fix keyboard navigation in feature info tabs/accordion
Add "unsupported projection" as error type in layertree

Usage (GUI)

Add a new data source in the corresponding manager page:

Enter an URL to a mapbox style json, e.g.
- German Basemap: https://sgx.geodatenzentrum.de/gdz_basemapde_vektor/styles/bm_web_col.json
- OSM (bright style, hosted by WhereGroup): https://wms.wheregroup.com/tileserver/style/osm-bright.json
Include the new source in your application like a WMS or WMTS source

Usage (YAML):

Use the following sample yaml application and adapt to your needs:

parameters:
    applications:
        vectortiles_yaml:
            title: Vectortiles Demo YAML
            published: true
            template:  Mapbender\CoreBundle\Template\Fullscreen
            layersets:
                themes:
                    selected: true
                    mapbender_users:
                        type: wms
                        title: Mapbender Users
                        url: https://wms.wheregroup.com/cgi-bin/mapbender_user.xml
                        version: 1.3.0
                        toggle: true
                        layers:
                            4: { name: Mapbender_User,    title : User, visible: true, legendurl: https://wms.wheregroup.com/cgi-bin/mapbender_user.xml?version=1.3.0&service=WMS&request=GetLegendGraphic&sld_version=1.1.0&layer=Mapbender_User&format=image/png&STYLE=default }
                            5: { name: Mapbender_Names,   title : Name, visible: true, queryable: true}
                background themes:
                    selected: true
                    basemap_vector:
                        type: vector_tiles
                        title: Basemap VT
                        jsonUrl: https://sgx.geodatenzentrum.de/gdz_basemapde_vektor/styles/bm_web_col.json
                        # jsonUrl: https://wms.wheregroup.com/tileserver/style/osm-bright.json
                        ## All configuration from here onwards is optional
                        isBaseSource: true
                        allowSelected: true
                        # bbox: [7.6,47.9,7.8,48.1]
                        selected: true
                        opacity: 100
                        minScale: 0
                        maxScale: 50000000
                        featureInfo: true
                        featureInfoAllowToggle: false
                        featureInfoTitle: ${name} (${klasse})
                        hideIfNoTitle: true
                        propertyMap:
                          - klasse
                          - name
                          - mvt:layer: Layername
            elements:
                content:
                    map:
                        class: Mapbender\CoreBundle\Element\Map
                        layersets: [themes,background themes]
                        srs: EPSG:3857
                        extents:
                            # Freiburg
                            start: [866322.89,6102554.89,881937.85,6112331.21]
                            max: [-20037508.34278924,-20037508.34278924,20037508.34278924,20037508.34278924]
                        scales: [50000000,25000000,10000000,5000000,1000000,500000,100000,50000,25000,10000,7500,5000,2500,1000,500]
                        otherSrs: ["EPSG:25832","EPSG:25833","EPSG:31466","EPSG:31467","EPSG:3857"]
                    zoombar:
                        class: Mapbender\CoreBundle\Element\ZoomBar
                        target: map
                        anchor: right-top
                        draggable: false
                    scalebar:
                        class: Mapbender\CoreBundle\Element\ScaleBar
                        target: map
                        anchor: 'right-bottom'
                        maxWidth: 200
                        units: km
                        screenType: desktop
                    scaledisplay:
                        class: Mapbender\CoreBundle\Element\ScaleDisplay
                        target: map
                        anchor: right-top
                        scalePrefix: Scale
                        unitPrefix: true
                        screenType: desktop
                    featureinfo:
                        class: Mapbender\CoreBundle\Element\FeatureInfo
                        target: map
                        screenType: desktop
                        autoOpen: true
                        deactivateOnClose: false
                        highlighting: true
                sidepane:
                    layertree:
                        class: Mapbender\CoreBundle\Element\Layertree
                        target: map
                        type: element
                        autoOpen: false
                        showBaseSource: true
                        layerRemove: true
                        menu: [opacity,zoomtolayer,metadata,layerremove,select_style]
                        hideNotToggleable: true
                        hideSelect: true
                        hideInfo: false
                        useTheme: false
                footer:
                    activityindicator:
                        class: Mapbender\CoreBundle\Element\ActivityIndicator
                        screenType: desktop
                    coordinates:
                        class: Mapbender\CoreBundle\Element\CoordinatesDisplay
                        target: map
                        label: false
                        empty:  "x: - y: -"
                        prefix: "x: "
                        separator:  " y: "
                        numDigits: 2
                        screenType: desktop
                    scaleselector:
                        class: Mapbender\CoreBundle\Element\ScaleSelector
                        target: map
                        screenType: desktop
                    srs:
                        class: Mapbender\CoreBundle\Element\SrsSelector
                        target: map
                        screenType: desktop

…freshing source, check if resource is json

…nfo behaviour into common base class for WMS/WMTS (WIP), make feature info behaviour more generic (WIP)

Copilot

Pull Request Overview

This PR introduces comprehensive support for Vector Tiles as a new data source using Mapbox Style JSON specifications. The feature enables rendering of vector tile layers directly in Mapbender with full integration into the layertree, feature info functionality, and YAML configuration support.

Key changes include:

Implementation of a complete Vector Tiles bundle with source/instance entities, form types, and frontend JavaScript classes
Refactoring of the feature info system to use promises and handle source-specific implementations
Enhanced accessibility features including keyboard navigation for scale selector and feature info tabs
Addition of projection support validation for layers

Reviewed Changes

Copilot reviewed 74 out of 74 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
src/Mapbender/VectorTilesBundle/	Complete new bundle implementing vector tiles support with entities, forms, loaders, and configuration
src/Mapbender/CoreBundle/Resources/public/mapbender.element.featureInfo.js	Refactored to use promise-based feature info loading from sources
src/Mapbender/CoreBundle/Resources/public/mapbender-model/	Split monolithic source.js into separate files and added GetFeatureInfoSource base class
src/Mapbender/WmsBundle/Resources/public/mapbender.geosource.wms.js	Updated to extend GetFeatureInfoSource and removed duplicate scale checking logic
src/Mapbender/ManagerBundle/Component/ImportHandler.php	Enhanced import handling to support different source types via factory pattern

…ayertree

swinkelmann

I have nothing to complain about. 🥇

Phocacius added 26 commits July 16, 2025 14:56

Fix WMTS display

575a1c8

Add properties referer (source) and min/max zoom (instance). Allow re…

bc9a53f

…freshing source, check if resource is json

Fix scale selector

8335848

Display vector tile instances on the map

21aa103

Support instantiation from yaml

6a8aa8f

Implement matchInstanceToPersistedSource for vector tiles

02597ef

Refactor import handling: matchInstanceToPersistedSource was not called

fed6789

Fix export did not work for class proxies

387e43e

Make sure vector tiles are only displayed in Web Mercator

09e2c85

Support opacity for vector tiles

dde25ec

Support min/maxScale

3a4dc12

Load and evaluate bbox for vector tiles

263898a

Fix base source definition

728333c

Remove legacy OL4 code in overview

e17bb13

Allow overriding vector tiles main class in parameters

998bedb

Separate classes within Source to individual files. Extract feature i…

641874d

…nfo behaviour into common base class for WMS/WMTS (WIP), make feature info behaviour more generic (WIP)

Fix wms feature info after refactoring

980a59c

Featureinfo for Vector Tiles part 1

70f599c

Add additional properties to vector tiles feature info

638ba26

Fix highlighting for vector tile feature info

126d4d1

Make title configurable

e6fac5a

Key-Filter for vector tiles feature info

746733e

Automated translation in all mapbender-supported languages

fc9e0a0

Add changelog entry

63adc68

Set version to 4.2-PRE

60bd5df

Adapt enabled state of print button to whether or not there is a url

faf186d

Phocacius mentioned this pull request Jul 16, 2025

New data source vector tiles mapbender/mapbender-starter#155

Merged

Phocacius requested review from astroidex, Copilot and swinkelmann July 16, 2025 15:03

Copilot AI reviewed Jul 16, 2025

View reviewed changes

Phocacius added this to the 4.2 milestone Jul 16, 2025

Phocacius added 7 commits July 16, 2025 17:17

Fix issues noticed by Copilot review

21bd20b

Adjust translations

4fc8ec9

Allow translation keys in vt feature info key map

a1b3a17

Fix source id instead of instance id used for vector tile source in l…

914737a

…ayertree

Load and display metadata in backend for vector tile

f264527

Allow sources to have trans and css assets

4997df4

Styling and translation changes for vector tiles

03dcf22

swinkelmann approved these changes Jul 25, 2025

View reviewed changes

Phocacius merged commit 234b43e into develop Jul 28, 2025

Phocacius deleted the work/datasource-vectortiles branch July 28, 2025 11:23

Phocacius mentioned this pull request Jul 29, 2025

Print and legend support for Vector Tiles #1753

Merged

astroidex mentioned this pull request Aug 1, 2025

Vector Tiles Support #1733

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Support Vector Tiles (via Mapbox Style JSONs)#1748

Support Vector Tiles (via Mapbox Style JSONs)#1748
Phocacius merged 33 commits into
developfrom
work/datasource-vectortiles

Phocacius commented Jul 16, 2025

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

swinkelmann left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

Phocacius commented Jul 16, 2025

Preconditions

Things that work

Things that don't work (yet)

Other changes

Usage (GUI)

Usage (YAML):

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

swinkelmann left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants