Class MapView

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

Inheritance
object
NSObject
UIResponder
UIView
GeoView
MapView
Implements
IEquatable<NSObject>
INSObjectProtocol
IUIActivityItemsConfigurationProviding
IUIPasteConfigurationSupporting
IUIResponderStandardEditActions
IUIUserActivityRestoring
INSCoding
IUIAccessibilityIdentification
IUIAppearance
IUIAppearanceContainer
IUICoordinateSpace
IUIDynamicItem
IUIFocusItem
IUIFocusEnvironment
IUIFocusItemContainer
IUILargeContentViewerItem
IUIPopoverPresentationControllerSourceItem
IUITraitChangeObservable
IUITraitEnvironment
ICALayerDelegate
INativeObject
UIView.Add(UIView)
UIView.AddSubviews(params UIView[])
UIView.GetEnumerator()
UIView.AccessibilityActivate()
UIView.AddConstraint(NSLayoutConstraint)
UIView.AddConstraints(NSLayoutConstraint[])
UIView.AddGestureRecognizer(UIGestureRecognizer)
UIView.AddInteraction(IUIInteraction)
UIView.AddLayoutGuide(UILayoutGuide)
UIView.AddMotionEffect(UIMotionEffect)
UIView.AddSubview(UIView)
UIView.AlignmentRectForFrame(CGRect)
UIView.BringSubviewToFront(UIView)
UIView.CommitAnimations()
UIView.ContentCompressionResistancePriority(UILayoutConstraintAxis)
UIView.ContentHuggingPriority(UILayoutConstraintAxis)
UIView.ConvertPointFromCoordinateSpace(CGPoint, IUICoordinateSpace)
UIView.ConvertPointFromView(CGPoint, UIView)
UIView.ConvertPointToCoordinateSpace(CGPoint, IUICoordinateSpace)
UIView.ConvertPointToView(CGPoint, UIView)
UIView.ConvertRectFromCoordinateSpace(CGRect, IUICoordinateSpace)
UIView.ConvertRectFromView(CGRect, UIView)
UIView.ConvertRectToCoordinateSpace(CGRect, IUICoordinateSpace)
UIView.ConvertRectToView(CGRect, UIView)
UIView.DecodeRestorableState(NSCoder)
UIView.DidHintFocusMovement(UIFocusMovementHint)
UIView.DidUpdateFocus(UIFocusUpdateContext, UIFocusAnimationCoordinator)
UIView.DisplayLayer(CALayer)
UIView.Draw(CGRect)
UIView.DrawLayer(CALayer, CGContext)
UIView.DrawRect(CGRect, UIViewPrintFormatter)
UIView.EncodeRestorableState(NSCoder)
UIView.EncodeTo(NSCoder)
UIView.ExerciseAmbiguityInLayout()
UIView.FrameForAlignmentRect(CGRect)
UIView.GestureRecognizerShouldBegin(UIGestureRecognizer)
UIView.GetConstraintsAffectingLayout(UILayoutConstraintAxis)
UIView.GetFocusItems(CGRect)
UIView.GetFrame(UIView)
UIView.GetUserInterfaceLayoutDirection(UISemanticContentAttribute)
UIView.GetUserInterfaceLayoutDirection(UISemanticContentAttribute, UIUserInterfaceLayoutDirection)
UIView.HitTest(CGPoint, UIEvent)
UIView.InsertSubviewAbove(UIView, UIView)
UIView.InsertSubviewBelow(UIView, UIView)
UIView.InvalidateIntrinsicContentSize()
UIView.IsDescendantOfView(UIView)
UIView.LayoutIfNeeded()
UIView.LayoutMarginsDidChange()
UIView.LayoutSublayersOfLayer(CALayer)
UIView.MovedToSuperview()
UIView.MovedToWindow()
UIView.NeedsUpdateConstraints()
UIView.PointInside(CGPoint, UIEvent)
UIView.RegisterForTraitChanges(Class[], NSObject, Selector)
UIView.RegisterForTraitChanges(Class[], Selector)
UIView.RemoveConstraint(NSLayoutConstraint)
UIView.RemoveConstraints(NSLayoutConstraint[])
UIView.RemoveFromSuperview()
UIView.RemoveGestureRecognizer(UIGestureRecognizer)
UIView.RemoveInteraction(IUIInteraction)
UIView.RemoveLayoutGuide(UILayoutGuide)
UIView.RemoveMotionEffect(UIMotionEffect)
UIView.RequiresConstraintBasedLayout()
UIView.SendSubviewToBack(UIView)
UIView.SetAnimationCurve(UIViewAnimationCurve)
UIView.SetAnimationDelegate(NSObject)
UIView.SetAnimationDidStopSelector(Selector)
UIView.SetAnimationStartDate(NSDate)
UIView.SetAnimationWillStartSelector(Selector)
UIView.SetNeedsDisplay()
UIView.SetNeedsDisplayInRect(CGRect)
UIView.SetNeedsFocusUpdate()
UIView.SetNeedsLayout()
UIView.SetNeedsUpdateConstraints()
UIView.ShouldUpdateFocus(UIFocusUpdateContext)
UIView.SizeThatFits(CGSize)
UIView.SizeToFit()
UIView.SubviewAdded(UIView)
UIView.SystemLayoutSizeFittingSize(CGSize)
UIView.TintColorDidChange()
UIView.TraitCollectionDidChange(UITraitCollection)
UIView.UnregisterForTraitChanges(IUITraitChangeRegistration)
UIView.UpdateConstraints()
UIView.UpdateConstraintsIfNeeded()
UIView.UpdateFocusIfNeeded()
UIView.UpdateTraitsIfNeeded()
UIView.WillDrawLayer(CALayer)
UIView.WillMoveToSuperview(UIView)
UIView.WillRemoveSubview(UIView)
UIView.GetAppearance<T>()
UIView.GetAppearance(UITraitCollection)
UIView.GetAppearance<T>(UITraitCollection)
UIView.ClassHandle
UIView.AccessibilityActivationPoint
UIView.AccessibilityAttributedHint
UIView.AccessibilityAttributedLabel
UIView.AccessibilityAttributedUserInputLabels
UIView.AccessibilityAttributedValue
UIView.AccessibilityDirectTouchOptions
UIView.AccessibilityElementsHidden
UIView.AccessibilityExpandedStatus
UIView.AccessibilityFrame
UIView.AccessibilityIdentifier
UIView.AccessibilityIgnoresInvertColors
UIView.AccessibilityLanguage
UIView.AccessibilityNavigationStyle
UIView.AccessibilityPath
UIView.AccessibilityRespondsToUserInteraction
UIView.AccessibilityTextualContext
UIView.AccessibilityTraits
UIView.AccessibilityUserInputLabels
UIView.AccessibilityValue
UIView.AccessibilityViewIsModal
UIView.AlignmentRectInsets
UIView.Alpha
UIView.AnchorPoint
UIView.AnimationsEnabled
UIView.AppliedContentSizeCategoryLimitsDescription
UIView.AutoresizingMask
UIView.AutosizesSubviews
UIView.BackgroundColor
UIView.BottomAnchor
UIView.Bounds
UIView.Center
UIView.CenterXAnchor
UIView.CenterYAnchor
UIView.ClearsContextBeforeDrawing
UIView.ClipsToBounds
UIView.CollisionBoundingPath
UIView.CollisionBoundsType
UIView.Constraints
UIView.ContentMode
UIView.ContentScaleFactor
UIView.ContentStretch
UIView.CoordinateSpace
UIView.DirectionalLayoutMargins
UIView.EffectiveUserInterfaceLayoutDirection
UIView.ExclusiveTouch
UIView.FirstBaselineAnchor
UIView.FocusEffect
UIView.FocusGroupIdentifier
UIView.FocusGroupPriority
UIView.FocusItemContainer
UIView.FocusItemDeferralMode
UIView.Focused
UIView.Frame
UIView.GestureRecognizers
UIView.HasAmbiguousLayout
UIView.HeightAnchor
UIView.Hidden
UIView.HoverStyle
UIView.InheritedAnimationDuration
UIView.InsetsLayoutMarginsFromSafeArea
UIView.Interactions
UIView.IntrinsicContentSize
UIView.IsTransparentFocusItem
UIView.KeyboardLayoutGuide
UIView.LargeContentImage
UIView.LargeContentImageInsets
UIView.LargeContentTitle
UIView.LastBaselineAnchor
UIView.Layer
UIView.LayoutGuides
UIView.LayoutMargins
UIView.LayoutMarginsGuide
UIView.LeadingAnchor
UIView.LeftAnchor
UIView.MaskView
UIView.MaximumContentSizeCategory
UIView.MinimumContentSizeCategory
UIView.MotionEffects
UIView.MultipleTouchEnabled
UIView.Opaque
UIView.OverrideUserInterfaceStyle
UIView.ParentFocusEnvironment
UIView.PreferredFocusEnvironments
UIView.PreferredFocusedView
UIView.PreservesSuperviewLayoutMargins
UIView.ReadableContentGuide
UIView.RestorationIdentifier
UIView.RightAnchor
UIView.SafeAreaInsets
UIView.SafeAreaLayoutGuide
UIView.ScalesLargeContentImage
UIView.SemanticContentAttribute
UIView.ShouldGroupAccessibilityChildren
UIView.ShowsLargeContentViewer
UIView.Subviews
UIView.Superview
UIView.Tag
UIView.TintAdjustmentMode
UIView.TintColor
UIView.TopAnchor
UIView.TrailingAnchor
UIView.TraitCollection
UIView.TraitOverrides
UIView.Transform
UIView.Transform3D
UIView.TranslatesAutoresizingMaskIntoConstraints
UIView.UserInteractionEnabled
UIView.ViewForBaselineLayout
UIView.ViewForFirstBaselineLayout
UIView.ViewForLastBaselineLayout
UIView.ViewPrintFormatter
UIView.WidthAnchor
UIView.Window
UIView.AnnouncementDidFinishNotification
UIView.AnnouncementNotification
UIView.AssistiveTechnologyKey
UIView.AssistiveTouchStatusDidChangeNotification
UIView.BoldTextStatusDidChangeNotification
UIView.ButtonShapesEnabledStatusDidChangeNotification
UIView.ClosedCaptioningStatusDidChangeNotification
UIView.DarkerSystemColorsStatusDidChangeNotification
UIView.ElementFocusedNotification
UIView.FocusedElementKey
UIView.GrayscaleStatusDidChangeNotification
UIView.GuidedAccessStatusDidChangeNotification
UIView.HearingDevicePairedEarDidChangeNotification
UIView.InvertColorsStatusDidChangeNotification
UIView.LayoutChangedNotification
UIView.MonoAudioStatusDidChangeNotification
UIView.NoIntrinsicMetric
UIView.NotificationSwitchControlIdentifier
UIView.NotificationVoiceOverIdentifier
UIView.OnOffSwitchLabelsDidChangeNotification
UIView.PageScrolledNotification
UIView.PauseAssistiveTechnologyNotification
UIView.PrefersCrossFadeTransitionsStatusDidChangeNotification
UIView.ReduceMotionStatusDidChangeNotification
UIView.ReduceTransparencyStatusDidChangeNotification
UIView.ResumeAssistiveTechnologyNotification
UIView.ScreenChangedNotification
UIView.ShakeToUndoDidChangeNotification
UIView.ShouldDifferentiateWithoutColorDidChangeNotification
UIView.SpeakScreenStatusDidChangeNotification
UIView.SpeakSelectionStatusDidChangeNotification
UIView.SpeechAttributeAnnouncementPriority
UIView.SpeechAttributeIpaNotation
UIView.SpeechAttributeLanguage
UIView.SpeechAttributePitch
UIView.SpeechAttributePunctuation
UIView.SpeechAttributeQueueAnnouncement
UIView.SpeechAttributeSpellOut
UIView.SwitchControlStatusDidChangeNotification
UIView.TextAttributeContext
UIView.TextAttributeCustom
UIView.TextAttributeHeadingLevel
UIView.UILayoutFittingCompressedSize
UIView.UILayoutFittingExpandedSize
UIView.UnfocusedElementKey
UIView.VideoAutoplayStatusDidChangeNotification
UIView.VoiceOverStatusChanged
UIView.VoiceOverStatusDidChangeNotification
UIView.Appearance
UIView.AnimationWillStart
UIView.AnimationWillEnd
UIResponder.AccessibilityDecrement()
UIResponder.AccessibilityElementDidBecomeFocused()
UIResponder.AccessibilityElementDidLoseFocus()
UIResponder.AccessibilityElementIsFocused()
UIResponder.AccessibilityIncrement()
UIResponder.AccessibilityPerformEscape()
UIResponder.AccessibilityPerformMagicTap()
UIResponder.AccessibilityScroll(UIAccessibilityScrollDirection)
UIResponder.BecomeFirstResponder()
UIResponder.BuildMenu(IUIMenuBuilder)
UIResponder.CanPaste(NSItemProvider[])
UIResponder.CanPerform(Selector, NSObject)
UIResponder.CaptureTextFromCamera(NSObject)
UIResponder.ClearTextInputContextIdentifier(NSString)
UIResponder.Copy(NSObject)
UIResponder.Cut(NSObject)
UIResponder.DecreaseSize(NSObject)
UIResponder.Delete(NSObject)
UIResponder.Duplicate(NSObject)
UIResponder.Export(NSObject)
UIResponder.Find(NSObject)
UIResponder.FindAndReplace(NSObject)
UIResponder.FindNext(NSObject)
UIResponder.FindPrevious(NSObject)
UIResponder.GetTargetForAction(Selector, NSObject)
UIResponder.IncreaseSize(NSObject)
UIResponder.MakeTextWritingDirectionLeftToRight(NSObject)
UIResponder.MakeTextWritingDirectionRightToLeft(NSObject)
UIResponder.MotionBegan(UIEventSubtype, UIEvent)
UIResponder.MotionCancelled(UIEventSubtype, UIEvent)
UIResponder.MotionEnded(UIEventSubtype, UIEvent)
UIResponder.Move(NSObject)
UIResponder.Paste(NSObject)
UIResponder.Paste(NSItemProvider[])
UIResponder.PasteAndGo(NSObject)
UIResponder.PasteAndMatchStyle(NSObject)
UIResponder.PasteAndSearch(NSObject)
UIResponder.PressesChanged(NSSet<UIPress>, UIPressesEvent)
UIResponder.Print(NSObject)
UIResponder.ReloadInputViews()
UIResponder.RemoteControlReceived(UIEvent)
UIResponder.Rename(NSObject)
UIResponder.ResignFirstResponder()
UIResponder.RestoreUserActivityState(NSUserActivity)
UIResponder.Select(NSObject)
UIResponder.SelectAll(NSObject)
UIResponder.ToggleBoldface(NSObject)
UIResponder.ToggleItalics(NSObject)
UIResponder.ToggleUnderline(NSObject)
UIResponder.TouchesCancelled(NSSet, UIEvent)
UIResponder.TouchesEnded(NSSet, UIEvent)
UIResponder.TouchesEstimatedPropertiesUpdated(NSSet)
UIResponder.TouchesMoved(NSSet, UIEvent)
UIResponder.UpdateTextAttributes(UITextAttributesConversionHandler)
UIResponder.UpdateUserActivityState(NSUserActivity)
UIResponder.UseSelectionForFind(NSObject)
UIResponder.ValidateCommand(UICommand)
UIResponder.AccessibilityAssistiveTechnologyFocusedIdentifiers
UIResponder.AccessibilityCustomActions
UIResponder.AccessibilityDragSourceDescriptors
UIResponder.AccessibilityDropPointDescriptors
UIResponder.ActivityItemsConfiguration
UIResponder.CanResignFirstResponder
UIResponder.EditingInteractionConfiguration
UIResponder.InputAccessoryView
UIResponder.InputAccessoryViewController
UIResponder.InputAssistantItem
UIResponder.InputView
UIResponder.InputViewController
UIResponder.IsFirstResponder
UIResponder.KeyCommands
UIResponder.NextResponder
UIResponder.PasteConfiguration
UIResponder.TextInputContextIdentifier
UIResponder.TextInputMode
UIResponder.UndoManager
UIResponder.UserActivity
NSObject.PlatformAssembly
NSObject.Dispose()
NSObject.ConformsToProtocol(NativeHandle)
NSObject.DangerousRelease()
NSObject.DangerousRetain()
NSObject.DangerousAutorelease()
NSObject.BeginInvokeOnMainThread(Selector, NSObject)
NSObject.InvokeOnMainThread(Selector, NSObject)
NSObject.SetValueForKeyPath(NativeHandle, NSString)
NSObject.GetHashCode()
NSObject.Equals(NSObject)
NSObject.ToString()
NSObject.CancelPreviousPerformRequest(NSObject)
NSObject.CancelPreviousPerformRequest(NSObject, Selector, NSObject)
NSObject.Copy()
NSObject.DidChange(NSKeyValueChange, NSIndexSet, NSString)
NSObject.DidChange(NSString, NSKeyValueSetMutationKind, NSSet)
NSObject.DoesNotRecognizeSelector(Selector)
NSObject.GetDictionaryOfValuesFromKeys(NSString[])
NSObject.GetKeyPathsForValuesAffecting(NSString)
NSObject.GetMethodForSelector(Selector)
NSObject.MutableCopy()
NSObject.PerformSelector(Selector)
NSObject.PerformSelector(Selector, NSObject)
NSObject.PerformSelector(Selector, NSObject, NSObject)
NSObject.PrepareForInterfaceBuilder()
NSObject.RemoveObserver(NSObject, NSString)
NSObject.SetNilValueForKey(NSString)
NSObject.SetValueForKey(NSObject, NSString)
NSObject.SetValueForKeyPath(NSObject, NSString)
NSObject.SetValueForUndefinedKey(NSObject, NSString)
NSObject.SetValuesForKeysWithDictionary(NSDictionary)
NSObject.ValueForKey(NSString)
NSObject.ValueForKeyPath(NSString)
NSObject.ValueForUndefinedKey(NSString)
NSObject.WillChange(NSKeyValueChange, NSIndexSet, NSString)
NSObject.WillChange(NSString, NSKeyValueSetMutationKind, NSSet)
NSObject.DebugDescription
NSObject.Description
NSObject.RetainCount
NSObject.ChangeIndexesKey
NSObject.ChangeKindKey
NSObject.ChangeNewKey
NSObject.ChangeNotificationIsPriorKey
NSObject.ChangeOldKey
Namespace: Esri.ArcGISRuntime.UI.Controls
Assembly: Esri.ArcGISRuntime.iOS.dll
Syntax
[Register("MapView")]
public class MapView : GeoView, IEquatable<NSObject>, INSObjectProtocol, IUIActivityItemsConfigurationProviding, IUIPasteConfigurationSupporting, IUIResponderStandardEditActions, IUIUserActivityRestoring, IEnumerable, INSCoding, IUIAccessibilityIdentification, IUIAppearance, IUIAppearanceContainer, IUICoordinateSpace, IUIDynamicItem, IUIFocusItem, IUIFocusEnvironment, IUIFocusItemContainer, IUILargeContentViewerItem, IUIPopoverPresentationControllerSourceItem, IUITraitChangeObservable, IUITraitEnvironment, ICALayerDelegate, INativeObject, INotifyPropertyChanged, IComponent, IDisposable
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.

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.
MapView(nint)

Internal use only. Invoked by the Xamarin iOS designer.

Properties

Name Description
BackgroundGrid

Gets or sets the background grid that a Map is displayed on top of.
GeometryEditor

Gets or sets the editor 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 the location display that manages and renders the device's current location on a MapView using a data source, such as a GPS sensor.
Map

Gets or sets the map that the MapView is displaying.
MapRotation

Gets the rotation angle of the Map in degrees from its north-south direction.
MapScale

Gets the scale of the MapView.
UnitsPerPixel

Gets the size of each device-independent pixel (DIP) 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
AwakeFromNib()

Invoked when the MapView is instantiated from a storyboard. Not intended for use by end-users.
CancelSetViewpointOperations()

Cancels any pending or currently running SetViewpointAsync operations.
IdentifyGeometryEditorAsync(CGPoint, 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(CGPoint)

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 rotation 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
.NET iOS200.0 - 300.0
Xamarin.iOS100.0 - 100.15