Gallery

Every look below is the bundled Södermalm driving sample (ui/studio/samples/sodermalm_driving.geojson) — one gpd.read_file(...) call, then render_edges with the keywords shown. Thumbnails are real rs.snapshot() screenshots (regenerate with python docs/build_gallery.py).

import geopandas as gpd
import roadstyle as rs
edges = gpd.read_file("ui/studio/samples/sodermalm_driving.geojson")

The defaults

highsat palette on the Voyager base — what you get with no arguments.

rs.render_edges(edges)

OSM-Carto on Positron

The classic muted openstreetmap-carto tones.

rs.render_edges(edges, palette="carto", basemap="positron")

Dark

rs.render_edges(edges, basemap="dark_matter")

Blank canvas (offline)

mono palette on the tile-less blank base map — zero network requests, print-clean.

rs.render_edges(edges, palette="mono", basemap="blank", basemap_switcher=False)

Satellite

rs.render_edges(edges, basemap="satellite")

Data-driven colour

Any numeric column → a colormap + legend (categorical mappings work too, see Palettes).

rs.render_edges(edges, color_by="maxspeed_kmh", cmap="plasma", legend=True, basemap="positron")

3D bridges

view_3d=True: tilted camera and extruded, ramped, black-cased bridge decks — look under a bridge and see the roads passing beneath. Below zoom 16 bridges draw as classic flat cased lines (bridge_decks.flat_below).

rs.render_edges(edges, view_3d=True)

The sidebar dashboard (UI template)

Every built-in control replaced by plain HTML driving the JS API — query box, verb buttons, clickable results table, detail panel. Copy it from ui/dashboard/.

python ui/dashboard/build.py your_edges.gpkg            # add --tiles for ~10⁵-edge networks

roadstyle studio (Streamlit workbench)

The whole library behind a few knobs — live map on the right, the exact render_edges code for the current state below it, and a download button for the self-contained HTML. Three pages — Map, Dashboard, Report — the gentlest introduction to the library. See the Studio page for the full walkthrough.

pip install "roadstyle[studio]" && roadstyle studio