Class MapView

A user interface control that displays two-dimensional (2D) geographic content defined by a Map.

Inheritance
System.Object
Microsoft.Maui.Controls.BindableObject
Microsoft.Maui.Controls.Element
Microsoft.Maui.Controls.NavigableElement
Microsoft.Maui.Controls.VisualElement
Microsoft.Maui.Controls.View
GeoView
MapView
Implements
System.ComponentModel.INotifyPropertyChanged
Microsoft.Maui.IVisualTreeElement
Microsoft.Maui.Controls.IEffectControlProvider
Microsoft.Maui.IToolTipElement
Microsoft.Maui.IContextFlyoutElement
Microsoft.Maui.Controls.IAnimatable
Microsoft.Maui.Controls.IViewController
Microsoft.Maui.Controls.IVisualElementController
Microsoft.Maui.Controls.IElementController
Microsoft.Maui.Controls.Internals.IGestureController
Microsoft.Maui.Controls.IGestureRecognizers
Microsoft.Maui.IPropertyMapperView
Microsoft.Maui.HotReload.IHotReloadableView
Microsoft.Maui.IReplaceableView
Microsoft.Maui.IView
Microsoft.Maui.IElement
Microsoft.Maui.ITransform
Microsoft.Maui.Controls.View.VerticalOptionsProperty
Microsoft.Maui.Controls.View.HorizontalOptionsProperty
Microsoft.Maui.Controls.View.MarginProperty
Microsoft.Maui.Controls.View.propertyMapper
Microsoft.Maui.Controls.View.ChangeVisualState()
Microsoft.Maui.Controls.View.GetChildElements(Microsoft.Maui.Graphics.Point)
Microsoft.Maui.Controls.View.OnBindingContextChanged()
Microsoft.Maui.Controls.View.GetRendererOverrides<T>()
Microsoft.Maui.Controls.View.Microsoft.Maui.IPropertyMapperView.GetPropertyMapperOverrides()
Microsoft.Maui.Controls.View.Microsoft.Maui.HotReload.IHotReloadableView.TransferState(Microsoft.Maui.IView)
Microsoft.Maui.Controls.View.Microsoft.Maui.HotReload.IHotReloadableView.Reload()
Microsoft.Maui.Controls.View.GestureController
Microsoft.Maui.Controls.View.GestureRecognizers
Microsoft.Maui.Controls.View.Microsoft.Maui.Controls.Internals.IGestureController.CompositeGestureRecognizers
Microsoft.Maui.Controls.View.HorizontalOptions
Microsoft.Maui.Controls.View.Margin
Microsoft.Maui.Controls.View.VerticalOptions
Microsoft.Maui.Controls.View.Microsoft.Maui.IView.Margin
Microsoft.Maui.Controls.View.Microsoft.Maui.IView.HorizontalLayoutAlignment
Microsoft.Maui.Controls.View.Microsoft.Maui.IView.VerticalLayoutAlignment
Microsoft.Maui.Controls.View.Microsoft.Maui.IReplaceableView.ReplacedView
Microsoft.Maui.Controls.View.Microsoft.Maui.HotReload.IHotReloadableView.ReloadHandler
Microsoft.Maui.Controls.VisualElement.NavigationProperty
Microsoft.Maui.Controls.VisualElement.StyleProperty
Microsoft.Maui.Controls.VisualElement.InputTransparentProperty
Microsoft.Maui.Controls.VisualElement.IsEnabledProperty
Microsoft.Maui.Controls.VisualElement.XProperty
Microsoft.Maui.Controls.VisualElement.YProperty
Microsoft.Maui.Controls.VisualElement.AnchorXProperty
Microsoft.Maui.Controls.VisualElement.AnchorYProperty
Microsoft.Maui.Controls.VisualElement.TranslationXProperty
Microsoft.Maui.Controls.VisualElement.TranslationYProperty
Microsoft.Maui.Controls.VisualElement.WidthProperty
Microsoft.Maui.Controls.VisualElement.HeightProperty
Microsoft.Maui.Controls.VisualElement.RotationProperty
Microsoft.Maui.Controls.VisualElement.RotationXProperty
Microsoft.Maui.Controls.VisualElement.RotationYProperty
Microsoft.Maui.Controls.VisualElement.ScaleProperty
Microsoft.Maui.Controls.VisualElement.ScaleXProperty
Microsoft.Maui.Controls.VisualElement.ScaleYProperty
Microsoft.Maui.Controls.VisualElement.ClipProperty
Microsoft.Maui.Controls.VisualElement.VisualProperty
Microsoft.Maui.Controls.VisualElement.IsVisibleProperty
Microsoft.Maui.Controls.VisualElement.OpacityProperty
Microsoft.Maui.Controls.VisualElement.BackgroundColorProperty
Microsoft.Maui.Controls.VisualElement.BackgroundProperty
Microsoft.Maui.Controls.VisualElement.BehaviorsProperty
Microsoft.Maui.Controls.VisualElement.TriggersProperty
Microsoft.Maui.Controls.VisualElement.WidthRequestProperty
Microsoft.Maui.Controls.VisualElement.HeightRequestProperty
Microsoft.Maui.Controls.VisualElement.MinimumWidthRequestProperty
Microsoft.Maui.Controls.VisualElement.MinimumHeightRequestProperty
Microsoft.Maui.Controls.VisualElement.MaximumWidthRequestProperty
Microsoft.Maui.Controls.VisualElement.MaximumHeightRequestProperty
Microsoft.Maui.Controls.VisualElement.IsFocusedProperty
Microsoft.Maui.Controls.VisualElement.FlowDirectionProperty
Microsoft.Maui.Controls.VisualElement.WindowProperty
Microsoft.Maui.Controls.VisualElement.ShadowProperty
Microsoft.Maui.Controls.VisualElement.ZIndexProperty
Microsoft.Maui.Controls.VisualElement.ControlsVisualElementMapper
Microsoft.Maui.Controls.VisualElement.BatchBegin()
Microsoft.Maui.Controls.VisualElement.BatchCommit()
Microsoft.Maui.Controls.VisualElement.Focus()
Microsoft.Maui.Controls.VisualElement.Measure(System.Double, System.Double, Microsoft.Maui.Controls.MeasureFlags)
Microsoft.Maui.Controls.VisualElement.Unfocus()
Microsoft.Maui.Controls.VisualElement.InvalidateMeasure()
Microsoft.Maui.Controls.VisualElement.OnChildAdded(Microsoft.Maui.Controls.Element)
Microsoft.Maui.Controls.VisualElement.OnChildRemoved(Microsoft.Maui.Controls.Element, System.Int32)
Microsoft.Maui.Controls.VisualElement.OnChildrenReordered()
Microsoft.Maui.Controls.VisualElement.OnMeasure(System.Double, System.Double)
Microsoft.Maui.Controls.VisualElement.OnSizeAllocated(System.Double, System.Double)
Microsoft.Maui.Controls.VisualElement.SizeAllocated(System.Double, System.Double)
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.Controls.IVisualElementController.InvalidateMeasure(Microsoft.Maui.Controls.Internals.InvalidationTrigger)
Microsoft.Maui.Controls.VisualElement.RefreshIsEnabledProperty()
Microsoft.Maui.Controls.VisualElement.Arrange(Microsoft.Maui.Graphics.Rect)
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.Arrange(Microsoft.Maui.Graphics.Rect)
Microsoft.Maui.Controls.VisualElement.ArrangeOverride(Microsoft.Maui.Graphics.Rect)
Microsoft.Maui.Controls.VisualElement.Layout(Microsoft.Maui.Graphics.Rect)
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.InvalidateMeasure()
Microsoft.Maui.Controls.VisualElement.InvalidateMeasureOverride()
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.InvalidateArrange()
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.Measure(System.Double, System.Double)
Microsoft.Maui.Controls.VisualElement.MeasureOverride(System.Double, System.Double)
Microsoft.Maui.Controls.VisualElement.MapBackgroundColor(Microsoft.Maui.IViewHandler, Microsoft.Maui.IView)
Microsoft.Maui.Controls.VisualElement.MapBackgroundImageSource(Microsoft.Maui.IViewHandler, Microsoft.Maui.IView)
Microsoft.Maui.Controls.VisualElement.MapAccessKeyHorizontalOffset(Microsoft.Maui.IViewHandler, Microsoft.Maui.IView)
Microsoft.Maui.Controls.VisualElement.MapAccessKeyPlacement(Microsoft.Maui.IViewHandler, Microsoft.Maui.IView)
Microsoft.Maui.Controls.VisualElement.MapAccessKey(Microsoft.Maui.IViewHandler, Microsoft.Maui.IView)
Microsoft.Maui.Controls.VisualElement.MapAccessKeyVerticalOffset(Microsoft.Maui.IViewHandler, Microsoft.Maui.IView)
Microsoft.Maui.Controls.VisualElement.Visual
Microsoft.Maui.Controls.VisualElement.FlowDirection
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.Controls.IVisualElementController.EffectiveFlowDirection
Microsoft.Maui.Controls.VisualElement.Window
Microsoft.Maui.Controls.VisualElement.AnchorX
Microsoft.Maui.Controls.VisualElement.AnchorY
Microsoft.Maui.Controls.VisualElement.BackgroundColor
Microsoft.Maui.Controls.VisualElement.Background
Microsoft.Maui.Controls.VisualElement.Behaviors
Microsoft.Maui.Controls.VisualElement.Bounds
Microsoft.Maui.Controls.VisualElement.Height
Microsoft.Maui.Controls.VisualElement.HeightRequest
Microsoft.Maui.Controls.VisualElement.InputTransparent
Microsoft.Maui.Controls.VisualElement.IsEnabled
Microsoft.Maui.Controls.VisualElement.IsEnabledCore
Microsoft.Maui.Controls.VisualElement.IsFocused
Microsoft.Maui.Controls.VisualElement.IsVisible
Microsoft.Maui.Controls.VisualElement.MinimumHeightRequest
Microsoft.Maui.Controls.VisualElement.MinimumWidthRequest
Microsoft.Maui.Controls.VisualElement.MaximumHeightRequest
Microsoft.Maui.Controls.VisualElement.MaximumWidthRequest
Microsoft.Maui.Controls.VisualElement.Opacity
Microsoft.Maui.Controls.VisualElement.Rotation
Microsoft.Maui.Controls.VisualElement.RotationX
Microsoft.Maui.Controls.VisualElement.RotationY
Microsoft.Maui.Controls.VisualElement.Scale
Microsoft.Maui.Controls.VisualElement.ScaleX
Microsoft.Maui.Controls.VisualElement.ScaleY
Microsoft.Maui.Controls.VisualElement.TranslationX
Microsoft.Maui.Controls.VisualElement.TranslationY
Microsoft.Maui.Controls.VisualElement.Triggers
Microsoft.Maui.Controls.VisualElement.Width
Microsoft.Maui.Controls.VisualElement.WidthRequest
Microsoft.Maui.Controls.VisualElement.X
Microsoft.Maui.Controls.VisualElement.Y
Microsoft.Maui.Controls.VisualElement.Clip
Microsoft.Maui.Controls.VisualElement.Resources
Microsoft.Maui.Controls.VisualElement.Frame
Microsoft.Maui.Controls.VisualElement.Handler
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.Background
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.Clip
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.Shadow
Microsoft.Maui.Controls.VisualElement.Shadow
Microsoft.Maui.Controls.VisualElement.ZIndex
Microsoft.Maui.Controls.VisualElement.DesiredSize
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.IsFocused
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.FlowDirection
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.Visibility
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.Semantics
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.Width
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.Height
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.MinimumWidth
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.MinimumHeight
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.MaximumWidth
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IView.MaximumHeight
Microsoft.Maui.Controls.VisualElement.Microsoft.Maui.IElement.Handler
Microsoft.Maui.Controls.VisualElement.IsLoaded
Microsoft.Maui.Controls.VisualElement.ChildrenReordered
Microsoft.Maui.Controls.VisualElement.Focused
Microsoft.Maui.Controls.VisualElement.MeasureInvalidated
Microsoft.Maui.Controls.VisualElement.SizeChanged
Microsoft.Maui.Controls.VisualElement.Unfocused
Microsoft.Maui.Controls.VisualElement.Loaded
Microsoft.Maui.Controls.VisualElement.Unloaded
Microsoft.Maui.Controls.NavigableElement.Navigation
Microsoft.Maui.Controls.NavigableElement.Style
Microsoft.Maui.Controls.NavigableElement.StyleClass
Microsoft.Maui.Controls.NavigableElement.class
Microsoft.Maui.Controls.Element.AutomationIdProperty
Microsoft.Maui.Controls.Element.ClassIdProperty
Microsoft.Maui.Controls.Element.ControlsElementMapper
Microsoft.Maui.Controls.Element.InsertLogicalChild(System.Int32, Microsoft.Maui.Controls.Element)
Microsoft.Maui.Controls.Element.AddLogicalChild(Microsoft.Maui.Controls.Element)
Microsoft.Maui.Controls.Element.RemoveLogicalChild(Microsoft.Maui.Controls.Element)
Microsoft.Maui.Controls.Element.ClearLogicalChildren()
Microsoft.Maui.Controls.Element.Microsoft.Maui.Controls.IElementController.SetValueFromRenderer(Microsoft.Maui.Controls.BindableProperty, System.Object)
Microsoft.Maui.Controls.Element.FindByName(System.String)
Microsoft.Maui.Controls.Element.RemoveDynamicResource(Microsoft.Maui.Controls.BindableProperty)
Microsoft.Maui.Controls.Element.SetDynamicResource(Microsoft.Maui.Controls.BindableProperty, System.String)
Microsoft.Maui.Controls.Element.Microsoft.Maui.IVisualTreeElement.GetVisualChildren()
Microsoft.Maui.Controls.Element.Microsoft.Maui.IVisualTreeElement.GetVisualParent()
Microsoft.Maui.Controls.Element.OnPropertyChanged(System.String)
Microsoft.Maui.Controls.Element.Microsoft.Maui.Controls.IElementController.Descendants()
Microsoft.Maui.Controls.Element.OnParentChanging(Microsoft.Maui.Controls.ParentChangingEventArgs)
Microsoft.Maui.Controls.Element.OnParentChanged()
Microsoft.Maui.Controls.Element.OnHandlerChanging(Microsoft.Maui.Controls.HandlerChangingEventArgs)
Microsoft.Maui.Controls.Element.Microsoft.Maui.Controls.IEffectControlProvider.RegisterEffect(Microsoft.Maui.Controls.Effect)
Microsoft.Maui.Controls.Element.MapAutomationPropertiesIsInAccessibleTree(Microsoft.Maui.IElementHandler, Microsoft.Maui.Controls.Element)
Microsoft.Maui.Controls.Element.MapAutomationPropertiesLabeledBy(Microsoft.Maui.IElementHandler, Microsoft.Maui.Controls.Element)
Microsoft.Maui.Controls.Element.MapAutomationPropertiesHelpText(Microsoft.Maui.IElementHandler, Microsoft.Maui.Controls.Element)
Microsoft.Maui.Controls.Element.MapAutomationPropertiesName(Microsoft.Maui.IElementHandler, Microsoft.Maui.Controls.Element)
Microsoft.Maui.Controls.Element.MapAutomationPropertiesExcludedWithChildren(Microsoft.Maui.IElementHandler, Microsoft.Maui.Controls.Element)
Microsoft.Maui.Controls.Element.AutomationId
Microsoft.Maui.Controls.Element.ClassId
Microsoft.Maui.Controls.Element.Effects
Microsoft.Maui.Controls.Element.Id
Microsoft.Maui.Controls.Element.StyleId
Microsoft.Maui.Controls.Element.Microsoft.Maui.Controls.IElementController.LogicalChildren
Microsoft.Maui.Controls.Element.Parent
Microsoft.Maui.Controls.Element.Microsoft.Maui.IElement.Parent
Microsoft.Maui.Controls.Element.Microsoft.Maui.IToolTipElement.ToolTip
Microsoft.Maui.Controls.Element.Microsoft.Maui.IContextFlyoutElement.ContextFlyout
Microsoft.Maui.Controls.Element.ChildAdded
Microsoft.Maui.Controls.Element.ChildRemoved
Microsoft.Maui.Controls.Element.DescendantAdded
Microsoft.Maui.Controls.Element.DescendantRemoved
Microsoft.Maui.Controls.Element.ParentChanging
Microsoft.Maui.Controls.Element.ParentChanged
Microsoft.Maui.Controls.Element.HandlerChanging
Microsoft.Maui.Controls.Element.HandlerChanged
Microsoft.Maui.Controls.BindableObject.BindingContextProperty
Microsoft.Maui.Controls.BindableObject.ClearValue(Microsoft.Maui.Controls.BindableProperty)
Microsoft.Maui.Controls.BindableObject.ClearValue(Microsoft.Maui.Controls.BindablePropertyKey)
Microsoft.Maui.Controls.BindableObject.GetValue(Microsoft.Maui.Controls.BindableProperty)
Microsoft.Maui.Controls.BindableObject.IsSet(Microsoft.Maui.Controls.BindableProperty)
Microsoft.Maui.Controls.BindableObject.RemoveBinding(Microsoft.Maui.Controls.BindableProperty)
Microsoft.Maui.Controls.BindableObject.SetBinding(Microsoft.Maui.Controls.BindableProperty, Microsoft.Maui.Controls.BindingBase)
Microsoft.Maui.Controls.BindableObject.ApplyBindings()
Microsoft.Maui.Controls.BindableObject.OnPropertyChanging(System.String)
Microsoft.Maui.Controls.BindableObject.UnapplyBindings()
Microsoft.Maui.Controls.BindableObject.SetValue(Microsoft.Maui.Controls.BindableProperty, System.Object)
Microsoft.Maui.Controls.BindableObject.SetValue(Microsoft.Maui.Controls.BindablePropertyKey, System.Object)
Microsoft.Maui.Controls.BindableObject.CoerceValue(Microsoft.Maui.Controls.BindableProperty)
Microsoft.Maui.Controls.BindableObject.CoerceValue(Microsoft.Maui.Controls.BindablePropertyKey)
Microsoft.Maui.Controls.BindableObject.Dispatcher
Microsoft.Maui.Controls.BindableObject.BindingContext
Microsoft.Maui.Controls.BindableObject.PropertyChanged
Microsoft.Maui.Controls.BindableObject.PropertyChanging
Microsoft.Maui.Controls.BindableObject.BindingContextChanged
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.ToString()
Namespace: Esri.ArcGISRuntime.Maui
Assembly: Esri.ArcGISRuntime.Maui.dll
Syntax
[ContentProperty("Map")]
public class MapView : GeoView, INotifyPropertyChanged, IDynamicResourceHandler, INameScope, IVisualTreeElement, IEffectControlProvider, IToolTipElement, IContextFlyoutElement, INavigationProxy, IAnimatable, IViewController, IVisualElementController, IElementController, IGestureController, IGestureRecognizers, IPropertyMapperView, IHotReloadableView, IReplaceableView, IMapView, IGeoView, IView, IElement, ITransform
Remarks

The MapView is a container that holds a Map. A Map holds a collection of operational layers and Basemap. Layers are visual representations of geographic information and come in many forms. The types of layers that are displayed in a MapView are two dimensional in nature; meaning they are displayed in X/Y (a.k.a. Latitude/Longitude) coordinate space.

There is only one Map per MapView and it is set by the Map Property. Multiple Map objects can be created and swapped out dynamically as the application is running in the MapView.

To display a Map, add a MapView control to your app and assign the map to it. This loads the map, its basemap and collection of operational layers, and displays their content on screen.

User interactions such as pan, zoom, rotate, and identify or selection are supported in the MapView using touch, mouse, keyboard, or pen/pencil. If required, you can override keys, clicks, and gestures to provide a specific user experience.

The visible area of the MapView is represented by the Viewpoint.

You can programmatically set the visible area by specifying a viewpoint. For example, SetViewpointGeometryAsync(Geometry) sets the visible area to the extent of a provided geometry, and SetViewpointGeometryAsync(Geometry, Double) zooms to a given scale, centered at the given point. Any geometries passed to these methods are automatically projected to match the SpatialReference of the map view's Map, if required.

To determine the current visible area or the center point and scale of a MapView, call GetCurrentViewpoint(ViewpointType). Call IsNavigating to ensure that any user-initiated or programmatic navigation is complete before getting the current Viewpoint.

In an MVC architecture, this class represents the View tier. The Model tier is represented by the Map object which provides a collection of operational layers and a Basemap. A Layer provides a visual representation of geographic information and comes in many forms. The types of layers that are displayed in a MapView are two-dimensional in nature; meaning they are displayed in X/Y coordinate space.

Constructors

Name Description
MapView()

Initializes a new instance of the MapView class.

Fields

Name Description
BackgroundGridProperty

Identifies the BackgroundGrid bindable property.
GeometryEditorProperty

Identifies the GeometryEditor bindable property.
InteractionOptionsProperty

Identifies the InteractionOptions bindable property.
LocationDisplayProperty

Identifies the LocationDisplay bindable property.
MapProperty

Identifies the Map bindable property.
WrapAroundModeProperty

Identifies the WrapAroundMode bindable property.

Properties

Name Description
BackgroundGrid

Gets or sets the background grid rendered behind the map data.
GeometryEditor

Gets or sets a GeometryEditor that allows users to interactively create and edit geometries by interacting with the view.
InteractionOptions

Gets or sets a set of properties that control user interaction with the MapView.
LocationDisplay

Gets or sets the LocationDisplay.
Map

Gets or sets the map the view is rendering.
MapRotation

Gets the current rotational heading of the map
MapScale

Gets the current scale of the map
UnitsPerPixel

Gets the current size of each device independent pixel in map units.
VisibleArea

Gets the view's visible area.
WrapAroundMode

Gets or sets whether continuous panning across the international date line is enabled.

Methods

Name Description
LocationToScreen(MapPoint)

Converts a location in map coordinates to a screen coordinate relative to the upper-left corner of the map.
ScreenToLocation(Point)

Converts screen coordinates relative to the upper-left corner of the map view to a location in map coordinates.
SetViewpointAsync(Viewpoint, TimeSpan, AnimationCurve)

Animates the display to the new viewpoint using the provided animation curve. The AnimationCurve defines the animation easing function.
SetViewpointCenterAsync(MapPoint)

Centers the map view at the provided center point.
SetViewpointCenterAsync(MapPoint, Double)

Centers the map view at the provided center point and zooms to the given scale.
SetViewpointCenterAsync(Double, Double)

Centers the view on the provided point.
SetViewpointCenterAsync(Double, Double, Double)

Centers the view on the provided point and zooms to the provided scale.
SetViewpointGeometryAsync(Geometry)

Zooms and pans the map view to the extent of the provided geometry.
SetViewpointGeometryAsync(Geometry, Double)

Zooms and pans the map view to the extent of the provided geometry with additional padding.
SetViewpointRotationAsync(Double)

Sets the rotatation of the map view to the provided angle.
SetViewpointScaleAsync(Double)

Zooms the map view to the provided scale around its current center point.

Applies to

TargetVersions
.NET200.0 - 200.6
.NET Windows200.0 - 200.6
.NET Android200.0 - 200.6
.NET iOS200.0 - 200.6