Class MapView
A user interface control that displays two-dimensional (2D) geographic content defined by a Map.
Inheritance
Implements
Namespace: Esri.ArcGISRuntime.Maui
Assembly: Esri.ArcGISRuntime.Maui.dll
Syntax
[ContentProperty("Map")]
[WinRTRuntimeClassName("Microsoft.UI.Xaml.Data.INotifyPropertyChanged")]
[WinRTExposedType(typeof(MapViewWinRTTypeDetails))]
public class MapView : GeoView, INotifyPropertyChanged, IVisualTreeElement, IEffectControlProvider, IToolTipElement, IContextFlyoutElement, IAnimatable, IViewController, IVisualElementController, IElementController, IGestureController, IGestureRecognizers, IPropertyMapperView, IHotReloadableView, IReplaceableView, IMapView, IGeoView, IView, IElement, ITransformRemarks
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.
To display a Map, add a MapView control to your app and assign the map to it. This loads the map and its content, such as a Basemap and collection of operational layers, and displays this 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 (Viewpoint) of the MapView is defined by the visible extent the map. To determine the current visible area or the center point and scale of a MapView, call GetCurrentViewpoint(ViewpointType). Make sure that any user-initiated or programmatic navigation is complete before getting the current Viewpoint by calling IsNavigating.
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 SetViewpointCenterAsync(MapPoint) centers the map view at a given point. Any geometries passed to these methods are automatically projected to match the SpatialReference of the map view's Map, if required.
In an MVC architecture, the MapView represents the View tier. The Model tier is represented by the Map object which can provide a collection of operational layers and a Basemap. You can only set one Map per MapView, but you can swap the Map with another when the application is running. See the Map view discussion in the developer guide for more information.
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 |
|---|---|
| IdentifyGeometryEditorAsync(Point, double) | Identifies all the elements in the GeometryEditor, at the given screen point. |
| 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
| Target | Versions |
|---|---|
| .NET | 200.0 - 300.0 |
| .NET Windows | 200.0 - 300.0 |
| .NET Android | 200.0 - 300.0 |
| .NET iOS | 200.0 - 300.0 |