MoveTripState

MOVE Models

Returns the current user's driving state.

Android

enum class MoveTripState {
    UNKNOWN,
    IDLE,
    DRIVING,
    HALT,
    IGNORED
}

iOS

enum MoveTripState {
    case unknown
    case driving
    case halt
    case idle
    case ignored
}

React Native

export type TripState = 'UNKNOWN' | 'DRIVING' | 'HALT' | 'IDLE' | 'IGNORED';

Flutter

import 'package:movesdk/io/dolphin/move/move_trip_state.dart';

enum MoveTripState {
  unknown,
  idle,
  driving,
  halt,
  ignored,
}

MoveTripState
unknown	MOVE SDK detection service didn't start.
idle	Device is in state idle.
driving	Device is actively driving in a trip.
halt	Device is holding position in a trip (e.g. car is not moving, car is standing at a red traffic light).
ignored	Device is in a trip that is flagged as ignored by the host app.

Trip goes through different states during the MOVE SDK's life cycle. Initially the MoveTripState is .unknown, until the service is started.

When service successfully starts, the MoveTripState will transit to .idle state.

When the user starts driving a car or riding a bicycle (if configured), a trip will start and the MoveTripState will transit to .driving. During the trip, the user could sometimes choose to go to temporarily idle (like in traffic jams, traffic stops, etc.), this is expressed through the .halt MoveTripState. Halt state means that the user is in an active trip, but is currently stationary. As soon as the MOVE SDK detects that the user's trip has ended, MoveTripState will transit back again to .idle.

While being on a trip, the host app can choose to ignore the ongoing trip using the ignoreCurrentTrip API (Android / iOS / React / Flutter). This will transit the MoveTripState to .ignored MoveTripState. Ignored trips are purged and not forwarded to the server or further processed.

MoveTripState related
getTripState (Android / iOS / React / Flutter)	Gets the current MoveTripState .
tripStateListener(Android / iOS / React / Flutter)	Provide a block to be invoked every time MoveTripState changes.
finishCurrentTrip (Android / iOS / React Flutter)	Ends the current ongoing trip.
ignoreCurrentTrip (Android / iOS / React / Flutter)	Ignores the current ongoing trip.