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>
Indicates how the user carrying the smartphone moves: on foot (default), by car, etc. Knowing how the user moves is important because Situm adapts to each movement type. For example, if a user moves in a car, Situm may not behave correctly if this parameter is set to another movement type.

  • 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 cannot be modeled properly. Situm returns the location where the WiFi/BLE signals best match 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 use the camera internally, so readings must be injected with LocationManager.addExternalArData(ExternalArData) to use this motion mode.

    • VEHICLE_VISUAL_ODOMETRY

      @Deprecated public static final LocationRequest.MotionMode VEHICLE_VISUAL_ODOMETRY
      Deprecated.
      This mode is deprecated and does nothing; use one 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