Skip to content

Examples

A few of the things maproll can do. Every render is a single URL — copy it into any image tag.

World map, dark theme

A standard sequential color map of the world. Pass id:value pairs and maproll bins them across the theme's color ramp.

GET /map.svg?scope=world&data=US:200,CN:150,IN:80,...&theme=dark

Region highlight, no values

Skip the data and just highlight a set of regions. Use the regions= query param with a comma-separated list of ISO codes.

GET /map.svg?scope=world&regions=RO,DE,FR,IT,ES,PT,NL,...&theme=light-mono

Diverging color scale

Switch the color scale to diverging when values cross zero. The scale anchors at the midpoint and uses a perceptually balanced palette.

GET /map.svg?scope=world&data=US:5,CN:8,RU:-5,DE:6,...&theme=light&colorScale=diverging

Shipping lanes via Suez

Add `sea` to a route to thread the Eurostat marnet instead of cutting a great circle over land. Same syntax, one extra token.

Proportional symbols + color fill

Pair a color fill with sized circles for dual-encoded data — color for one variable, area for another.

GET /map.svg?scope=world&data=US:80,CN:60,...&proportional=US:330,CN:1400,...

Cartographic overlays

North arrow, scale bar, graticule and region labels are independent toggles. Combine them for the cartographic polish a published report needs.

GET /map.svg?scope=RO&data=...&labels=ISO&northArrow=true&scaleBar=true

Pattern fills

Five SVG pattern fills (stripes, dots, crosshatch, …) per region. Useful for disputed territories, missing data or a second variable overlay.

GET /map.svg?scope=EU&data=...&patterns=DE:stripes,IT:dots,ES:crosshatch

NATO APP-6 / MIL-STD-2525 symbols

Pass a SIDC on any marker and maproll renders the proper military symbol — affiliation-framed unit, equipment or installation glyphs from the NATO Joint Military Symbology standard.

GET /map.svg?scope=UA&markers=50.45,30.52:30031000001211000000:HQ

Every example is a URL.

Copy any one of these into a README and you have a live, cached map.

Read the docsOpen the app