Implementing .NET MAUI Maps (SfMaps)

A comprehensive skill for implementing Syncfusion's .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

Syncfusion .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

Topics covered:

• 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

Topics covered:

• 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

Topics covered:

• 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

Topics covered:

• 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

Topics covered:

• 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

Topics covered:

• 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

Topics covered:

• 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

Topics covered:

• 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

Topics covered:

• 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

Topics covered:

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