leafmap

library0.62.0pypypi✓ verified 85d ago

A Python package for geospatial analysis and interactive mapping in a Jupyter environment. Version 0.61.1, released monthly.

data web-framework

pip install leafmap

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · LEAFMAP

leafmap

datapythonv0.62.0

Install

27.8s avg

Import

5016ms

Disk

654MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.62.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 27.8s · import 5.016s · 653MB

654MB installed

● package 654MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Map

✓ from leafmap import Map

✗ import leafmap m = leafmap.Map()

Works but not idiomatic; direct import recommended

Create an interactive map with a Google Hybrid basemap.

from leafmap import Map m = Map() m.add_basemap('HYBRID') m

leafmap --version

Debug

Known issues

deprecatedThe `leafmap.leafmap` module is deprecated. Use `from leafmap import Map` instead of `from leafmap.leafmap import Map`.

fix

Use `from leafmap import Map`

affects: >=0.30.0

gotchaIn Google Colab, ipyvue must be pinned to <1.12.0 to avoid maplibre load failures. Leafmap now pins it automatically, but if you install other packages that upgrade ipyvue, you may break the map.

fix

Reinstall leafmap or downgrade ipyvue: `pip install ipyvue<1.12.0`

affects: >=0.61.1

breakingThe `leafmap.common` module was temporarily removed in v0.59.0 and restored in v0.60.0. If you used `from leafmap.common import *`, ensure you are on v0.60.0+.

fix

Upgrade leafmap to >=0.60.0

affects: 0.59.0

gotchaWhen using `Map.add_raster()`, large files may cause memory issues. Use `max_image_size` parameter or reproject to COG first.

fix

Use `m.add_raster('file.tif', max_image_size=1000)`

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'leafmap.leafmap'

Removed in v0.30.0; the correct import is `from leafmap import Map`.

fix

Use `from leafmap import Map` instead of `from leafmap.leafmap import Map`.

ValueError: The `max_image_size` must be a positive integer.

`add_raster()` expected a positive integer but received a float or non-positive integer.

fix

Pass an integer: `m.add_raster('file.tif', max_image_size=1000)`

Upgrade

Version history

0.62.0latest on PyPI · released Apr 30, 2026

Audit

Dependencies

geopandasrequiredGeospatial data handling

ipyleafletrequiredInteractive mapping backend

ipyvuerequiredVue.js integration for widgets, pinned <1.12.0

foliumoptionalAlternative mapping backend

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/opengeos/leafmap ↗

packagehttps://pypi.org/project/leafmap/ ↗

homepagehttps://leafmap.org ↗