ArcGIS Runtime SDK for iOS: AGSMapView Class Reference
ArcGIS Runtime SDK for iOS  100.11
AGSMapView Class Reference

Description

A view component to display 2D geographic content such as maps.

Instances of this class represent views that can display 2D geographic content such as maps on screen. In an MVC architecture, this class represents the view tier and is a type of UIView on iOS or NSView on Mac. The Model tier is represented by the AGSMap object which contains the geographic content.

To display a map, add an AGSMapView object to your view controller's view heirarchy. You can do this either using Interface Builder and Storyboards, or programmatically in code. Next, assign an AGSMap object to the mapview. The mapview will automatically load the map, its basemap, and operational layers, and display their contents on screen.

To navigate the map, you can use touch gestures such as double-tap, drag, two-finger tap, etc on iOS, and the mouse/trackpad, and keyboard shortcuts on Mac OS. You can also programmatically change the viewpoint(setViewpoint: (AGSGeoView)) with or without animation.

The mapview informs it's touch delegate whenever touch/mouse/trackpad/keyboard events are associated with it. You can set your class as the touch delegate to be notified of these events.

See also
AGSSceneView to display 3D geographic content such as scenes.
Since
100
Inheritance diagram for AGSMapView:
AGSMapViewCommon AGSGeoView

Instance Methods

(nullable AGSViewpoint *) - currentViewpointWithType:
 
(id< AGSCancelable >) - exportImageWithCompletion:
 
(id< AGSCancelable >) - identifyGraphicsOverlay:screenPoint:tolerance:returnPopupsOnly:completion:
 
(id< AGSCancelable >) - identifyGraphicsOverlay:screenPoint:tolerance:returnPopupsOnly:maximumResults:completion:
 
(id< AGSCancelable >) - identifyGraphicsOverlaysAtScreenPoint:tolerance:returnPopupsOnly:completion:
 
(id< AGSCancelable >) - identifyGraphicsOverlaysAtScreenPoint:tolerance:returnPopupsOnly:maximumResultsPerOverlay:completion:
 
(id< AGSCancelable >) - identifyLayer:screenPoint:tolerance:returnPopupsOnly:completion:
 
(id< AGSCancelable >) - identifyLayer:screenPoint:tolerance:returnPopupsOnly:maximumResults:completion:
 
(id< AGSCancelable >) - identifyLayersAtScreenPoint:tolerance:returnPopupsOnly:completion:
 
(id< AGSCancelable >) - identifyLayersAtScreenPoint:tolerance:returnPopupsOnly:maximumResultsPerLayer:completion:
 
(nullable AGSLayerViewState *) - layerViewStateForLayer:
 
(CGPoint) - locationToScreen:
 
(AGSPoint *) - screenToLocation:
 
(id< AGSCancelable >) - setBookmark:completion:
 
(void) - setViewpoint:
 
(id< AGSCancelable >) - setViewpoint:completion:
 
(id< AGSCancelable >) - setViewpoint:duration:completion:
 
(id< AGSCancelable >) - setViewpoint:duration:curve:completion:
 
(id< AGSCancelable >) - setViewpointCenter:completion:
 
(id< AGSCancelable >) - setViewpointCenter:scale:completion:
 
(id< AGSCancelable >) - setViewpointGeometry:completion:
 
(id< AGSCancelable >) - setViewpointGeometry:padding:completion:
 
(id< AGSCancelable >) - setViewpointRotation:completion:
 
(id< AGSCancelable >) - setViewpointScale:completion:
 

Properties

UIEdgeInsets adjustedContentInset
 
NSString * attributionText
 
BOOL attributionTextVisible
 
NSLayoutYAxisAnchor * attributionTopAnchor
 
AGSBackgroundGridbackgroundGrid
 
AGSCalloutcallout
 
UIEdgeInsets contentInset
 
AGSDrawStatus drawStatus
 
NSMutableArray< AGSGraphicsOverlay * > * graphicsOverlays
 
AGSGridgrid
 
BOOL insetsContentInsetFromSafeArea
 
AGSMapViewInteractionOptionsinteractionOptions
 
AGSViewLabelPropertieslabeling
 
void(^ layerViewStateChangedHandler )(AGSLayer *layer, AGSLayerViewState *layerViewState)
 
AGSLocationDisplaylocationDisplay
 
AGSMapmap
 
double mapScale
 
BOOL navigating
 
BOOL releaseHardwareResourcesWhenBackgrounded
 
double rotation
 
AGSSelectionPropertiesselectionProperties
 
AGSSketchEditorsketchEditor
 
AGSSpatialReferencespatialReference
 
AGSTimeExtenttimeExtent
 
IBOutlet id< AGSGeoViewTouchDelegatetouchDelegate
 
double unitsPerPoint
 
void(^ viewpointChangedHandler )(void)
 
AGSPolygonvisibleArea
 
BOOL wrapAroundEnabled
 
AGSWrapAroundMode wrapAroundMode
 

Method Documentation

◆ currentViewpointWithType:

- (nullable AGSViewpoint*) currentViewpointWithType: (AGSViewpointType viewpointType

Gets the current viewpoint being displayed. For an AGSMapView, this takes into account the attribution bar and any contentInset that has been specified to return only the unobscured portion of the map.

Parameters
viewpointTypespecifying how the viewpoint should be represented.
Returns
The viewpoint.
Since
100

◆ exportImageWithCompletion:

- (id<AGSCancelable>) exportImageWithCompletion: (void(^)(AGSImage *__nullable image, NSError *__nullable error))  completion

Provides an image depicting the view's current display.

Parameters
completionblock that is invoked when the operation completes.
Returns
An operation which can be canceled.
Since
100

◆ identifyGraphicsOverlay:screenPoint:tolerance:returnPopupsOnly:completion:

- (id<AGSCancelable>) identifyGraphicsOverlay: (AGSGraphicsOverlay *)  graphicsOverlay
screenPoint: (CGPoint)  screenPoint
tolerance: (double)  tolerance
returnPopupsOnly: (BOOL)  returnPopupsOnly
completion: (void(^)(AGSIdentifyGraphicsOverlayResult *identifyResult))  completion 

Identify (hit-test) the top-most graphic that appears at the specified screen coordinates in the provided graphics overlay.

Parameters
graphicsOverlayin which to identify graphics.
screenPointat which to identify graphics.
toleranceradius in points specifying how precise the identify operation should be. A value of 0 means that it should be extremely precise - only those graphics appearing at the exact coordinates should be returned. A value of 22 (a good default for touch displays which covers an average finger tap) means graphics appearing within a 44pt buffer can also be returned. Max value permitted is 100.
returnPopupsOnlyspecifies what the identify results should contain. If set to YES, only overlays with popups will be retured. If set to NO, all overlays (with or without popups) will be retured.
completionblock that is invoked when the operation is complete with the result.
Returns
An operation which can be canceled.
Since
100

◆ identifyGraphicsOverlay:screenPoint:tolerance:returnPopupsOnly:maximumResults:completion:

- (id<AGSCancelable>) identifyGraphicsOverlay: (AGSGraphicsOverlay *)  graphicsOverlay
screenPoint: (CGPoint)  screenPoint
tolerance: (double)  tolerance
returnPopupsOnly: (BOOL)  returnPopupsOnly
maximumResults: (NSInteger)  maximumResults
completion: (void(^)(AGSIdentifyGraphicsOverlayResult *identifyResult))  completion 

Identify (hit-test) which graphics appear at the specified screen coordinates in the provided graphics overlay.

Parameters
graphicsOverlayin which to identify graphics.
screenPointat which to identify graphics.
toleranceradius in points specifying how precise the identify operation should be. A value of 0 means that it should be extremely precise - only those graphics appearing at the exact coordinates should be returned. A value of 22 (a good default for touch displays which covers an average finger tap) means graphics appearing within a 44 pt buffer can also be returned. Max value permitted is 100.
returnPopupsOnlyspecifies what the identify results should contain. If set to YES, only overlays with popups will be retured. If set to NO, all overlays (with or without popups) will be retured.
maximumResultsthat should be returned as the result.
completionblock that is invoked when the operation is complete with the result.
Returns
An operation which can be canceled.
Since
100

◆ identifyGraphicsOverlaysAtScreenPoint:tolerance:returnPopupsOnly:completion:

- (id<AGSCancelable>) identifyGraphicsOverlaysAtScreenPoint: (CGPoint)  screenPoint
tolerance: (double)  tolerance
returnPopupsOnly: (BOOL)  returnPopupsOnly
completion: (void(^)(NSArray< AGSIdentifyGraphicsOverlayResult * > *__nullable identifyResults, NSError *__nullable error))  completion 

Identify (hit-test) the top-most graphic that appears at the specified screen coordinates in all the graphics overlays.

Parameters
screenPointat which to identify graphics.
toleranceradius in points specifying how precise the identify operation should be. A value of 0 means that it should be extremely precise - only those graphics at that exact coordinates should be returned. A value of 22 (a good default for touch displays which covers an average finger tap) means graphics within a 44pt buffer can also be returned. Max value permitted is 100.
returnPopupsOnlyspecifies what the identify results should contain. If set to YES, only overlays with popups will be retured. If set to NO, all overlays (with or without popups) will be retured.
completionblock that is invoked when the operation is complete with either the results or an error.
Returns
An operation which can be canceled.
Since
100

◆ identifyGraphicsOverlaysAtScreenPoint:tolerance:returnPopupsOnly:maximumResultsPerOverlay:completion:

- (id<AGSCancelable>) identifyGraphicsOverlaysAtScreenPoint: (CGPoint)  screenPoint
tolerance: (double)  tolerance
returnPopupsOnly: (BOOL)  returnPopupsOnly
maximumResultsPerOverlay: (NSInteger)  maximumResultsPerOverlay
completion: (void(^)(NSArray< AGSIdentifyGraphicsOverlayResult * > *__nullable identifyResults, NSError *__nullable error))  completion 

Identify (hit-test) which graphics appear at the specified screen coordinates in all the graphics overlays.

Parameters
screenPointat which to identify graphics.
toleranceradius in points specifying how precise the identify operation should be. A value of 0 means that it should be extremely precise - only those graphics at that exact coordinates should be returned. A value of 22 (a good default for touch displays which covers an average finger tap) means graphics within a 44pt buffer can also be returned. Max value permitted is 100.
returnPopupsOnlyspecifies what the identify results should contain. If set to YES, only overlays with popups will be retured. If set to NO, all overlays (with or without popups) will be retured.
maximumResultsPerOverlaythat should be returned for each overlay in the result.
completionblock that is invoked when the operation is complete with either the results or an error.
Returns
An operation which can be canceled.
Since
100

◆ identifyLayer:screenPoint:tolerance:returnPopupsOnly:completion:

- (id<AGSCancelable>) identifyLayer: (AGSLayer *)  layer
screenPoint: (CGPoint)  screenPoint
tolerance: (double)  tolerance
returnPopupsOnly: (BOOL)  returnPopupsOnly
completion: (void(^)(AGSIdentifyLayerResult *identifyResult))  completion 

Identify (hit-test and/or spatially query) the top-most feature that appears at the specified screen coordinates in the provided layer.

Parameters
layerin which to identify features.
screenPointat which to identify features.
toleranceradius in points specifying how precise the identify operation should be. A value of 0 means that it should be extremely precise - only those features appearing at the exact coordinates should be returned. A value of 22 (a good default for touch displays which covers an average finger tap) means features appearing within a 44pt buffer can also be returned. Max value permitted is 100.
returnPopupsOnlyspecifies what the identify results should contain. If set to YES, only layers with popups will be retured. If the layer does not have popups an error will be returned. If set to NO, all layers (with or without popups) will be retured.
completionblock that is invoked when the operation is complete with the result.
Returns
An operation which can be canceled.
Since
100

◆ identifyLayer:screenPoint:tolerance:returnPopupsOnly:maximumResults:completion:

- (id<AGSCancelable>) identifyLayer: (AGSLayer *)  layer
screenPoint: (CGPoint)  screenPoint
tolerance: (double)  tolerance
returnPopupsOnly: (BOOL)  returnPopupsOnly
maximumResults: (NSInteger)  maximumResults
completion: (void(^)(AGSIdentifyLayerResult *identifyResult))  completion 

Identify (hit-test and/or spatially query) all features that appear at the specified screen coordinates in the provided layer.

Parameters
layerin which to identify features.
screenPointat which to identify features.
toleranceradius in points specifying how precise the identify operation should be. A value of 0 means that it should be extremely precise - only those features appearing at the exact coordinates should be returned. A value of 22 (a good default for touch displays which covers an average finger tap) means features appearing within a 44pt buffer can also be returned. Max value permitted is 100.
returnPopupsOnlyspecifies what the identify results should contain. If set to YES, only layers with popups will be retured. If the layer does not have popups an error will be returned. If set to NO, all layers (with or without popups) will be retured.
maximumResultsto return.
completionblock that is invoked when the operation is complete with the result.
Returns
An operation which can be canceled.
Since
100

◆ identifyLayersAtScreenPoint:tolerance:returnPopupsOnly:completion:

- (id<AGSCancelable>) identifyLayersAtScreenPoint: (CGPoint)  screenPoint
tolerance: (double)  tolerance
returnPopupsOnly: (BOOL)  returnPopupsOnly
completion: (void(^)(NSArray< AGSIdentifyLayerResult * > *__nullable identifyResults, NSError *__nullable error))  completion 

Identify (hit-test and/or spatially query) the top-most feature that appears at the specified screen coordinates in each of the map's layers.

Parameters
screenPointat which to identify features.
toleranceradius in points specifying how precise the identify operation should be. A value of 0 means that it should be extremely precise - only those features appearing at the exact coordinates should be returned. A value of 22 (a good default for touch displays which covers an average finger tap) means features appearing within a 44pt buffer can also be returned. Max value permitted is 100.
returnPopupsOnlyspecifies what the identify results should contain. If set to YES, only layers with popups will be retured. If the layer does not have popups an error will be returned. If set to NO, all layers (with or without popups) will be retured.
completionblock that is invoked when the operation is complete with either the results or an error.
Returns
An operation which can be canceled.
Since
100

◆ identifyLayersAtScreenPoint:tolerance:returnPopupsOnly:maximumResultsPerLayer:completion:

- (id<AGSCancelable>) identifyLayersAtScreenPoint: (CGPoint)  screenPoint
tolerance: (double)  tolerance
returnPopupsOnly: (BOOL)  returnPopupsOnly
maximumResultsPerLayer: (NSInteger)  maximumResultsPerLayer
completion: (void(^)(NSArray< AGSIdentifyLayerResult * > *__nullable identifyResults, NSError *__nullable error))  completion 

Identify (hit-test and/or spatially query) which features appear at the specified screen coordinates in all the map's layers.

Parameters
screenPointat which to identify features.
toleranceradius in points specifying how precise the identify operation should be. A value of 0 means that it should be extremely precise - only those features appearing at the exact coordinates should be returned. A value of 22 (a good default for touch displays which covers an average finger tap) means features appearing within a 44pt buffer can also be returned. Max value permitted is 100.
returnPopupsOnlyspecifies what the identify results should contain. If set to YES, only layers with popups will be retured. If the layer does not have popups an error will be returned. If set to NO, all layers (with or without popups) will be retured.
maximumResultsPerLayerto return.
completionblock that is invoked when the operation is complete with either the results or an error.
Returns
An operation which can be canceled.
Since
100

◆ layerViewStateForLayer:

- (nullable AGSLayerViewState*) layerViewStateForLayer: (AGSLayer *)  layer

Get the current view state for a map or scene layer.

Parameters
layerto get the view state for.
Returns
The view state.
Since
100

◆ locationToScreen:

- (CGPoint) locationToScreen: (AGSPoint *)  mapLocation

Converts the specified location in map units to a point in screen units.

Parameters
mapLocationto convert.
Returns
A screen point.
Since
100

◆ screenToLocation:

- (AGSPoint*) screenToLocation: (CGPoint)  screen

Converts the specified screen point to a map location.

Parameters
screenpoint to convert.
Returns
A map location.
Since
100

◆ setBookmark:completion:

- (id<AGSCancelable>) setBookmark: (AGSBookmark *)  bookmark
completion: (nullable void(^)(BOOL finished))  completion 

Zoom or pan with animation to the viewpoint specified by the provided bookmark.

Parameters
bookmarkwhose viewpoint will be used to pan/zoom to.
completionblock which is invoked when operation completes. The finished argument indicates whether the animation continued until the end without any interruption.
Since
100.2

◆ setViewpoint:

- (void) setViewpoint: (AGSViewpoint *)  viewpoint

Zoom or pan without animation to the specified viewpoint.

Parameters
viewpointto zoom/pan to.
Since
100
See also
- setViewpoint:completion: to zoom/pan with animation.

◆ setViewpoint:completion:

- (id<AGSCancelable>) setViewpoint: (AGSViewpoint *)  viewpoint
completion: (nullable void(^)(BOOL finished))  completion 

Zoom or pan with animation to the specified viewpoint. Animates over 0.25 seconds. See setViewpoint:duration:completion: to set viewpoint that animates over a specific duration.

Parameters
viewpointto zoom/pan to.
completionblock which is invoked when operation completes. The finished argument indicates whether the animation continued until the end without any interruption.
Returns
An operation which can be canceled.
Since
100

◆ setViewpoint:duration:completion:

- (id<AGSCancelable>) setViewpoint: (AGSViewpoint *)  viewpoint
duration: (double)  duration
completion: (nullable void(^)(BOOL finished))  completion 

Zoom or pan with animation to the specified viewpoint. Animates over the specified duration.

Parameters
viewpointto zoom/pan to.
durationfor the zoom/pan animation in seconds.
completionblock which is invoked when operation completes. The finished argument indicates whether the animation continued until the end without any interruption.
Returns
An operation which can be canceled.
Since
100

◆ setViewpoint:duration:curve:completion:

- (id<AGSCancelable>) setViewpoint: (AGSViewpoint *)  viewpoint
duration: (double)  duration
curve: (AGSAnimationCurve curve
completion: (nullable void(^)(BOOL finished))  completion 

Zoom or pan the map with animation to the specified viewpoint.

Parameters
viewpointto zoom/pan to.
durationfor the zoom/pan animation.
curveType of animation.
completionblock which is invoked when operation completes. The finished argument indicates whether animation finished without any user interruption.
Returns
An operation which can be canceled.
Note
Any prior setViewpoint... animation will be canceled upon calling this method. If you want to chain together mulitple animations, wait for the prior animation to complete before calling this method.
Since
100

◆ setViewpointCenter:completion:

- (id<AGSCancelable>) setViewpointCenter: (AGSPoint *)  center
completion: (nullable void(^)(BOOL finished))  completion 

Zoom or pan the map with animation to the specified location.

Parameters
centerLocation on which the map should be centered.
completionA block which is invoked when operation completes. The finished argument indicates whether animation finished without any user interruption.
Returns
An operation which can be canceled.
Note
Any prior setViewpoint... animation will be canceled upon calling this method. If you want to chain together mulitple animations, wait for the prior animation to complete before calling this method.
Since
100

◆ setViewpointCenter:scale:completion:

- (id<AGSCancelable>) setViewpointCenter: (AGSPoint *)  center
scale: (double)  scale
completion: (nullable void(^)(BOOL finished))  completion 

Zoom or pan the map with animation to the specified location.

Parameters
centerLocation on which the map should be centered.
scaleThe scale to which the map should be zoomed to.
completionA block which is invoked when operation completes. The finished argument indicates whether animation finished without any user interruption.
Returns
An operation which can be canceled.
Note
Any prior setViewpoint... animation will be canceled upon calling this method. If you want to chain together mulitple animations, wait for the prior animation to complete before calling this method.
Since
100

◆ setViewpointGeometry:completion:

- (id<AGSCancelable>) setViewpointGeometry: (AGSGeometry *)  geometry
completion: (nullable void(^)(BOOL finished))  completion 

Zoom or pan the map with animation such that the given geometry fits the bounds of the map.

Parameters
geometryto fit to the bounds of the map.
completionblock which is invoked when operation completes. The finished argument indicates whether animation finished without any user interruption.
Returns
An operation which can be canceled.
Note
Any prior setViewpoint... animation will be canceled upon calling this method. If you want to chain together mulitple animations, wait for the prior animation to complete before calling this method.
Since
100

◆ setViewpointGeometry:padding:completion:

- (id<AGSCancelable>) setViewpointGeometry: (AGSGeometry *)  geometry
padding: (double)  paddingInScreenPoints
completion: (nullable void(^)(BOOL finished))  completion 

Zoom or pan the map with animation such that the given geometry fits the bounds of the map.

Parameters
geometryto fit to the bounds of the map.
paddingInScreenPointsto pad in each direction while fitting the geometry.
completionblock which is invoked when operation completes. The finished argument indicates whether animation finished without any user interruption.
Returns
An operation which can be canceled.
Note
Any prior setViewpoint... animation will be canceled upon calling this method. If you want to chain together mulitple animations, wait for the prior animation to complete before calling this method.
Since
100

◆ setViewpointRotation:completion:

- (id<AGSCancelable>) setViewpointRotation: (double)  angle
completion: (nullable void(^)(BOOL finished))  completion 

Rotate the map with animation to the specified angle.

Parameters
anglein degress to rotate to (in counter-clockwise direction).
completionblock which is invoked when operation completes. The finished argument indicates whether animation finished without any user interruption.
Returns
An operation which can be canceled.
Note
Any prior setViewpoint... animation will be canceled upon calling this method. If you want to chain together mulitple animations, wait for the prior animation to complete before calling this method.
Since
100

◆ setViewpointScale:completion:

- (id<AGSCancelable>) setViewpointScale: (double)  scale
completion: (nullable void(^)(BOOL finished))  completion 

Zoom the map with animation to the specified scale around its current center.

Parameters
scaleto which the map should be zoomed to.
completionblock which is invoked when operation completes. The finished argument indicates whether animation finished without any user interruption.
Returns
An operation which can be canceled.
Note
Any prior setViewpoint... animation will be canceled upon calling this method. If you want to chain together mulitple animations, wait for the prior animation to complete before calling this method.
Since
100

Property Documentation

◆ adjustedContentInset

- (UIEdgeInsets) adjustedContentInset
readnonatomicassigninherited

The insets derived from the content inset, the height of the attribution bar, and (on iOS) the safe area insets. For iOS, the insetsContentInsetFromSafeArea property determines whether the safe area insets are included in the adjustment.

Since
100.4

◆ attributionText

- (NSString*) attributionText
readnonatomiccopyinherited

Attribution for the geographic data currently being displayed in the view. This information is displayed in a banner along the bottom edge of the view. The attribution text changes can be monitored using Key-Value Observing (KVO).

Since
100.1

◆ attributionTextVisible

- (BOOL) attributionTextVisible
readwritenonatomicassigninherited

Specifies whether the attribution text banner (along the bottom edge of the view) should be visible. Defaults to YES.

Since
100

◆ attributionTopAnchor

- (NSLayoutYAxisAnchor*) attributionTopAnchor
readnonatomicstronginherited

The NSLayoutAnchor you can use to layout views in relationship to the attribution text on the AGSGeoView. This is helpful if you want to place a view just above the attribution text. And when the attribution text is collapsed or expanded your view will automatically move to the correct location in relation to the attribution text.

Since
100.1

◆ backgroundGrid

- (AGSBackgroundGrid*) backgroundGrid
readwritenonatomicstronginherited

Various settings applied to the map view's background. The background grid determines the color and context grid of a map view when no AGSMapView::map property has been set.

The AGSMap displays on top of the background grid or the optional AGSMap::backgroundColor property to determine what is displayed under transparent areas of the map.

If AGSMap::backgroundColor is not nil, then AGSMapView::backgroundGrid is ignored and AGSMap::backgroundColor will be used as the background color of the map.

See also
AGSMap::backgroundColor
Since
100.0

◆ callout

- (AGSCallout*) callout
readnonatomicstronginherited

A callout view for displaying information on the map.

Since
100

◆ contentInset

- (UIEdgeInsets) contentInset
readwritenonatomicassigninherited

Defines the edges where the AGSMapView is obscured by some other UI. This is important so that callouts display correctly, the location display is anchored appropriately, and setting a new viewpoint adjusts the map contents to correctly display in the unobscured part of the view. Setting this will affect the visibleArea that is reported by the AGSMapView.

Since
100.1

◆ drawStatus

- (AGSDrawStatus) drawStatus
readnonatomicassigninherited

Current drawing status of the view's content (map or scene). The draw status changes can be monitored using Key-Value Observing (KVO).

Since
100

◆ graphicsOverlays

- (NSMutableArray<AGSGraphicsOverlay*>*) graphicsOverlays
readnonatomicstronginherited

A list of AGSGraphicsOverlay objects that can be used to display graphics on top of the view's content.

Note
This array does not allow duplicate objects.
Since
100

◆ grid

- (AGSGrid*) grid
readwritenonatomicstronginherited

The coordinate system grid to display on top of the map.

Since
100

◆ insetsContentInsetFromSafeArea

- (BOOL) insetsContentInsetFromSafeArea
readwritenonatomicassigninherited

Indicates whether the content inset is relative to the safe area. When YES, the content inset is interpreted as a value relative to the safe area. When NO, the content inset is interpreted as a value from the edge of bounds. Defaults to YES.

Since
100.4

◆ interactionOptions

- (AGSMapViewInteractionOptions*) interactionOptions
readwritenonatomicstronginherited

Options to configure user interactions with the view.

Since
100

◆ labeling

- (AGSViewLabelProperties*) labeling
readwritenonatomicstronginherited

The view label properties.

The view label properties are an overall control for whether labels will be created and displayed for layers added to the view. Individual layers can also control whether labels should be displayed for their features. Labels need to be enabled both in the view and in the layer. By default the labeling for a view is enabled. The view label properties also control global aspects of the label appearance e.g. animation effects.

See also
AGSViewLabelProperties
Since
100.10

◆ layerViewStateChangedHandler

- (void(^ layerViewStateChangedHandler) (AGSLayer *layer, AGSLayerViewState *layerViewState))
readwritenonatomiccopyinherited

Block that is invoked whenever any map or scene layer's view state changes.

Note
The block will be invoked on the same thread on which the event occured, which could be any arbitrary thread. You need to dispatch any UI related work to the main thread.
Since
100

◆ locationDisplay

- (AGSLocationDisplay*) locationDisplay
readwritenonatomicstronginherited

Displays device location on the map from a datasource such as a GPS sensor.

Since
100

◆ map

- (AGSMap*) map
readwritenonatomicstronginherited

The map to be displayed by this map view. The map view loads the map and all of its layers in order to display their content on screen.

Since
100

◆ mapScale

- (double) mapScale
readnonatomicassigninherited

The current scale of the map. Will return 0 if it cannot be calculated. To change the scale see setViewpointCenter:scale:completion: or setViewpoint: (AGSGeoView).

Since
100

◆ navigating

- (BOOL) navigating
readnonatomicassigninherited

Specifies whether the view is navigating, for example, when a pan or zoom animation is in progress or if a user is interacting with the view by dragging or pinching. The navigating changes can be monitored using Key-Value Observing (KVO).

Since
100

◆ releaseHardwareResourcesWhenBackgrounded

- (BOOL) releaseHardwareResourcesWhenBackgrounded
readwritenonatomicassigninherited

◆ rotation

- (double) rotation
readnonatomicassigninherited

The rotation angle (in degrees). The map is rotated in a counter-clockwise direction by the amount specified. To specify a new angle, see setViewpointRotation:completion: or setViewpoint: (AGSGeoView).

Since
100

◆ selectionProperties

- (AGSSelectionProperties*) selectionProperties
readwritenonatomicstronginherited

The selection properties that is applied to the geo view.

This property allows configuration of new selection highlighting functionality such as selection promotion and switchable selection halo.

Notes on per-layer selection coloring (supported in 2D only):

The deprecated per-layer selection coloring functionality is initially enabled.

If the AGSGeoView's AGSSelectionProperties are touched, per-layer selection coloring is then disabled for the lifetime of the view. (Here, 'touched' means replacing the view's AGSSelectionProperties, or calling a setter property on the view's AGSSelectionProperties).

Use of per-layer selection coloring is deprecated and may have a detrimental impact on rendering performance.

When per-layer coloring is enabled and more than one selection color is configured, selection halo will be disabled.

To enable selection halo or promotion, set the properties to YES. Again, this will automatically disable per-layer selection coloring for the lifetime of the view.

Since
100.4

◆ sketchEditor

- (AGSSketchEditor*) sketchEditor
readwritenonatomicstronginherited

A sketch editor that allows users to interactively sketch geometries on the view.

Since
100

◆ spatialReference

- (AGSSpatialReference*) spatialReference
readnonatomicstronginherited

Spatial reference defining the coordinate system in which the view's content is displayed. The spatial reference changes can be monitored using Key-Value Observing (KVO).

Since
100
See also
http://desktop.arcgis.com/en/arcmap/latest/map/projections/what-are-map-projections.htm

◆ timeExtent

- (AGSTimeExtent*) timeExtent
readwritenonatomicstronginherited

The current AGSTimeExtent of the AGSGeoView. The Time Extent of the AGSGeoView defines how time-enabled data is displayed. Participating layers filter their data to only show data within the time extent set on the AGSGeoView (see AGSTimeAware for details). The range of the time extent includes the start and end values (a feature at 10/24/2016 would be included in a time extent defined as 10/24/2016 - 11/14/2016). Time filtering is not enabled until a non-nil time extent is set on the AGSGeoView. When the time extent is nil on the GeoView, no time filtering is applied and all content is rendered. The time extent changes can be monitored using Key-Value Observing (KVO).

See also
The AGSTimeAware::timeFilteringEnabled property to see if time filtering is enabled on layers.
Since
100.2

◆ touchDelegate

- (IBOutlet id<AGSGeoViewTouchDelegate>) touchDelegate
readwritenonatomicweakinherited

Delegate to be notified when touch events occur on the map.The delegate class must adopt the AGSGeoViewTouchDelegate protocol.

Since
100

◆ unitsPerPoint

- (double) unitsPerPoint
readnonatomicassigninherited

The map's current resolution (map units per Point).

Since
100

◆ viewpointChangedHandler

- (void(^ viewpointChangedHandler) (void))
readwritenonatomiccopyinherited

Block that gets invoked whenever the viewpoint changes.

Note
This handler may get invoked up to 60 times per second, for example, when a pan or zoom animation is in progress. Do not perform any heavy-lifting in this handler as it may adversely impact the rendering performance.
The block will be invoked on the same thread on which the event occured, which could be any arbitrary thread. You need to dispatch any UI related work to the main thread.
Since
100

◆ visibleArea

- (AGSPolygon*) visibleArea
readnonatomicstronginherited

A polygon representing the map's visible area, taking into account any contentInset property that has been specified to return only the unobscured portion of the map. The polygon always contains one ring with four vertices, each representing a corner of the map.

This is a polygon and not an envelope because the map may be rotated and each corner of the map may contain unique x-y coordinates, where as an envelope only permits two unique x coordinates (xmin, xmax) and two unique y coordinates (ymin, ymax). If the map has no rotation the polygon has the same coordinates as an envelope.

Note
Starting from version 100.3, the visible area excludes the portion of the map obscured by the map view's attribution bar. As a result of this change, the edges and center of the visible area may not coincide with the bounds and center of the view.
Since
100

◆ wrapAroundEnabled

- (BOOL) wrapAroundEnabled
readnonatomicassigninherited

Specifies whether the view's content wraps around the dateline.

Since
100

◆ wrapAroundMode

- (AGSWrapAroundMode) wrapAroundMode
readwritenonatomicassigninherited

Indicates whether the map should wrap around the dateline. Defaults to AGSWrapAroundModeEnabledWhenSupported.

Since
100