Implementing .NET MAUI Maps (SfMaps)

A comprehensive skill for implementing Syncfusion® .NET MAUI Maps control. The SfMaps control is a powerful data visualization component for displaying statistical information across geographical areas with highly interactive and customizable features.

When to Use This Skill

Use this skill when you need to:

• Install and configure Syncfusion® .NET MAUI Maps (SfMaps) control
• Display geographic data using shape layers with shapefile data
• Integrate tile-based maps from providers.
• Add markers to denote locations with built-in symbols or custom content
• Visualize data with bubbles, color mapping, and choropleth maps
• Display legends for shapes or bubbles with customizable appearance
• Show data labels on map shapes with smart positioning
• Add sublayers (circle, arc, line, polygon, polyline) for additional data visualization
• Enable interactions like zoom, pan, shape selection, and tooltips
• Implement AI-driven location search for smart geocoding and search

Component Overview

.NET MAUI Maps provides two primary layer types:

1. Shape Layer (MapShapeLayer): Renders vector maps from GeoJSON or shapefile data
2. Tile Layer (MapTileLayer): Renders raster map tiles from web map tile services

Key Features:

• Multiple layer support with sublayers
• Markers with built-in and custom templates
• Bubble visualization for data representation
• Color mapping (equal and range-based)
• Interactive legends
• Data labels with smart positioning
• Zoom and pan capabilities
• Shape selection and tooltips
• AI-driven location search

Platforms Supported: Android, iOS, Windows, macOS

Documentation and Navigation Guide

Getting Started

📄 Read: references/getting-started.md

When to read: First-time setup, installation, basic map creation

• NuGet package installation (Syncfusion.Maui.Maps)
• Handler registration in MauiProgram.cs
• Creating your first map with shape layer
• Loading shapefile data from local.
• Creating your first map with tile layer
• Basic configuration and map display

Layer Types

Shape Layer

📄 Read: references/shape-layer.md

When to read: Working with vector maps, shapefile data, choropleth maps, data binding

• MapShapeLayer overview and configuration
• Loading shape data
• Data source binding with DataSource, PrimaryValuePath, and ShapeDataField
• Color mapping strategies (EqualColorMapping, RangeColorMapping)
• Shape styling (fill, stroke, hover states)
• Shape customization and theming
• AOT mode considerations and preservation attributes

Tile Layer

📄 Read: references/tile-layer.md

When to read: Integrating OpenStreetMap, Bing Maps, or other tile providers

• MapTileLayer overview
• URL template format and WMTS specification
• Subscription key configuration
• Map center and zoom settings
• Map type variations (Road, Aerial, etc.)

Visual Elements

Markers

📄 Read: references/markers.md

When to read: Adding location markers, pins, or custom markers to maps

• MapMarker overview and MapMarkerCollection
• Adding markers to shape layers
• Adding markers to tile layers
• Built-in icon types (Circle, Diamond, Rectangle, Square)
• Marker positioning with latitude/longitude
• Icon customization (size, color, fill, stroke)
• Custom marker templates with MarkerTemplate
• Marker alignment, offset, and anchoring
• Marker tooltips
• Marker events and selection

Bubbles

📄 Read: references/bubbles.md

When to read: Visualizing data with size/color-coded bubbles on shapes

• Bubble visualization overview
• Enabling bubbles with ShowBubbles
• BubbleSettings configuration
• Size-based bubbles with SizeValuePath, MinSize, MaxSize
• Color-based bubbles with ColorValuePath
• Bubble styling (fill, stroke, opacity)
• Bubble tooltips
• Bubble color mapping
• Multiple bubble series

Data Labels

📄 Read: references/data-labels.md

When to read: Displaying text labels on map shapes

• Data label overview and purpose
• Enabling labels with ShowDataLabels
• DataLabelSettings configuration
• DataLabelPath for binding label text
• Label styling (font, color, size, weight)
• Label positioning and alignment
• Smart label behavior (trim, hide on overflow)
• Custom label templates
• Label interaction and events

Legends

📄 Read: references/legends.md

When to read: Adding legends for shapes or bubbles

• Legend overview and MapLegend configuration
• Shape legend with SourceType.Shape
• Bubble legend with SourceType.Bubble
• Legend placement (Top, Bottom, Left, Right)
• Legend text customization from ColorMapping.Text
• Icon customization (size, type, spacing)
• Legend positioning and padding
• Text style configuration with TextStyle
• Custom legend templates
• Legend visibility and toggling

Advanced Features

Sublayers

📄 Read: references/sublayers.md

When to read: Adding multiple layers, circles, arcs, lines, polygons, or polylines

• Sublayer overview and types
• MapShapeSublayer for additional shape layers
• MapCircle for radius-based circles
• MapArc for connecting two points with arcs
• MapLine for simple line connections
• MapPolygon for custom polygon shapes
• MapPolyline for multi-point line paths
• Sublayer data binding and collections
• Sublayer styling and appearance
• Multiple sublayers and stacking
• Layer z-index and ordering

Interaction Features

📄 Read: references/interaction-features.md

When to read: Enabling zoom, pan, selection, or tooltips

• Zoom and Pan:
  • EnableZooming and EnablePanning properties
  • ZoomPanBehavior configuration
  • MinZoomLevel and MaxZoomLevel
  • Programmatic zoom methods
  • Zooming to specific regions
• Selection:
  • Shape selection with EnableSelection
  • Selection appearance customization
  • Selection events and handlers
• Tooltips:
  • ShowShapeTooltip for shape tooltips
  • Tooltip templates and styling
  • Tooltips for markers and bubbles
  • Custom tooltip content

AI-Driven Location Search

📄 Read: references/ai-location-search.md

When to read: Implementing smart location search and geocoding

• AI-driven location search overview
• Smart search capabilities
• Location autocomplete
• Geocoding integration
• Search configuration
• Search result handling
• Custom search providers