Package es.situm.sdk.location

Enum Class LocationRequest.MotionMode

java.lang.Object
java.lang.Enum<LocationRequest.MotionMode>
es.situm.sdk.location.LocationRequest.MotionMode
All Implemented Interfaces:
Serializable, Comparable<LocationRequest.MotionMode>, Constable
Enclosing class:
LocationRequest
public static enum LocationRequest.MotionMode extends Enum<LocationRequest.MotionMode>
Allows to indicate how the user that carries the smartphone moves: by foot (default), by car, etc. Knowing how the user moves is important since Situm adapts to each movement type (e.g. if an user moves in a car, Situm will not behave well if this parameter is set to other type of movement).

  • Enum Constant Details

    • BY_FOOT

      public static final LocationRequest.MotionMode BY_FOOT
      (DEFAULT) User moves on foot (walking), Situm estimates the displacement using inertial sensors (accelerometer, gyroscope, magnetometer). This is the most common configuration for wayfinding and tracking apps.

    • BY_CAR

      public static final LocationRequest.MotionMode BY_CAR
      User moves in a car, Situm estimates the displacement using inertial sensors (accelerometer, gyroscope, magnetometer). Common configuration for wayfinding apps for cars in parking lots.

    • RADIOMAX

      public static final LocationRequest.MotionMode RADIOMAX
      User movement type not known or can not be modelled properly, Situm will just return the location where the WiFi/BLE signals match better with those of the calibrations. Location may be a bit jumpy and less accurate. If the device stays still for a long time period (no acceleration detected), at some point Situm will repeat the same location until the device moves again.

      This mode is typically used to track vehicles that show complex movements, such as forklifts in factories or warehouses. If this is the case, VEHICLE_VISUAL_ODOMETRY is recommended instead (provides better accuracy).

      When using this mode, the value of LocationRequest.useDeadReckoning() is ignored.

    • BY_FOOT_VISUAL_ODOMETRY

      public static final LocationRequest.MotionMode BY_FOOT_VISUAL_ODOMETRY
      The user moves on foot. This method makes use of visual odometry from the camera if available. The sdk does not make use of the camera internally, so to make use of this motion mode, readings must be injected using the LocationManager.addExternalArData(ExternalArData) method.

    • VEHICLE_VISUAL_ODOMETRY

      @Deprecated public static final LocationRequest.MotionMode VEHICLE_VISUAL_ODOMETRY
      Deprecated.
      This mode is deprecated and it does nothing, use some of the other options

  • Method Details

    • values

      public static LocationRequest.MotionMode[] 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 LocationRequest.MotionMode 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