Skip To Content ArcGIS for Developers Sign In Dashboard

Enums.LocationDisplayAutoPanMode enumeration

The LocationDisplayAutoPanMode can be one of:

ValueDescription
Enums.LocationDisplayAutoPanModeOff (0)In this mode, the MapView only updates the position of the location symbol on the screen. It does not re-center. Therefore, it is possible that the location symbol may eventually move off the screen as location updates are received. The LocationDisplay defaults to this mode.
Enums.LocationDisplayAutoPanModeRecenter (1)In this mode, the MapView attempts to keep the location symbol on-screen by re-centering the location symbol when the symbol moves outside a "wander extent". The wander extent is a rectangle that is the same shape as the MapView rectangle, is centered in the MapView, and whose size is a fraction of the size of the MapView rectangle. The fraction is called the wander extent factor. The location symbol may move freely within the wander extent, but as soon as the symbol exits the wander extent, the mapview re-centers map on the symbol. If the map is panned by the user while in this mode, the mode automatically changes to Off to prevent having to "fight" with the map (e.g. you pan to a new location but the MapView automatically pans back to the location symbol). However, if there is a zoom gesture (double-tap or pinch to zoom) or the MapView is rotated, the mode stays in Recenter, and the MapView zooms in/out or rotates around the location symbol.
Enums.LocationDisplayAutoPanModeNavigation (2)This mode is best suited for in-vehicle navigation. In this mode, the location symbol is pinned to a point on the screen, and always points towards the top edge of the device. The MapView pans and rotates the map based on location updates and the direction the device is traveling in. Therefore, the location symbol appears stationary and always pointing towards the top edge, while the map underneath it appears to be moving and rotating. If the map is panned by the user while in this mode, the mode automatically changes to Off to prevent having to "fight" with the map (e.g. you pan to a new location but the MapView automatically pans back to the location symbol). However, if there is a zoom gesture (double-tap or pinch to zoom) or the MapView is rotated, the mode stays in Navigation, and the MapView zooms in/out or rotates around the location symbol.
Enums.LocationDisplayAutoPanModeCompassNavigation (3)This mode is best suited for waypoint navigation when while walking. As in Navigation mode, the location symbol is pinned to a point on the screen, and always points towards the top edge of the device. However, the MapView pans and rotates the map based on location updates and the device's heading relative to the magnetic north (as opposed to the direction of travel in Navigation mode). The map reflects what lies ahead of the user as the user pivots around their location. If the map is panned by the user while in this mode, the mode automatically changes to Off to prevent having to "fight" with the map (e.g. you pan to a new location but the MapView automatically pans back to the location symbol). However, if there is a zoom gesture (double-tap or pinch to zoom) or the MapView is rotated, the mode stays in CompassNavigation, and the MapView zooms in/out or rotates around the location symbol.

Feedback on this topic?