Skip to main content

mapli

mapli is a Python package that renders MapLibre styles to PNG images. Rendering is done by MapLibre Native, which mapli runs inside the Python process through the maplibre_native Rust crate.

mapli renders static map images, given a center and zoom level or a bounding box, and map tiles in the XYZ tiling scheme. Render calls are available as blocking and as async methods. Data can also be served to MapLibre Native from Python, through custom URL scheme handlers.

Documentation: https://geobeyond.github.io/mapli/

Installation

mapli is published on PyPI:

uv add mapli
pip install mapli

mapli currently runs on Linux only (x86_64 and ARM64, glibc 2.34 or newer). Rendering needs an EGL driver, libcurl and a display (or Xvfb), see System requirements.

Usage

from pathlib import Path

import mapli

pool = mapli.RenderPool(workers=2)
pool.register_style("demo", url="https://demotiles.maplibre.org/style.json")

png_bytes = pool.render("demo", lon=-9.14, lat=38.72, zoom=5, width=512, height=512)
Path("lisbon.png").write_bytes(png_bytes)

Development

See Development in the documentation.

License

See LICENSE.

Metadata

Release files for mapli 0.4.1

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

Source distribution (sdist)

Source distribution for mapli 0.4.1
File Size Uploaded Provenance Actions
mapli-0.4.1.tar.gz 23.6 MB With provenance Details for mapli-0.4.1.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for mapli 0.4.1
File Interpreter ABI Platform Actions
mapli-0.4.1-cp39-abi3-manylinux_2_34_x86_64.whl CPython 3.9 abi3 Linux glibc 2.34+ x86-64 Details for mapli-0.4.1-cp39-abi3-manylinux_2_34_x86_64.whl
mapli-0.4.1-cp39-abi3-manylinux_2_34_aarch64.whl CPython 3.9 abi3 Linux glibc 2.34+ ARM64 Details for mapli-0.4.1-cp39-abi3-manylinux_2_34_aarch64.whl

Total release size: 67.6 MB

Release files / mapli-0.4.1.tar.gz

Download URL mapli-0.4.1.tar.gz
Size 23.6 MB
Tags Source
SHA-256 checksum
How to use checksums
dd4ea204063a5aa5c4a7625283c54bb4a87c18df37b179c4bd28bf0275c488d7
BLAKE2b-256 checksum
How to use checksums
21577a9cd5af4c012221d7202bee1a752ad77133faaf45b5a13a6865e5159016
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / mapli-0.4.1-cp39-abi3-manylinux_2_34_x86_64.whl

Download URL mapli-0.4.1-cp39-abi3-manylinux_2_34_x86_64.whl
Size 22.3 MB
Tags CPython 3.9 Linux glibc 2.34+ x86-64 abi3
SHA-256 checksum
How to use checksums
7b827b174bda0fd224450796172999679b379786495db782d02a2a41c4a4e3d3
BLAKE2b-256 checksum
How to use checksums
bd9addb193b67f4823866f190dd61957175cae677a0237220711c821e6868d2b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / mapli-0.4.1-cp39-abi3-manylinux_2_34_aarch64.whl

Download URL mapli-0.4.1-cp39-abi3-manylinux_2_34_aarch64.whl
Size 21.8 MB
Tags CPython 3.9 Linux glibc 2.34+ ARM64 abi3
SHA-256 checksum
How to use checksums
e8c836380a26eceb83309cddf44faf816c09b48fbeedc310fab4931a39248df7
BLAKE2b-256 checksum
How to use checksums
f259eec3ae5029373d1d4a42d29f6dc206cd3dde66e53e50436a5bfb48591079
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Security for mapli 0.4.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 3 files in this release have been uploaded with provenance metadata.

Select from 3 files

Attestation for mapli-0.4.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.4.1 This release

3 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page