Drawing

Let users draw markers, lines, and polygons on the map and submit the results.

Basic drawing

Enable the default drawing tools (polyline, polygon, marker) with a download-on-submit fallback:

ResultSource

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

from mapyta import Map, MapConfig

m = Map(title="Drawing demo", center=(52.0907, 5.1214), config=MapConfig(zoom_start=13))
m.enable_draw()

m.to_html("custom.html")

Use the toolbar in the top-left corner of the map to draw:

Click the polyline, polygon, or marker icon to start drawing
Click on the map to add points; double-click to finish a shape
Click Submit (bottom-right) to download a GeoJSON file with all drawn shapes

Custom tools

Pick only the tools you need:

ResultSource

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

from mapyta import Map, MapConfig

m = Map(title="Polygons only", center=(52.0907, 5.1214), config=MapConfig(zoom_start=13))
m.enable_draw(tools=["polygon", "rectangle"])

Valid tools: "marker", "polyline", "polygon", "rectangle", "circle".

Submit to a URL

Post drawn geometries to an API endpoint:

m.enable_draw(on_submit="https://api.example.com/shapes")

This sends a POST request with the GeoJSON FeatureCollection as the body.

Custom JavaScript callback

For full control, pass a RawJS function expression:

ResultSource

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

from mapyta import Map, MapConfig, RawJS

m = Map(title="Custom callback, check console (F12)", center=(52.0907, 5.1214), config=MapConfig(zoom_start=13))
m.enable_draw(on_submit=RawJS("function(geojson) { console.log(geojson); }"))

Click Submit and check the browser console (F12) to see the GeoJSON output.

Or call a named function already on the page:

m.enable_draw(on_submit="myGlobalHandler")

This generates window["myGlobalHandler"](geojson).

DrawConfig reference

Field	Default	Description
`tools`	`["polyline", "polygon", "marker"]`	Active drawing tools
`on_submit`	`None` (download)	Callback: `None`, URL, function name, or `RawJS`
`position`	`"topleft"`	Toolbar position
`submit_label`	`"Submit"`	Submit button text
`draw_style`	`None`	`shapeOptions` override
`edit`	`True`	Enable edit/delete controls