$npx -y skills add syncfusion/maui-ui-components-skills --skill syncfusion-maui-mapsImplements Syncfusion .NET MAUI Maps (SfMaps) control. Use when implementing maps, visualizing geographic data, or displaying shape layers and tile layers (OpenStreetMap, Azure maps, Google Maps, Bing Maps). Covers markers, bubbles, legends, data labels, tooltips, sublayers, zoom
| 1 | # Implementing .NET MAUI Maps (SfMaps) |
| 2 | |
| 3 | 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. |
| 4 | |
| 5 | ## When to Use This Skill |
| 6 | |
| 7 | Use this skill when you need to: |
| 8 | |
| 9 | - **Install and configure** Syncfusion .NET MAUI Maps (SfMaps) control |
| 10 | - **Display geographic data** using shape layers with shapefile data |
| 11 | - **Integrate tile-based maps** from providers. |
| 12 | - **Add markers** to denote locations with built-in symbols or custom content |
| 13 | - **Visualize data** with bubbles, color mapping, and choropleth maps |
| 14 | - **Display legends** for shapes or bubbles with customizable appearance |
| 15 | - **Show data labels** on map shapes with smart positioning |
| 16 | - **Add sublayers** (circle, arc, line, polygon, polyline) for additional data visualization |
| 17 | - **Enable interactions** like zoom, pan, shape selection, and tooltips |
| 18 | - **Implement AI-driven location search** for smart geocoding and search |
| 19 | |
| 20 | ## Component Overview |
| 21 | |
| 22 | **Syncfusion .NET MAUI Maps** provides two primary layer types: |
| 23 | |
| 24 | 1. **Shape Layer (`MapShapeLayer`)**: Renders vector maps from GeoJSON or shapefile data |
| 25 | 2. **Tile Layer (`MapTileLayer`)**: Renders raster map tiles from web map tile services |
| 26 | |
| 27 | **Key Features:** |
| 28 | - Multiple layer support with sublayers |
| 29 | - Markers with built-in and custom templates |
| 30 | - Bubble visualization for data representation |
| 31 | - Color mapping (equal and range-based) |
| 32 | - Interactive legends |
| 33 | - Data labels with smart positioning |
| 34 | - Zoom and pan capabilities |
| 35 | - Shape selection and tooltips |
| 36 | - AI-driven location search |
| 37 | |
| 38 | **Platforms Supported:** Android, iOS, Windows, macOS |
| 39 | |
| 40 | ## Documentation and Navigation Guide |
| 41 | |
| 42 | ### Getting Started |
| 43 | |
| 44 | 📄 **Read:** [references/getting-started.md](references/getting-started.md) |
| 45 | |
| 46 | When to read: First-time setup, installation, basic map creation |
| 47 | |
| 48 | **Topics covered:** |
| 49 | - NuGet package installation (`Syncfusion.Maui.Maps`) |
| 50 | - Handler registration in `MauiProgram.cs` |
| 51 | - Creating your first map with shape layer |
| 52 | - Loading shapefile data from local. |
| 53 | - Creating your first map with tile layer |
| 54 | - Basic configuration and map display |
| 55 | |
| 56 | ### Layer Types |
| 57 | |
| 58 | #### Shape Layer |
| 59 | |
| 60 | 📄 **Read:** [references/shape-layer.md](references/shape-layer.md) |
| 61 | |
| 62 | When to read: Working with vector maps, shapefile data, choropleth maps, data binding |
| 63 | |
| 64 | **Topics covered:** |
| 65 | - `MapShapeLayer` overview and configuration |
| 66 | - Loading shape data |
| 67 | - Data source binding with `DataSource`, `PrimaryValuePath`, and `ShapeDataField` |
| 68 | - Color mapping strategies (EqualColorMapping, RangeColorMapping) |
| 69 | - Shape styling (fill, stroke, hover states) |
| 70 | - Shape customization and theming |
| 71 | - AOT mode considerations and preservation attributes |
| 72 | |
| 73 | #### Tile Layer |
| 74 | |
| 75 | 📄 **Read:** [references/tile-layer.md](references/tile-layer.md) |
| 76 | |
| 77 | When to read: Integrating OpenStreetMap, Bing Maps, or other tile providers |
| 78 | |
| 79 | **Topics covered:** |
| 80 | - `MapTileLayer` overview |
| 81 | - URL template format and WMTS specification |
| 82 | - Subscription key configuration |
| 83 | - Map center and zoom settings |
| 84 | - Map type variations (Road, Aerial, etc.) |
| 85 | |
| 86 | ### Visual Elements |
| 87 | |
| 88 | #### Markers |
| 89 | |
| 90 | 📄 **Read:** [references/markers.md](references/markers.md) |
| 91 | |
| 92 | When to read: Adding location markers, pins, or custom markers to maps |
| 93 | |
| 94 | **Topics covered:** |
| 95 | - `MapMarker` overview and `MapMarkerCollection` |
| 96 | - Adding markers to shape layers |
| 97 | - Adding markers to tile layers |
| 98 | - Built-in icon types (Circle, Diamond, Rectangle, Square) |
| 99 | - Marker positioning with latitude/longitude |
| 100 | - Icon customization (size, color, fill, stroke) |
| 101 | - Custom marker templates with `MarkerTemplate` |
| 102 | - Marker alignment, offset, and anchoring |
| 103 | - Marker tooltips |
| 104 | - Marker events and selection |
| 105 | |
| 106 | #### Bubbles |
| 107 | |
| 108 | 📄 **Read:** [references/bubbles.md](references/bubbles.md) |
| 109 | |
| 110 | When to read: Visualizing data with size/color-coded bubbles on shapes |
| 111 | |
| 112 | **Topics covered:** |
| 113 | - Bubble visualization overview |
| 114 | - Enabling bubbles with `ShowBubbles` |
| 115 | - `BubbleSettings` configuration |
| 116 | - Size-based bubbles with `SizeValuePath`, `MinSize`, `MaxSize` |
| 117 | - Color-based bubbles with `ColorValuePath` |
| 118 | - Bubble styling (fill, stroke, opacity) |
| 119 | - Bubble tooltips |
| 120 | - Bubble color mapping |
| 121 | - Multiple bubble series |
| 122 | |
| 123 | #### Data Labels |
| 124 | |
| 125 | 📄 **Read:** [references/data-labels.md](references/data-labels.md) |
| 126 | |
| 127 | When to read: Displaying text labels on map shapes |
| 128 | |
| 129 | **Topics covered:** |
| 130 | - Data label overview and purpose |
| 131 | - Enabling labels with `ShowDataLabels` |
| 132 | - `DataLabelSettings` configuration |
| 133 | - `DataLabelPath` for binding label text |
| 134 | - Label styling (font, c |