Syncfusion.AspNetMvc.Maps

Syncfusion ASP.NET MVC Maps component

The Syncfusion ASP.NET MVC Maps is a powerful and flexible data visualization control for rendering geographic maps with support for GeoJSON and TopoJSON data formats.

Using this package with an AI coding agent

Before generating Syncfusion code, ask your AI coding agent to run the Syncfusion setup using the following prompt:

Set up this project for Syncfusion before generating code. Fetch and follow the official instructions at https://ai.syncfusion.com, then report the detected platform, installed skill pack, MCP status, and any required licensing action.

The setup detects your project's platform and loads the appropriate Syncfusion skill pack. No Syncfusion account or MCP key is required to install or read Syncfusion agent skills.

Platform reference: https://ai.syncfusion.com/aspnet-mvc/llms.txt

Key features

• GeoJSON and TopoJSON Support: Renders maps using industry-standard geospatial data formats
• Multiple Layer Types: Bubble, marker, color mapping, and choropleth layers for data visualization
• Interactive Navigation: Zooming, panning, and selection capabilities for exploring map data
• Tile Layer Integration: Support for OpenStreetMap and Bing Maps tile layers as base maps
• Annotations and Templates: Custom marker templates and annotations for enhanced visualization
• Legend and Tooltips: Display detailed region information with interactive legends and tooltips
• Multi-layer Support: Multiple layers and sublayers for complex geographic data visualization
• Export Capabilities: Export to PNG, JPEG, SVG, and PDF formats
• Responsive Design: Adapts seamlessly to different screen sizes and devices
• Accessibility: Built-in keyboard navigation and screen reader support

Common setup

These setup steps are required only once for your application, regardless of which Syncfusion components you use.

1. Install NuGet package

Install-Package Syncfusion.AspNetMvc.Maps

2. Add namespace reference

Edit Web.config under the Views folder and add the Syncfusion.EJ2 namespace:

<namespaces>
    <add namespace="Syncfusion.EJ2"/>
</namespaces>

3. Add stylesheet and script references

In your layout file (~/Views/Shared/_Layout.cshtml), add the following in the <head> section:

<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>@ViewBag.Title - Syncfusion Application</title>
    
    <!-- Syncfusion ASP.NET MVC controls styles -->
    <link rel="stylesheet" href="https://cdn.syncfusion.com/ej2/35.1.40/fluent2.css" />
    
    <!-- Syncfusion ASP.NET MVC controls scripts -->
    <script src="https://cdn.syncfusion.com/ej2/35.1.40/dist/ej2.min.js"></script>
</head>

4. Register script manager

At the end of the <body> tag in your layout file (~/Views/Shared/_Layout.cshtml):

<body>
    @RenderBody()
    
    <!-- Syncfusion ASP.NET MVC Script Manager -->
    @Html.EJS().ScriptManager()
</body>

Quick start

Step 1: Add the ASP.NET MVC Maps control

Add the Syncfusion ASP.NET MVC Maps control in the ~/Views/Home/Index.cshtml page:

    @Html.EJS().Maps("container").Layers(layer =>
    {
        layer.ShapeData(Model).Add();
    }).Render()

Step 2: Create controller ~/Controllers/HomeController.cs

public ActionResult Index()
{
    return View(GetWorldMap());
}

public object GetWorldMap()
{
    string allText = System.IO.File.ReadAllText(Server.MapPath("~/App_Data/WorldMap.json"));
    return JsonConvert.DeserializeObject(allText, typeof(object));
}

Step 3: Run the application

Press Ctrl+F5 to run the application in your browser.

Documentation

• Getting started
• API reference
• Live demos

Support

• Submit a support ticket

• Community forums

• Feature requests

License

This is a commercial product and requires a paid license for possession or use. Review the Syncfusion EULA

• Purchase a license

• Start a free 30-day trial

About Syncfusion

Syncfusion provides 1800+ components and frameworks for web, mobile, and desktop development across multiple platforms:

Web: Blazor | ASP.NET Core | ASP.NET MVC | JavaScript | Angular | React | Vue

Mobile: Flutter | MAUI | UWP

Desktop: WinForms | WPF | WinUI

Learn more at www.syncfusion.com

[email protected] | Toll Free: 1-888-9-DOTNET