Map story

MapStoryControl

Tell a data story on a map users drill from world to continent to region.

Overview

MapStoryControl is a Blazor choropleth map that users drill from world to continent to region, shaded by value, with callouts and a source line. Use it for regional figures such as sales or survey results: define the story in C# or JSON as a MapStory, and RenderSvg writes the same graphic as static SVG for reports. The figures are real: ILO modeled rates via the World Bank, Eurostat regional rates and BLS state rates.

Examples

#Unemployment, world to province

Start at the world, open Europe and then Spain, France, Germany, Italy or Finland, or open the United States from North America; other countries stop at the national rate.

Unemployment by continent

Unemployment rate, 2025 4.0% to 6.2%

Labour-force-weighted average of ILO modelled national rates (World Bank SL.UEM.TOTL.ZS, 2025; labour force SL.TLF.TOTL.IN). World Bank updated 2026-10-08. Countries without a labour-force total are on the next map and out of the average. Boundaries: Natural Earth, public domain.

#Airports per country, then one country's airports

Click a country to open its 4,009-airport share on the plain map with one marker per airport; in the United States, China and Canada nearby markers merge into numbered clusters that zoom on click.

Airports with scheduled passenger service

Airports per country, color steps at 1, 3, 10, 30, 100, 634 1 to 634

OurAirports, public domain, 26 October 2026. Gray: no airport. 186 airports in small territories are not drawn at this scale.

#The same Europe graphic as static SVG

See the Europe level rendered by RenderSvg without a live circuit, as static SVG a report can place like any other image.

Italy, 6.2%. Opens the next map.Russia, 2.2%. Opens the next map.Denmark, 5.9%. Opens the next map.France, 8.2%. Opens the next map.UK, 4.9%. Opens the next map.Greece, 7.4%. Opens the next map.Malta, 3.4%. Opens the next map.Albania, no data. Opens the next map.Austria, 6.7%. Opens the next map.Bosnia and Herzegovina, no data. Opens the next map.Belgium, 5.9%. Opens the next map.Bulgaria, 3.5%. Opens the next map.Belarus, no data. Opens the next map.Switzerland, 5.1%. Opens the next map.Czechia, 3.2%. Opens the next map.Germany, 4.0%. Opens the next map.Estonia, 8.0%. Opens the next map.Spain, 10.0%. Opens the next map.Finland, 10.3%. Opens the next map.Croatia, 4.3%. Opens the next map.Hungary, 4.7%. Opens the next map.Ireland, 5.0%. Opens the next map.Lithuania, 6.1%. Opens the next map.Luxembourg, 7.3%. Opens the next map.Latvia, 7.3%. Opens the next map.Moldova, no data. Opens the next map.Montenegro, no data. Opens the next map.North Macedonia, no data. Opens the next map.Netherlands, 4.0%. Opens the next map.Norway, 4.5%. Opens the next map.Poland, 3.4%. Opens the next map.Portugal, 5.7%. Opens the next map.Romania, 6.4%. Opens the next map.Serbia, no data. Opens the next map.Sweden, 8.7%. Opens the next map.Slovenia, 3.4%. Opens the next map.Slovakia, 5.7%. Opens the next map.Ukraine, no data. Opens the next map.Kosovo, no data. Opens the next map.Cyprus, 4.1%. Opens the next map.Iceland, 5.8%. Opens the next map.4.1%Cyprus5.8%IcelandWeak hiring is keepingunemployment high in Finland.Germany's automakers are cuttingjobs amid U.S. tariffs and growingChinese competition.2.2%Russia4.5%Norway8.2%France6.2%Italy8.7%Sweden10.0%Spain10.3%Finland4.0%Germany4.9%UK3.4%Poland7.4%Greece6.4%Romania5.7%4.3%3.5%6.7%4.7%3.2%7.3%Latvia5.0%6.1%5.9%Denmark5.7%5.1%8.0%5.9%7.3%3.4%MaltaUNEMPLOYMENT IN EUROPEUnemployment rate (Aug. 2026)2.2%10.3%Switzerland and UK data from June 2026. Sources: Eurostat, ONS, Rosstat via Moscow Times.

Documentation

ParameterTypeDefaultDescription
StoryMapStory?nullThe levels, regions, color scale, callouts and source line to draw.
GeographyMapGeographyCatalog?nullBoundary catalog the levels are drawn on. The bundled Natural Earth and NUTS-2 / US set when null.
Widthint960Drawing width in pixels.
Heightint640Drawing height in pixels.
  • MapStory, MapStoryLevel, MapStoryRegion: the report. A region’s ChildLevelId is the map that opens next.
  • ChoroplethScale: sequential stops. The default runs from #F6E27A to #5A1228. Missing values use #C5C6C4.
  • MapStoryLevel.SampleData and MapStoryRegion.Sample: the graphic prints “Sample data” instead of presenting a stand-in number as published.
  • MapGeographyCatalog.Bundled: Natural Earth 1:110m countries (public domain) and simplified NUTS-2 / US state boundaries, embedded with the control. No tile server.
  • Sources for this story live in wwwroot/maps/stories/unemployment.json.
An unhandled error has occurred. Reload 🗙

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.