large-image-source-mapnik

1.34.1 verified Fri May 01 auth: no python

A Mapnik tilesource for large_image, enabling rendering of vector tile sources as raster tiles. Version 1.34.1, released as part of the large_image ecosystem with regular updates.

pip install large-image-source-mapnik

Common errors

error ImportError: cannot import name 'MapnikTileSource' from 'large_image_source_mapnik' ↓

cause Typo in class name (capitalization).

fix

Use 'MapnikTilesource' (note: 'tilesource' all lowercase).

error RuntimeError: Mapnik module not found. Please install Mapnik. ↓

cause Mapnik C++ library not installed or not found by Python bindings.

fix

Install Mapnik system package (e.g., apt-get install libmapnik-dev mapnik) or conda install -c conda-forge mapnik.

Warnings

gotcha Requires Mapnik system library installed separately. pip install does not install Mapnik C++ bindings. ↓

fix Install Mapnik via conda: conda install -c conda-forge mapnik, or follow OS-specific instructions.

breaking Python 3.14 support added in v1.34.0. Python 3.10+ required as of v1.34.1. ↓

fix Use Python 3.10 or newer.

gotcha The class is named 'MapnikTilesource' not 'MapnikTileSource' or 'MapnikSource'. ↓

fix Use 'from large_image_source_mapnik import MapnikTilesource'.

Imports

MapnikTilesource

from large_image_source_mapnik import MapnikTilesource

The class name is case-sensitive.

Quickstart

Initialize a Mapnik tilesource from an XML file path.

from large_image_source_mapnik import MapnikTilesource
import os
ts = MapnikTilesource(path=os.environ.get('MAPNIK_XML', ''))
print(ts.tileSourceMetadata)