folium

library0.20.0pypypi✓ verified 25d ago

Folium is a Python library that builds on the data wrangling strengths of the Python ecosystem and the mapping strengths of the Leaflet.js library. It allows users to create interactive maps and geospatial visualizations that can be shared as standalone HTML files or integrated into web applications. The current version is 0.20.0, and it maintains an active release cadence with frequent updates and patch releases.

data web-framework

pip install folium

github ↗package ↗

INSTALL

IMPORT

SIG · FOLIUM

folium

datapythonv0.20.0

Install

4.6s avg

Import

1275ms

Disk

96MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.20.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

installs and imports cleanly · install 0.0s · import 1.324s · 95.8MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 4.6s · import 1.226s · 92MB

96MB installed

● package 96MB

Code

Verified usage

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

Map

✓ from folium import Map

✗ import folium m = folium.Map(...)

This example demonstrates how to create a basic interactive map, center it on New York City, add a marker with a popup and tooltip, and save the result as a standalone HTML file.

import folium # Create a map centered at a specific location with a zoom level m = folium.Map(location=[40.7128, -74.0060], zoom_start=12) # Add a marker folium.Marker( location=[40.7128, -74.0060], popup="<b>New York City</b>", tooltip="Click for info" ).add_to(m) # Save the map to an HTML file m.save("folium_map.html") # Display the map (useful in Jupyter notebooks, otherwise open the HTML file) # m

Debug

Known issues

breakingPython 3.8 support was dropped in Folium versions 0.18.0 and 0.19.0. Users on Python 3.8 or older should upgrade their Python environment to at least 3.9 before upgrading Folium.

fix

Upgrade Python to version 3.9 or higher. Adjust `requires_python` in project metadata if necessary.

affects: >=0.18.0

deprecatedThe `Map.choropleth` method was deprecated and subsequently removed. Direct usage of `folium.Choropleth` class is required.

fix

Replace `map_object.choropleth(...)` with `folium.Choropleth(...).add_to(map_object)`.

affects: >=0.15.0

deprecatedSeveral Stamen tilesets (e.g., 'Stamen Toner', 'Stamen Terrain', 'Stamen Watercolor') were removed in v0.15.0 due to upstream changes or deprecations.

fix

Switch to alternative built-in tiles (e.g., 'OpenStreetMap', 'CartoDB Positron', 'CartoDB Voyager') or use custom tiles via the `xyzservices` package.

affects: >=0.15.0

gotchaWhen using Folium in Jupyter notebooks or similar environments, maps may not render if the notebook is not 'trusted' or if the map object is not the last expression in the cell. If a map doesn't appear, ensure the notebook is trusted and the map object `m` is the last line of the cell.

fix

Trust the Jupyter Notebook (File -> Trust Notebook) or ensure the map variable is the final output of the cell.

affects: All versions

Upgrade

Version history

0.20.0latest on PyPI · released Jun 16, 2025

Audit

Dependencies

brancarequiredCore dependency for creating elements for Folium maps.

Jinja2requiredUsed for templating map elements.

NumpyrequiredOften used for numerical data handling, especially with geospatial data.

requestsrequiredUsed for fetching data from URLs, e.g., GeoJSON data.

pandasoptionalCommonly used for data manipulation before visualization on maps.

xyzservicesoptionalProvides a repository of raster basemap tilesets for more tile options.

Agent activity

5 hits · last 30 days

node

Resources

githubhttps://github.com/python-visualization/folium ↗

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