Skip to content

AnyMap

image image image image Conda Recipe image Conda Downloads image

A Python package for creating interactive maps with anywidget and JavaScript mapping libraries

Features

  • 🗺️ Interactive Maps: Create beautiful, interactive maps in Jupyter notebooks
  • 🔄 Bidirectional Communication: Full Python ↔ JavaScript communication
  • 📱 Multi-cell Support: Render maps in multiple notebook cells without conflicts
  • 🎯 MapLibre Integration: Built-in support for MapLibre GL JS
  • 🛠️ Extensible: Easy to add support for other mapping libraries
  • 🚀 Familiar API: Similar to ipyleaflet for easy migration

Installation

1
pip install anymap

1
conda install -c conda-forge anymap

Quick Start

1
2
3
4
5
6
7
8
9
from anymap import MapLibreMap

# Create a basic map
m = MapLibreMap(
    center=[37.7749, -122.4194],  # San Francisco
    zoom=12,
    height="600px"
)
m

Basic Usage

Creating Maps

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
from anymap import MapLibreMap

# Create a map with custom settings
m = MapLibreMap(
    center=[40.7128, -74.0060],  # New York City
    zoom=13,
    height="500px",
    bearing=45,  # Map rotation
    pitch=60     # 3D tilt
)

Adding Markers

1
2
3
4
5
6
# Add a marker with popup
m.add_marker(
    lat=40.7128,
    lng=-74.0060,
    popup="<h3>New York City</h3><p>The Big Apple</p>"
)

Working with GeoJSON

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# Add GeoJSON data
geojson_data = {
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [-74.0060, 40.7128]
            },
            "properties": {"name": "NYC"}
        }
    ]
}

m.add_geojson_layer(
    layer_id="cities",
    geojson_data=geojson_data,
    layer_type="circle",
    paint={
        "circle-radius": 8,
        "circle-color": "#ff0000"
    }
)

Event Handling

1
2
3
4
5
def handle_click(event):
    lat, lng = event['lngLat']
    print(f"Clicked at: {lat:.4f}, {lng:.4f}")

m.on_map_event('click', handle_click)

Dynamic Updates

1
2
3
4
5
6
# Change map properties
m.set_center(51.5074, -0.1278)  # London
m.set_zoom(14)

# Animate to a location
m.fly_to(48.8566, 2.3522, zoom=15)  # Paris

Multi-Cell Rendering

AnyMap is designed to work seamlessly across multiple notebook cells:

1
2
3
4
5
6
7
8
9
# Cell 1
m = MapLibreMap(center=[0, 0], zoom=2)
m

# Cell 2 - Same map instance
m.add_marker(0, 0, popup="Origin")

# Cell 3 - Display again
m

Advanced Features

Layer Management

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
# Add and remove layers
m.add_source("my-source", {
    "type": "geojson",
    "data": geojson_data
})

m.add_layer("my-layer", {
    "id": "my-layer",
    "type": "circle",
    "source": "my-source",
    "paint": {"circle-radius": 5}
})

# Remove layers
m.remove_layer("my-layer")
m.remove_source("my-source")

Custom JavaScript Methods

1
2
3
4
5
6
# Call any MapLibre GL JS method
m.call_js_method('easeTo', {
    'center': [lng, lat],
    'zoom': 14,
    'duration': 2000
})

Examples

Check out the example notebooks in the examples/ directory:

  • basic_usage.ipynb - Basic map creation and interaction
  • advanced_features.ipynb - Advanced layer management and styling
  • multi_cell_test.ipynb - Multi-cell rendering tests

Development

To set up for development:

1
2
3
git clone https://github.com/opengeos/anymap.git
cd anymap
pip install -e .

Run tests:

1
python -m unittest tests.test_anymap -v

Roadmap

  • ✅ MapLibre GL JS backend
  • ✅ Mapbox GL JS backend
  • 🔲 Leaflet backend
  • 🔲 OpenLayers backend
  • 🔲 DeckGL backend
  • 🔲 KeplerGL backend
  • 🔲 Cesium backend
  • 🔲 Potree backend

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.