Changelog
Future releases will be logged here in reverse-chronological order.
2026-05-25 — Public preview
Initial public release of the maproll rendering API at https://api.maproll.io.
What shipped:
- Two endpoints:
GET /map.{svg,png}(URL-only, cache-friendly) andPOST /render/map(full JSON body). - Two scopes:
world(countries, OSM-derived) andRO(Romania regions, OSM-derived). Both available atlow,medium, andhighdetail levels. - Six themes:
light,dark,satellite,terrain,minimal,contrast. - Five projections:
naturalEarth1,albersUsa,conicConformal,mercator,equalEarth. - Color scales:
sequential,diverging,categoricalwith Jenks, quantile, equal-interval, and custom break classification. - Proportional symbols: sized circles, optionally dual-encoded with choropleth fill.
- Five fill patterns:
stripes,stripes-diagonal,dots,crosshatch,solid-outline. - 30 marker icons with label positioning.
- Routes: great-circle paths with optional arrows, dashes, and custom colors.
- Region labels: ISO mode and explicit id lists, with
labelMinAreafiltering. - Cartographic overlays: north arrow, scale bar, graticule.
- Annotations: per-region SVG
<title>hover tooltips. - Title, subtitle, attribution, and logo branding fields.
- Three legend layouts:
vertical,horizontal,continuous. - Immutable caching:
Cache-Control: public, max-age=31536000, immutable+ ETag +304 Not Modifiedsupport. - PNG rasterisation via
@resvg/resvg-js(no headless browser).