finds.dev← search

// the find

maptiler/qgis-maptiler-plugin

★ 110 · Python · GPL-2.0 · updated Aug 2026

QGIS MapTiler Plugin: vector tiles, basemaps, geocoding, OSM, QuickMapServices

A QGIS plugin from MapTiler that adds its hosted basemaps (raster and vector tiles), a geocoding toolbar, and a global elevation layer to QGIS. It also imports Mapbox GL style JSON, so a style built in MapTiler's cloud editor can be used inside QGIS. Aimed at GIS users who already have a MapTiler account and want styled basemaps without leaving QGIS.

The GL JSON import is the part worth reading. The gl2qgis module translates Mapbox GL style layers into QGIS styling, which is the hard part of supporting that format at all. Vector tiles go through QGIS's native vector tile layer support, so exported print layouts stay vector and high-DPI instead of being rasterised, which is the real reason to pick vector over raster for print work. Raster versus vector is a per-map choice with a global default in the Account dialog, so there is a fallback for older QGIS installs or heavy styles. The browser integration is split into browser_root_collection.py and browser_mapitem.py, which keeps the QGIS browser code apart from the dialogs.

Everything beyond the public presets needs a MapTiler account and key, and the tiles are served from MapTiler's cloud. The README describes no self-hosted path, so offline or restricted-network GIS work is out of reach, and changes to the free tier (100,000 loads a month, per the README) are outside your control. The version requirements contradict each other: vector tiles 'requires QGIS 3.13 or higher', 2.0 needs 3.16, and 3.0 needs 3.24, spread across several sections. The minimum should live in one place and stay in sync with metadata.txt. Fonts are left to the user. Maps reference fonts the plugin does not ship, QGIS silently substitutes a default, and labels can differ from the MapTiler preview. The README links a fonts.json file but does not say how to install the fonts. The contribution section asks for tests, but the README gives no way to run them, and the visible part of the tree has no test directory. The tree is truncated, so this may be wrong, but for a plugin that has to track QGIS API changes between releases it matters.

View on GitHub →

// want more like this?

We dig through GitHub every week and send a few repos picked for what you actually care about — each with an honest take like this one.

Get finds in your inbox → Search again →