Module com.esri.arcgisruntime
Package com.esri.arcgisruntime.mapping.view

Enum Class LocationDisplay.AutoPanMode

java.lang.Object
java.lang.Enum<LocationDisplay.AutoPanMode>
com.esri.arcgisruntime.mapping.view.LocationDisplay.AutoPanMode
All Implemented Interfaces:
Serializable, Comparable<LocationDisplay.AutoPanMode>, Constable
Enclosing class:
LocationDisplay
public static enum LocationDisplay.AutoPanMode extends Enum<LocationDisplay.AutoPanMode>
Defines how the MapView behaves when location updates are received. The default is OFF. All modes show current location using a symbol, and update the location when location updates are received from the LocationDataSource.
Since:
100.9.0

  • Nested Class Summary

    Nested classes/interfaces inherited from class java.lang.Enum

    Enum.EnumDesc<E extends Enum<E>>

  • Enum Constant Summary

    Enum Constants
    Enum Constant
    Description
    COMPASS_NAVIGATION
    Best suited for waypoint navigation when the user is on foot, the location symbol is fixed at a specific point on the screen, and always points towards the top edge of the device.
    NAVIGATION
    Best suited for in-vehicle navigation, the location symbol is fixed at a specific point on the screen, and always points towards the top of the screen.
    OFF
    The location symbol is shown at the current location, and is updated when location updates are received.
    RECENTER
    Keeps the location symbol on-screen by re-centering the location symbol when it moves outside a 'wander extent'.

  • Method Summary

    Modifier and Type
    Method
    Description
    static LocationDisplay.AutoPanMode
    valueOf(String name)
    Returns the enum constant of this class with the specified name.
    static LocationDisplay.AutoPanMode[]
    values()
    Returns an array containing the constants of this enum class, in the order they are declared.

    Methods inherited from class java.lang.Enum

    clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

    Methods inherited from class java.lang.Object

    getClass, notify, notifyAll, wait, wait, wait

  • Enum Constant Details

    • OFF

      public static final LocationDisplay.AutoPanMode OFF
      The location symbol is shown at the current location, and is updated when location updates are received. The map center and scale is unchanged, no auto-panning is performed. Therefore, it is possible that the location symbol may eventually move off the screen as location updates are received. This is the default AutoPanMode of the LocationDisplay.
      Since:
      100.9.0

    • RECENTER

      public static final LocationDisplay.AutoPanMode RECENTER
      Keeps the location symbol on-screen by re-centering the location symbol when it moves outside a 'wander extent'. The location may move freely within the wander extent, but as soon as the location exits the wander extent, the MapView re-centers the map on the symbol. The LocationDisplay.getDefaultSymbol() is used to indicate device location.

      Wander extent is set as a factor of the MapView's extent. By default the wander extent factor is 0.5, which represents half the size of the extent, but you can change its value using LocationDisplay#setWanderExtentFactor.

      If the visible map extent is changed by the user navigating the map interactively, or by a programmatic navigation method, this will cause AutoPanMode to be reset to OFF. However, if the user double-taps or pinches to zoom the map only, the AutoPanMode remains as RECENTER while the map is zoomed in or out, allowing users to easily zoom the map while in this mode.

      Since:
      100.9.0

    • COMPASS_NAVIGATION

      public static final LocationDisplay.AutoPanMode COMPASS_NAVIGATION
      Best suited for waypoint navigation when the user is on foot, the location symbol is fixed at a specific 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 device's heading relative to 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.

      The position of the location symbol relative to the bottom edge of the MapView is set as a factor of the MapView's height. By default, the symbol is displayed 1/8th of the distance up the MapView (factor of 0.125), but you can change this by calling LocationDisplay.setNavigationPointHeightFactor(float).

      If the visible map extent is changed by the user navigating the map interactively, or by a programmatic navigation method, this will cause AutoPanMode to be reset to OFF. However, if the user double-taps or pinches to zoom the map only, the AutoPanMode remains as COMPASS_NAVIGATION while the map is zoomed in or out, allowing users to easily zoom the map while in this mode.

      Since:
      100.9.0

  • Method Details

    • values

      public static LocationDisplay.AutoPanMode[] values()
      Returns an array containing the constants of this enum class, in the order they are declared.
      Returns:
      an array containing the constants of this enum class, in the order they are declared

    • valueOf

      public static LocationDisplay.AutoPanMode valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum class has no constant with the specified name
      NullPointerException - if the argument is null