mlt_py

Python bindings for the MapLibre Tile (MLT) format via PyO3.

Decoding

import maplibre_tiles

data = open("tile.mlt", "rb").read()

# Structured decode with geo-referencing
layers = maplibre_tiles.decode_mlt(data, z=14, x=8297, y=10749, tms=True)
for layer in layers:
    print(f"Layer: {layer.name}, extent: {layer.extent}")
    for feat in layer.features[:3]:
        print(f"  id={feat.id}, type={feat.geometry_type}")
        print(f"  wkb={len(feat.wkb)} bytes, props={dict(feat.properties)}")

# Raw tile-local coordinates (no z/x/y needed)
layers = maplibre_tiles.decode_mlt(data)

# GeoJSON string output (tile-local coords)
geojson_str = maplibre_tiles.decode_mlt_to_geojson(data)

# Fast layer listing (no full decode)
names = maplibre_tiles.list_layers(data)

Decoded objects

decode_mlt(...) returns a list of MltLayer objects. Each MltLayer represents one decoded MLT layer and exposes:

name: str - the layer name.
extent: int - the layer extent.
z_step: int | None - the power of ten of the z grid's step in metres, or None when the vertices carry no z.
features: list[MltFeature] - the decoded features in that layer.

Each MltFeature represents one decoded feature and exposes:

id: int | None - the feature id, if present.
geometry_type: str - the decoded geometry type.
wkb: bytes - the geometry as WKB. A layer with z writes ISO WKB Z, with grid values in tile coordinates and elevations in metres once z/x/y project.
properties: dict - the feature properties.

import maplibre_tiles


layers = maplibre_tiles.decode_mlt(data)
for layer in layers:
    print(layer.name, layer.extent)
    for feature in layer.features[:2]:
        print(feature.id, feature.geometry_type, dict(feature.properties))

Encoding

encode_geojson(geojson, name, extent=4096, *, tessellate=False, sort="auto", shared_dict=True, fsst=True, fastpfor=True, z_step=None) -> bytes encodes a single layer to an MLT blob.

geojson is a GeoJSON FeatureCollection. Geometry is in tile-local coordinate space (no projection), matching tilezen/mapbox-vector-tile's default. Coordinates must be integers, and 2D unless z_step is set. They must be JSON integers (2048), not floats: a float-typed value such as 2048.0 raises ValueError.
name and extent set the MLT layer metadata, since a FeatureCollection has no slot for them. extent defaults to 4096.
tessellate generates triangulation data for polygons and multi-polygons.
sort controls which feature ordering(s) the encoder tries: all, auto, morton, hilbert, id, or none.
shared_dict enables grouping strings into shared dictionaries.
fsst enables FSST string compression.
fastpfor enables FastPFOR integer compression.
z_step is the power of ten of the z grid's step in metres, from -3 (1 mm) to 4 (10 km). Every position is then [x, y, z], where z = 0 sits at -10000 m, and the layer is written in the experimental v2 format.

encode_mvt(data, *, tessellate=False, sort="auto", shared_dict=True, fsst=True, fastpfor=True) -> bytes encodes an entire raw Mapbox Vector Tile (protobuf) to MLT using the same encoding options.

import maplibre_tiles


blob = maplibre_tiles.encode_geojson(
    {
        "type": "FeatureCollection",
        "features": [
            {
                "type": "Feature",
                "id": 1,
                "geometry": {"type": "Point", "coordinates": },
                "properties": {"name": "main", "lanes": 3},
            },
        ],
    },
    name="roads",
    extent=4096,
)


# Multi-layer tiles -> encode each layer and concatenate the bytes
tile = b"".join([
    maplibre_tiles.encode_geojson(roads, name="roads"),
    maplibre_tiles.encode_geojson(water, name="water"),
])

import maplibre_tiles


mvt = open("tile.mvt", "rb").read()

blob = maplibre_tiles.encode_mvt(mvt)


# With explicit encoding options
blob = maplibre_tiles.encode_mvt(
    mvt,
    tessellate=False,
    sort="auto",
    shared_dict=True,
    fsst=True,
    fastpfor=True,
)

Input is validated strictly. A non-FeatureCollection input, a non-Feature member, float-typed or 3D coordinates, null or empty geometry, nested or non-scalar property values, a non-u64 id, and an empty collection all raise ValueError.

Metadata

Release files for maplibre-tiles 0.2.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for maplibre-tiles 0.2.9
File	Size	Uploaded
maplibre_tiles-0.2.9.tar.gz	483.8 kB	Oct 9, 2026	Details

Built distributions (wheels)

Table of built distributions (wheels) for maplibre-tiles 0.2.9
File	Interpreter	ABI	Platform	Reset
maplibre_tiles-0.2.9-cp314-cp314-manylinux_2_31_x86_64.whl 1.1 MB Oct 9, 2026	CPython 3.14	CPython 3.14	Linux glibc 2.31+ x86-64	Details
maplibre_tiles-0.2.9-cp314-cp314-macosx_11_0_arm64.whl 2.4 MB Oct 9, 2026	CPython 3.14	CPython 3.14	macOS 11.0+ ARM64	Details
maplibre_tiles-0.2.9-cp314-cp314-macosx_10_12_x86_64.whl 2.5 MB Oct 9, 2026	CPython 3.14	CPython 3.14	macOS 10.12+ x86-64	Details
maplibre_tiles-0.2.9-cp313-cp313-macosx_11_0_arm64.whl 2.4 MB Oct 9, 2026	CPython 3.13	CPython 3.13	macOS 11.0+ ARM64	Details
maplibre_tiles-0.2.9-cp313-cp313-macosx_10_12_x86_64.whl 2.5 MB Oct 9, 2026	CPython 3.13	CPython 3.13	macOS 10.12+ x86-64	Details
maplibre_tiles-0.2.9-cp312-cp312-macosx_11_0_arm64.whl 2.4 MB Oct 9, 2026	CPython 3.12	CPython 3.12	macOS 11.0+ ARM64	Details
maplibre_tiles-0.2.9-cp312-cp312-macosx_10_12_x86_64.whl 2.5 MB Oct 9, 2026	CPython 3.12	CPython 3.12	macOS 10.12+ x86-64	Details
maplibre_tiles-0.2.9-cp311-cp311-macosx_11_0_arm64.whl 2.4 MB Oct 9, 2026	CPython 3.11	CPython 3.11	macOS 11.0+ ARM64	Details
maplibre_tiles-0.2.9-cp311-cp311-macosx_10_12_x86_64.whl 2.5 MB Oct 9, 2026	CPython 3.11	CPython 3.11	macOS 10.12+ x86-64	Details
maplibre_tiles-0.2.9-cp310-cp310-manylinux_2_31_x86_64.whl 1.1 MB Oct 9, 2026	CPython 3.10	CPython 3.10	Linux glibc 2.31+ x86-64	Details

Total release size: 22.0 MB

Release files / maplibre_tiles-0.2.9.tar.gz

Download URL	maplibre_tiles-0.2.9.tar.gz
Size	483.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`71f9d2b0dc628605b534cbb303515637a517344fd25a8b90c126340ac8e70261`
BLAKE2b-256 checksum How to use checksums	`a1229c91e4db6004e8282943b1f3b97f6df155cb9bea22b30affcb437752fc1f`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / maplibre_tiles-0.2.9-cp314-cp314-manylinux_2_31_x86_64.whl

Download URL	maplibre_tiles-0.2.9-cp314-cp314-manylinux_2_31_x86_64.whl
Size	1.1 MB
Tags	CPython 3.14 Linux glibc 2.31+ x86-64
SHA-256 checksum How to use checksums	`3e09f34e06365d1654a465b1d2cbc3e02fdb4e8abdf1cbe12dfd903cc0bba114`
BLAKE2b-256 checksum How to use checksums	`3d35c7e8e68496c7bfe1cc77ecec8922a0350ea8407fedad890fdcd5137dfdd0`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / maplibre_tiles-0.2.9-cp314-cp314-macosx_11_0_arm64.whl

Download URL	maplibre_tiles-0.2.9-cp314-cp314-macosx_11_0_arm64.whl
Size	2.4 MB
Tags	CPython 3.14 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`8977739bba7b8f4360101cf5f0650fa67c8fd9eedd9ac0bec7be1e7138794719`
BLAKE2b-256 checksum How to use checksums	`427ba8563120a363c63ebbda2d8942b6f7f2c27c5680707f07393cdf30d79330`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / maplibre_tiles-0.2.9-cp314-cp314-macosx_10_12_x86_64.whl

Download URL	maplibre_tiles-0.2.9-cp314-cp314-macosx_10_12_x86_64.whl
Size	2.5 MB
Tags	CPython 3.14 macOS 10.12+ x86-64
SHA-256 checksum How to use checksums	`2333b84de218a7642f5e9e4e4ba6fd7db26637ee28965164f1502efe6208d03c`
BLAKE2b-256 checksum How to use checksums	`ca169731439b46bcc3665631d20e98faad22abee9b136011e24188bf28804594`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / maplibre_tiles-0.2.9-cp313-cp313-macosx_11_0_arm64.whl

Download URL	maplibre_tiles-0.2.9-cp313-cp313-macosx_11_0_arm64.whl
Size	2.4 MB
Tags	CPython 3.13 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`bcfb381bd26a239659d3178997a4ebbd122231b383d968f6dbba6fe5227f45ad`
BLAKE2b-256 checksum How to use checksums	`3a285935ca270fe1d77ae6caea54d356fdd9eb128d8b70f357f4bbcb9ff609e6`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / maplibre_tiles-0.2.9-cp313-cp313-macosx_10_12_x86_64.whl

Download URL	maplibre_tiles-0.2.9-cp313-cp313-macosx_10_12_x86_64.whl
Size	2.5 MB
Tags	CPython 3.13 macOS 10.12+ x86-64
SHA-256 checksum How to use checksums	`9e7cf5dc570890bd5896b94522114c28fdf0c9f46caeafe8dffcc555b425d859`
BLAKE2b-256 checksum How to use checksums	`42c5295bd4229cc28248d161813ad5158c88d8bd91af2bf93ee79827ecc84aa3`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / maplibre_tiles-0.2.9-cp312-cp312-macosx_11_0_arm64.whl

Download URL	maplibre_tiles-0.2.9-cp312-cp312-macosx_11_0_arm64.whl
Size	2.4 MB
Tags	CPython 3.12 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`a6182249b86070d9129c6bcea45f2a5714678c5775bda4e6495c47e9035dd946`
BLAKE2b-256 checksum How to use checksums	`0684eda5668cee4157a7760937b3f560ee8bbe4e3d311557d572447b761f5e12`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / maplibre_tiles-0.2.9-cp312-cp312-macosx_10_12_x86_64.whl

Download URL	maplibre_tiles-0.2.9-cp312-cp312-macosx_10_12_x86_64.whl
Size	2.5 MB
Tags	CPython 3.12 macOS 10.12+ x86-64
SHA-256 checksum How to use checksums	`72865c4f5ad758562e94ca4d6813566893f667cc26f12b208fd66ce943c163a9`
BLAKE2b-256 checksum How to use checksums	`d3ae5de24c9bc7bc1d6e47f9961bd9efe09ac9eb86e5011b8671922dd5224180`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / maplibre_tiles-0.2.9-cp311-cp311-macosx_11_0_arm64.whl

Download URL	maplibre_tiles-0.2.9-cp311-cp311-macosx_11_0_arm64.whl
Size	2.4 MB
Tags	CPython 3.11 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`28ea93c51e37f20808ce5164bf6eaea7b1c19de26074188ed359936a8a8f3a40`
BLAKE2b-256 checksum How to use checksums	`8177e9d8b2ab182c31d674c928d5b8069b1f93d334428628f59febd477e90eb6`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / maplibre_tiles-0.2.9-cp311-cp311-macosx_10_12_x86_64.whl

Download URL	maplibre_tiles-0.2.9-cp311-cp311-macosx_10_12_x86_64.whl
Size	2.5 MB
Tags	CPython 3.11 macOS 10.12+ x86-64
SHA-256 checksum How to use checksums	`f0fe04e1ae35a9075e77eb019eb68266f628d5393023f999638e931bddbe7818`
BLAKE2b-256 checksum How to use checksums	`81ef56bc68d65f41d8d52c1d7e3c9560c6073b7a12ff0409bb3169f3be843367`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / maplibre_tiles-0.2.9-cp310-cp310-manylinux_2_31_x86_64.whl

Download URL	maplibre_tiles-0.2.9-cp310-cp310-manylinux_2_31_x86_64.whl
Size	1.1 MB
Tags	CPython 3.10 Linux glibc 2.31+ x86-64
SHA-256 checksum How to use checksums	`cfd7f6636e97c84613e69dcb066792e5fb221c7be1c7476ab6de5875973794d7`
BLAKE2b-256 checksum How to use checksums	`97166556d025335e220db972c0bc35882630a1b788a46e7d7499d5c2b8f26e48`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`