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.

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.