https://github.com/randyzwitch/streamlit-folium

Streamlit Component for rendering Folium maps
https://github.com/randyzwitch/streamlit-folium

folium folium-maps geospatial geospatial-visualization python streamlit streamlit-component visualization

Last synced: about 2 months ago
JSON representation

Streamlit Component for rendering Folium maps

• Host: GitHub
• URL: https://github.com/randyzwitch/streamlit-folium
• Owner: randyzwitch
• License: mit
• Created: 2020-07-17T16:13:51.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2024-07-23T17:46:33.000Z (2 months ago)
• Last Synced: 2024-07-24T00:17:55.480Z (2 months ago)
• Topics: folium, folium-maps, geospatial, geospatial-visualization, python, streamlit, streamlit-component, visualization
• Language: Python
• Homepage: https://folium.streamlit.app/
• Size: 9.51 MB
• Stars: 442
• Watchers: 9
• Forks: 163
• Open Issues: 17
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# streamlit-folium: geospatial made easy in Streamlit!

![Run tests each PR](https://github.com/randyzwitch/streamlit-folium/workflows/Run%20tests%20each%20PR/badge.svg)

[![Open in Streamlit](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://share.streamlit.io/randyzwitch/streamlit-folium/examples/streamlit_app.py)

streamlit-folium integrates two great open-source projects in the Python ecosystem: [Streamlit](https://streamlit.io/) and [Folium](https://python-visualization.github.io/folium/)!

## Installation

```python

pip install streamlit-folium

or

conda install -c conda-forge streamlit-folium

```

## Usage

Currently, there are two functions defined:

- `st_folium()`: a bi-directional Component, taking a Folium/Branca object and plotting to the Streamlit app. Upon mount/interaction with the Streamlit app, `st_folium()` returns a Dict with selected information including the bounding box and items clicked on

-  `folium_static()`: takes a `folium.Map`, `folium.Figure`, or `branca.element.Figure` object and displays it in a Streamlit app.

    Note: `folium_static()` is based on the `_repr_html()` representation created in Folium. This function should be a strict subset the of functionality of the newer `st_folium()` function. It is recommended that users switch to `st_folium()` as soon as possible, as `folium_static()` will likely be deprecated.

    If there is a reason why `folium_static()` needs to remain, please leave a GitHub issue describing your use case.

## Example

![streamlit_folium example](https://raw.githubusercontent.com/randyzwitch/streamlit-folium/master/tests/visual_baseline/test_basic/first_test/baseline.png)