geolibre 0.2.0

GeoLibre in Jupyter: the full GeoLibre GIS app as an anywidget, with a leafmap-style Python API.

geolibre

GeoLibre in Jupyter: the full GeoLibre GIS app as an anywidget, with a leafmap-style Python API.

The widget embeds the complete GeoLibre app (menus, panels, processing tools) inside a notebook cell. State syncs both ways through a single .geolibre.json project, so data you add from Python appears in the UI, and edits you make in the UI are readable back from Python.

Install

pip install geolibre

Quickstart

from geolibre import Map

m = Map(center=(-100, 40), zoom=4)
m.add_geojson("https://example.com/data.geojson", name="Data")
m

Add more data and drive the view:

m.add_tile_layer(
    "https://tile.openstreetmap.org/{z}/{x}/{y}.png",
    name="OpenStreetMap",
    attribution="(c) OpenStreetMap contributors",
)
m.add_cog("https://example.com/dem.tif", name="DEM", colormap="terrain")
m.add_basemap("dark")
m.set_center(-120, 47, zoom=8)

Round-trip the project:

m.save_project("my-map.geolibre.json")

m2 = Map()
m2.load_project("my-map.geolibre.json")

# Read state edited in the UI (e.g. after panning/zooming):
m.to_project()["mapView"]["center"]

API

Method	Description
Map(center, zoom, basemap=, height=, layout=, theme=)	Create a map. layout is "embed", "full", or "maponly".
add_geojson(data, name=, **style)	Add GeoJSON (dict, path, URL, JSON, or GeoDataFrame).
add_tile_layer(url, name=, tile_size=, attribution=)	Add a raster XYZ tile layer.
add_cog(url, name=, bands=, colormap=, rescale=)	Add a Cloud Optimized GeoTIFF.
add_basemap(basemap)	Set the background basemap.
set_center(lng, lat, zoom=None)	Center (and optionally zoom) the map.
remove_layer(layer_id) / clear_layers()	Remove layers.
to_project() / load_project(src) / save_project(path)	Project I/O.

Notes

• The bundled app is served from a localhost HTTP server, so the interactive widget works in local Jupyter, VS Code, and Google Colab (Colab routes through its built-in port proxy automatically). Other remote setups (JupyterHub, Binder) where the browser cannot reach the kernel's localhost and no port proxy is configured are not yet supported.
• Optional extras: pip install geolibre[all] adds GeoPandas/Shapely support for add_geojson(geodataframe).