Blazor Maps Control: The Perfect Tool to Visualize Maps | Syncfusion Blogs
Live Chat Icon For mobile
Live Chat Icon
Popular Categories.NET  (179).NET Core  (28).NET MAUI  (214)Angular  (110)ASP.NET  (51)ASP.NET Core  (83)ASP.NET MVC  (90)Azure  (41)Black Friday Deal  (1)Blazor  (226)BoldSign  (15)DocIO  (24)Essential JS 2  (109)Essential Studio  (200)File Formats  (69)Flutter  (133)JavaScript  (226)Microsoft  (120)PDF  (81)Python  (1)React  (105)Streamlit  (1)Succinctly series  (131)Syncfusion  (942)TypeScript  (33)Uno Platform  (3)UWP  (3)Vue  (45)Webinar  (52)Windows Forms  (61)WinUI  (71)WPF  (163)Xamarin  (160)XlsIO  (38)Other CategoriesBarcode  (5)BI  (29)Bold BI  (8)Bold Reports  (2)Build conference  (9)Business intelligence  (55)Button  (4)C#  (158)Chart  (140)Chart of the week  (54)Cloud  (15)Company  (443)Dashboard  (8)Data Science  (3)Data Validation  (8)DataGrid  (70)Development  (658)Doc  (8)DockingManager  (1)eBook  (99)Enterprise  (22)Entity Framework  (7)Essential Tools  (14)Excel  (43)Extensions  (22)File Manager  (7)Gantt  (19)Gauge  (12)Git  (5)Grid  (31)HTML  (13)Installer  (2)Knockout  (2)Language  (1)LINQPad  (1)Linux  (2)M-Commerce  (1)Metro Studio  (11)Mobile  (512)Mobile MVC  (9)OLAP server  (1)Open source  (1)Orubase  (12)Partners  (21)PDF viewer  (43)Performance  (12)PHP  (2)PivotGrid  (4)Predictive Analytics  (6)Report Server  (3)Reporting  (10)Reporting / Back Office  (11)Rich Text Editor  (12)Road Map  (12)Scheduler  (54)Security  (4)SfDataGrid  (9)Silverlight  (21)Sneak Peek  (31)Solution Services  (4)Spreadsheet  (11)SQL  (14)Stock Chart  (1)Surface  (4)Tablets  (5)Theme  (12)Tips and Tricks  (112)UI  (393)Uncategorized  (68)Unix  (2)User interface  (68)Visual State Manager  (2)Visual Studio  (31)Visual Studio Code  (19)Web  (614)What's new  (333)Windows 8  (19)Windows App  (2)Windows Phone  (15)Windows Phone 7  (9)WinRT  (26)
Blazor Maps Control: The Perfect Tool to Visualize Maps

Blazor Maps Control: The Perfect Tool to Visualize Maps

The primary goal of maps is to provide a visual representation of the world or parts of it. Political maps show us the shapes of countries, the locations of states and cities, and the distance between them. You can plot and view important data such as population density, weather forecasts, geographical features, flight routes, and street views on them. Maps have become an indispensable tool for displaying information that we encounter daily.

The Syncfusion Blazor Maps control completely serves these purposes. Its rich feature set includes layers and sublayers, navigation lines, annotations, animations, and more. Users can view not only a geographical map, but also custom shapes such as a floorplan of a room or building, or a venue’s seating chart.

Note: The Syncfusion Blazor Maps control is implemented to read the input shapefile or URL and draw the right shape. Syncfusion does not support shape designing. For this purpose, we recommend using online map providers.

Let’s explore the features of the Blazor Maps control to visualize the world elegantly!

Input data sources

In our Blazor Maps control, there are two types of input data sources:

  • Shapes.
  • Online web map services.


Shapes can represent the world map, a specific country or region, or a custom shape such as a building. The shapes are prepared in a GeoJSON-like format and saved with the *.json file extension. You can upload the shapefiles to online storage, whose link can be set as the data source or as a local file in the application itself.

Note: Currently, we support only polygon and multipolygon geometric types for shapes. We also have plans to add support for linestring and point in the near future.

Online web services

The Syncfusion Blazor Maps control supports inheriting the following online web map services through their APIs:

Furthermore, we have implemented a URL template so that any online map service provider using the following template can be previewed and interacted with in our Maps control.

Sample template: https://<domain_name>/maps/basic/{z}/{x}/{y}.png

  • ${x} indicates the tile image x-position.
  • ${y} indicates the tile image y-position.
  • ${z} represents the zoom factor (level).

Note: For more details, refer to the Easily Visualize Online Maps in a Blazor Application blog.

Layers and multiple layers

We can provide any of the previously listed input data sources to serve as the main layer in the Maps control. On top of the main layer, we can add any number of additional layers. This will result in a multilayer pattern.

A sublayer is a type of shapefile layer, i.e., GeoJSON-like format. It allows the loading of multiple shapefiles in a single map view. You can add a sublayer over the main layer to view a country’s cities, boundaries, roads, mountains, rivers, and coastlines. Add other map elements, such as markers, bubbles, color mapping, and legends, to the sublayer for better visualization.

Location of African Continent on the World Map
Location of African Continent on the World Map

Note: Refer to the Multi-layers in Blazor Maps and documentation.

Data labels

Data labels provide users with information such as identification, notification, warning, environmental advice, or any other general information. In short, they are simple text displayed over the shapes. Data labels will smartly arrange themselves not to overlap using the smart labels option.

Showing Data Labels in Blazor Maps
Showing Data Labels in Blazor Maps

Note: Refer to the Example of Data Labels in Blazor Maps and documentation.


A marker is a visual representation that pinpoints a specific coordinate (location) on a map. A marker, by default, uses a standard shape such as a circle, rectangle, line, or balloon.

For a better user experience, we can customize markers to display images rather than predefined shapes.

The World Clock
The World Clock

Marker clustering

When there are a lot of markers that overlap, we can group the markers, a technique known as marker clustering. The number above the cluster indicates the count of overlapped markers in it. If we zoom in on any of the cluster locations, the number on the cluster will decrease, and the individual markers will be seen on the map.

Note: Refer to the Example of Markers in Blazor Maps and documentation.


Bubbles are yet another visualization medium that summarizes your input data. The feature creates simple circles of varying sizes. They represent the appropriate numerical value from the input data within the map area. Use these bubbles to compare proportions across different locations on the map. The bigger the bubble, the larger the numeric value.

TikTok Social Media Users Statistics
TikTok Social Media Users Statistics

Note: Refer to the Example of Bubbles in Blazor Maps and documentation.

Navigation lines

Navigation lines are used to show paths between two or more locations, e.g., flight or sea routes, a route from the current location to a destination, and cycling routes.

Flight Route Between Los Angeles and Mexico City
Flight Route Between Los Angeles and Mexico City

Note: Refer to the Example of Navigation Lines in Blazor Maps and documentation.


Annotations are similar to data labels, but they are used to draw more attention to specific characteristics in certain locations on a map. They provide highlighting information about them. In a nutshell, they are specific overlays of information that inform the user without overcrowding the map with other information. Including annotations in maps is becoming increasingly popular.

In the Maps control, you can display annotations with text, images, or a combination of both formats. You can add any number of annotations to the map using x and y coordinates.

Australian Cities Weather Report
Australian Cities Weather Report

Note: Refer to the Example of Annotations in Blazor Maps and documentation.

Color mapping

Color mapping is a technique of assigning different colors to different regions on a map. The assigned color palette is unique so that no two adjacent regions have the same color. On the other hand, we can set a single color to different regions or locations based on the numeric data value behind them and by adjusting the color’s opacity.

So, the color mapping in Blazor Maps is classified into range color mapping, equal color mapping, and desaturation color mapping. This feature is available not only for shapes but also for bubbles.

World Population Density -Range Color Mapping
World Population Density- Range Color Mapping
Spring Precipitation Averages of the World—Equal Color Mapping
Spring Precipitation Averages of the World- Equal Color Mapping
Spring Precipitation Averages of the World—Desaturation Color Mapping
Spring Precipitation Averages of the World- Desaturation Color Mapping

Note: Refer to the Example of Color Mapping in Blazor Maps and documentation.

Selection and highlighting

Users can hover over any shape and that shape will change to a distinct color to distinguish it from the other shapes. Similarly, we can select a specific shape via mouse click or touch interaction and it can also be highlighted using a different color.

The selection and highlight options also apply to markers and bubbles.

Refer to the following image. Here, Greenland is selected and highlighted and the mouse hovers over Canada (showing a tooltip).
Selection and Highlighting Features in Blazor MapsNote: Refer to the Example of Selection and Highlight in the Blazor Maps and documentation.

Zooming and panning

Zooming allows you to see the map in full depth, while panning allows you to move the zoomed map to view the entire map area.

To return the map to its original position, use the zoom-out and reset options. Zooming features include a zooming toolbar, single-click zoom, double-click zoom, mouse wheel zoom, selection zoom, and pinch zoom.

South America
South America
South America—Zoomed
South America- Zoomed

Note: Refer to the Example of Zooming and Panning in Blazor Maps and documentation.


In a map, there may be a large number of different symbols, and it is difficult for users to understand each one; this is where legends come in handy.

A legend is a glossary of the symbols used in a map. There are two types of legends supported in the Maps control: default and interactive. Marker and bubble definitions can also be displayed in legends.

Legend Showing Average Internet Price in Africa
Legend Showing Average Internet Price in Africa

Note: Refer to the Example of a Legend in Blazor Maps and documentation.

Drill down

You can view inner map layers by clicking a shape in the outer layer using the drill-down feature. For example, in a world map, you can see information about a specific country by clicking on that country. Then, the Blazor Maps control will display just that country by loading its shape via the drill-down feature.

Note: Refer to the Example of Drill Down in Blazor Maps and documentation.

GitHub reference

Check out the Blazor Maps component demos in our GitHub repository.


Thanks for reading! The Syncfusion Blazor Maps component also provides tooltips, printing, exporting, appearance customization, and more. Try out these features and elegantly visualize the world using our Blazor Maps control!

For existing customers, the newest version of our Blazor components is available for download from the License and Downloads page. If you are not yet a Syncfusion customer, you can try our 30-day free trial to check out the available features.

You can contact us with questions or comments through our support forumssupport portal, or feedback portal. We are always happy to assist you!

Related blogs


Share this post:

Popular Now

Be the first to get updates

Subscribe RSS feed

Be the first to get updates

Subscribe RSS feed