python-visualization/folium
Folium
Folium is a Python library that builds interactive Leaflet.js maps directly from Python data structures, enabling geographic data visualization in Jupyter notebooks or as standalone HTML pages. It creates maps centered on given coordinates with configurable zoom, tiles, and dimensions, and supports embedding those maps inside web routes for serving in browsers.
The library provides a comprehensive set of tools for data-driven map creation, including choropleth maps that bind tabular data to geographic geometries, colormap application to markers and polygons, and GeoJSON data overlay and visualization. It offers interactive marker placement with popups and tooltips, shape drawing for circles, polygons, polylines, and rectangles, and layer grouping for toggling visibility. Additional capabilities include marker clustering, tile set switching, custom tile provider usage, and the ability to inject custom JavaScript or CSS into the map's HTML output.
Folium supports a range of map interactions and visual enhancements, such as custom JavaScript event handlers, polygon editing tools, location search via geocoding, and fullscreen mode toggling. It can overlay georeferenced images, display animated polylines, and arrange multiple maps in a grid layout for comparative viewing. The library is installed via standard Python package management and integrates with Jupyter notebooks for inline map rendering.
Features
- Interactive Map Generations - Builds interactive Leaflet.js maps directly from Python data structures for notebooks or web pages.
- Base Map Creation - Creates interactive Leaflet maps centered on given coordinates with configurable zoom, tiles, and dimensions.
- Interactive GeoJSON Layers - Loads geographic data from a URL, file, or dictionary and renders it as a map layer.
- Choropleth Maps - Binds tabular data to geographic geometries and colors regions based on values.
- Extended Map Layer Capabilities - Overlays raster tiles, vector shapes, or GeoJSON data onto a base map for multi-layered displays.
- Geographic Data Mapping - Creates interactive Leaflet.js maps from Python data for geographic information visualization.
- Interactive Map Visualizations - Generates a Leaflet.js map centered on given coordinates for notebooks or standalone HTML.
- Notebook Map Embeds - Renders interactive maps directly inside Jupyter notebook cells without external hosting.
- Markers with Popups - Places rich vector, raster, or HTML markers on a map that users can click or hover to explore.
- Map Data Overlays - Adds markers, choropleths, and other data-driven layers on top of a base map.
- Colormap Applications - Applies continuous color scales to markers, polygons, and choropleths based on numeric values.
- Choropleth Data Bindings - Associates geographic data with map regions to create choropleth visualizations.
- GeoJSON Data Bindings - Colors geographic features based on columnar data using a color scale and configurable binning.
- Map Layer Groups - Groups related map layers into collapsible subgroups for toggling visibility via a layer control.
- Map Tile Source Switching - Selects from built-in tile sets or loads custom tile sources to change the map's visual style.
- Shape Drawing - Places polylines, polygons, rectangles, circles, and circle markers on the map with customizable styling.
- Map - Renders circles, polygons, polylines, and rectangles on a map to highlight areas or paths.
- Map Vector Lines - Overlays polyline shapes such as trails or roads onto a map to highlight linear features.
- Polygon Drawing - Creates polygon shapes on the map by connecting a list of latitude/longitude points in order.
- Map Layer Groupings - Organizes markers and shapes into named groups that users can toggle on and off with a layer control.
- Custom Tile Provider Support - Adds a tile layer from built-in providers or a custom URL to display map imagery at multiple zoom levels.
- Map Marker - Replaces default marker icons with styled icons using Font Awesome symbols, colors, and shapes.
- Map Display Options - Adjusts the map's zoom level, panning limits, and visible UI elements like the scale bar.
- Marker Clustering - Groups overlapping markers into clusters that expand as the user zooms in for cleaner display.
- Image Overlays - Displays a single image over specified geographic bounds, accepting file paths, URLs, or array data.
- Geographical Tools - Interactive map visualization using Leaflet.js.
- Geospatial Analysis - Python interface for creating interactive Leaflet.js maps.
- Visualization Frameworks - Python interface for Leaflet.js mapping.
