## 🧭 Features at a glance

- **Pins**: Labels, addresses, pin types, custom images, and tap handling via `PinClicked`.
- **Shapes**: Draw **polygons**, **polylines**, and **circles** to outline areas or routes.
- **Map interactions**: Handle `MapClicked`, move the camera/region, and programmatically add or remove map elements at runtime.
- **Map display**: Switch map types (e.g., Street, Satellite, Hybrid) and control gesture support (scroll, zoom, rotate).
- **User location**: Show the user’s current location with `IsShowingUser` (platform location permission required).

### Samples: pins and shapes

```xml
<maps:Map xmlns:maps="http://schemas.microsoft.com/dotnet/2021/maui/maps"
       xmlns:sensors="clr-namespace:Microsoft.Maui.Devices.Sensors;assembly=Microsoft.Maui.Essentials"
       MapType="Hybrid" MapClicked="OnMapClicked">
 <maps:Map.Pins>
     <maps:Pin Label="Office" Type="Place">
         <maps:Pin.Location>
             <sensors:Location>
                 <x:Arguments>
                     <x:Double>47.6424</x:Double>
                     <x:Double>-122.3219</x:Double>
                 </x:Arguments>
             </sensors:Location>
         </maps:Pin.Location>
     </maps:Pin>
 </maps:Map.Pins>

 <maps:Map.MapElements>
     <maps:Polygon StrokeColor="Red" FillColor="#40FF0000" StrokeWidth="4">
         <maps:Polygon.Geopath>
             <sensors:Location>
                 <x:Arguments>
                     <x:Double>47.642</x:Double>
                     <x:Double>-122.323</x:Double>
                 </x:Arguments>
             </sensors:Location>
             <sensors:Location>
                 <x:Arguments>
                     <x:Double>47.643</x:Double>
                     <x:Double>-122.326</x:Double>
                 </x:Arguments>
             </sensors:Location>
             <sensors:Location>
                 <x:Arguments>
                     <x:Double>47.640</x:Double>
                     <x:Double>-122.327</x:Double>
                 </x:Arguments>
             </sensors:Location>
         </maps:Polygon.Geopath>
     </maps:Polygon>

     <maps:Polyline StrokeColor="DodgerBlue" StrokeWidth="6">
         <maps:Polyline.Geopath>
             <sensors:Location>
                 <x:Arguments>
                     <x:Double>47.639</x:Double>
                     <x:Double>-122.330</x:Double>
                 </x:Arguments>
             </sensors:Location>
             <sensors:Location>
                 <x:Arguments>
                     <x:Double>47.640</x:Double>
                     <x:Double>-122.335</x:Double>
                 </x:Arguments>
             </sensors:Location>
         </maps:Polyline.Geopath>
     </maps:Polyline>

     <maps:Circle StrokeColor="Green" FillColor="#40008000" StrokeWidth="3">
         <maps:Circle.Center>
             <sensors:Location>
                 <x:Arguments>
                     <x:Double>47.641</x:Double>
                     <x:Double>-122.329</x:Double>
                 </x:Arguments>
             </sensors:Location>
         </maps:Circle.Center>
         <maps:Circle.Radius>
             <maps:Distance>
                 <x:Arguments>
                     <x:Double>200</x:Double>
                 </x:Arguments>
             </maps:Distance>
         </maps:Circle.Radius>
     </maps:Circle>
 </maps:Map.MapElements>
</maps:Map>

Samples: interactions and map modes

// In code-behind
void OnMapClicked(object sender, MapClickedEventArgs e)
{
    // Drop a pin where the user tapped
    var map = (Map)sender;
    map.Pins.Add(new Pin
    {
        Label = "Dropped pin",
        Type = PinType.Place,
        Location = e.Location
    });

    // Move/zoom to the tapped location
    map.MoveToRegion(MapSpan.FromCenterAndRadius(e.Location, Distance.FromMeters(500)));
}

// Toggle map display mode
void ToggleMapType(Map map) =>
    map.MapType = map.MapType == MapType.Street ? MapType.Satellite : MapType.Street;

// Common runtime toggles
void EnableLocationAndTraffic(Map map)
{
    map.IsShowingUser = true;      // requires location permission on the device
    map.IsTrafficEnabled = true;   // show live traffic where supported
}

📚 Learn more

• .NET MAUI Map control docs – capabilities, events, and platform guidance
• .NET MAUI documentation – build and ship cross-platform apps