Skip to main content

Attribution & logo

Two optional overlays sit at the bottom of the map: an OSM credit line in the bottom-left and a maproll wordmark in the bottom-right. Attribution is on by default; the logo is opt-in.

Examples​

Default render — OSM credit on, logo hidden

https://api.maproll.io/map.svg?scope=world&data=US:1&theme=dark
World map with default OSM attribution in the bottom-left, no logo

Attribution and logo both on

https://api.maproll.io/map.svg?scope=world&data=US:200,CN:150,IN:80,BR:60,RU:120,DE:95,FR:40&theme=dark&logo=true
World choropleth with OSM attribution bottom-left and maproll wordmark bottom-right, legend stacked above the wordmark

All overlays off

https://api.maproll.io/map.svg?scope=world&data=US:1&theme=dark&attribution=false
Clean world map with no attribution text and no logo

Parameters​

ParamTypeDefaultAllowedNotes
attributionbooleantruetrue / falseShows "© OpenStreetMap contributors" at low opacity in the bottom-left.
logobooleanfalsetrue / falseShows the "maproll" wordmark in the bottom-right.

Notes​

Why attribution is on by default. The geometry in every maproll render is derived from OpenStreetMap data, which is published under the Open Database Licence (ODbL). The ODbL requires attribution when you produce a rendered map. Showing "© OpenStreetMap contributors" on the image is the recommended way to satisfy that requirement. We recommend leaving it on.

Legend stacking. When logo=true and the legend is also visible, the legend is pushed up automatically so the two elements stack vertically rather than overlap. The stacking happens in the bottom-right corner only.

Scale bar stacking. scaleBar=true puts a scale bar in the bottom-left, where the attribution sits. The attribution shifts up to stack above it. The legend is unaffected by the scale bar — only the logo moves it.

API keys and the wordmark. logo is yours to set: logo=false is the default and is honoured for ordinary callers, with or without an account. The one exception is traffic tagged src=mcp (renders coming through the maproll MCP server), where the wordmark is forced on unless the request carries a valid API key. A key changes nothing else about the image. See Authentication for where to pass one and what it does to the cache headers.

No map-area shrink. Both overlays sit on top of the rendered map; they do not reduce the area available to the projection. On maps with data or labels near the bottom edge, the text may overlap fills.

Text is fixed. Attribution is always "© OpenStreetMap contributors". The logo is always the text "maproll". Customising either string is not currently supported.