Map Configuration

MapConfig controls the global look and feel: tile provider, zoom, dimensions, and optional plugins.

ResultSource

Make this Notebook Trusted to load map: File -> Trust Notebook

from shapely.geometry import Point
from mapyta import Map, MapConfig

config = MapConfig(
    tile_layer="cartodb_dark",
    zoom_start=14,
    fullscreen=True,
    minimap=True,
    measure_control=True,
    mouse_position=True,
)

m = Map(title="Dark Mode", config=config)
m.add_point(Point(5.1213, 52.0908), marker="🌃", tooltip="**Night Utrecht**")

m.to_html("dark_mode.html")

MapConfig fields

Field	Default	Description
`tile_layer`	`"cartodb_positron"`	Tile provider key or list of keys
`zoom_start`	`12`	Initial zoom level
`min_zoom`	`0`	Prevent zooming out beyond this level
`max_zoom`	`19`	Prevent zooming in beyond this level
`attribution`	`None`	Custom tile attribution
`width`	`"100%"`	Map width
`height`	`"100%"`	Map height
`control_scale`	`True`	Show scale bar
`fullscreen`	`False`	Add fullscreen button
`minimap`	`False`	Add inset minimap
`measure_control`	`False`	Add distance/area measurement tool
`mouse_position`	`True`	Show cursor coordinates

Available tile providers

Key	Description
`openstreetmap`	Default OpenStreetMap
`cartodb_positron`	Light, minimal CartoDB (default)
`cartodb_dark`	Dark CartoDB
`cartodb_voyager`	CartoDB Voyager, colourful, detailed
`esri_satellite`	Esri satellite imagery
`esri_topo`	Esri topographic
`esri_streets`	Esri street map
`esri_gray`	Esri light gray canvas
`esri_ocean`	Esri ocean basemap
`opentopomap`	OpenTopoMap, topographic with contour lines
`stamen_terrain`	Stamen terrain with hillshading
`stamen_toner`	Stamen high-contrast B&W
`stamen_watercolor`	Stamen watercolor, artistic style
`stadia_alidade`	Stadia Alidade Smooth, clean, light
`stadia_dark`	Stadia Alidade Dark, modern dark theme
`kadaster_brt`	Dutch Kadaster topographic
`kadaster_luchtfoto`	Dutch Kadaster aerial photos
`kadaster_grijs`	Dutch Kadaster greyscale

Multiple tile layers

Pass a list to tile_layer and add a layer control so users can switch between base maps:

```python exec="true" html="true" source="tabbed-right" from shapely.geometry import Point from mapyta import Map, MapConfig

m = Map( title="Multiple Tile Layers", config=MapConfig( tile_layer=["kartodb_positron", "cartodb_dark", "kadaster_brt"], ), ) m.add_point(Point(5.1213, 52.0908), marker="📍", tooltip="Utrecht") m.add_layer_control(collapsed=False)

print(m.to_html()) # markdown-exec: hide ```

The first layer in the list is shown by default. You can also add layers after construction with add_tile_layer():

m = Map(title="Multiple Tile Layers")
m.add_tile_layer(name="esri_satellite")
m.add_tile_layer(name="cartodb_dark")
m.add_layer_control(collapsed=False)