com.zendrive.sdk

Class DriveInfo

java.lang.Object

com.zendrive.sdk.DriveInfo

All Implemented Interfaces:

android.os.Parcelable

Direct Known Subclasses:

AnalyzedDriveInfo, EstimatedDriveInfo

public class DriveInfo
extends java.lang.Object
implements android.os.Parcelable

Information about a drive recorded by the Zendrive SDK. The drive may have started manually by the application or due to Zendrive auto drive detection.

Nested Class Summary

Nested classes/interfaces inherited from interface android.os.Parcelable

android.os.Parcelable.ClassLoaderCreator<T>, android.os.Parcelable.Creator<T>

Field Summary

Fields

Modifier and Type	Field and Description
double	averageSpeed The average speed of the drive in meters per second.
static android.os.Parcelable.Creator<DriveInfo>	CREATOR
double	distanceMeters The total distance of the drive in meters.
java.lang.String	driveId An identifier for this drive that was recorded.
ZendriveDriveType	driveType The type of drive.
long	endTimeMillis The end timestamp of the drive in milliseconds since epoch.
java.util.ArrayList<ZendriveEvent>	events A list of events detected by the sdk for this drive.
double	maxSpeed The maximum speed of the drive in meters per second.
DriveScore	score The driving behaviour score for this drive.
java.lang.String	sessionId Session id is specified by the enclosing application when it wants to record a session.
long	startTimeMillis The start timestamp of the drive in milliseconds since epoch.
java.lang.String	trackingId Tracking id is specified by the enclosing application when it wants to start a drive manually.
ZendriveUserMode	userMode Whether the user was a driver or a passenger.
java.util.ArrayList<LocationPointWithTimestamp>	waypoints A list of LocationPointWithTimestamp objects corresponding to this drive in increasing order of timestamp.

Fields inherited from interface android.os.Parcelable

CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE

Constructor Summary

Constructors

Constructor and Description
DriveInfo() Default constructor.

Method Summary

Modifier and Type	Method and Description
int	describeContents() Describe the kinds of special objects contained in this Parcelable's marshalled representation.
boolean	equals(java.lang.Object o) Compares this instance with the specified object and indicates if they are equal.
int	hashCode() Returns an integer hash code for this object.
java.lang.String	toString() Returns a string containing a concise, human-readable description of this object.
void	writeToParcel(android.os.Parcel dest, int flags) Flatten this object in to a Parcel.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

driveId

public java.lang.String driveId

An identifier for this drive that was recorded. This identifier is unique for a particular driverId with which the SDK is initialized. This id can be used as the "trip_id" to query information about a trip from the Zendrive Analytics API.

startTimeMillis

public long startTimeMillis

The start timestamp of the drive in milliseconds since epoch.

endTimeMillis

public long endTimeMillis

The end timestamp of the drive in milliseconds since epoch.

driveType

public ZendriveDriveType driveType

The type of drive. This also determines what other properties of this object are set.

userMode

public ZendriveUserMode userMode

Whether the user was a driver or a passenger. Driver/Passenger detection is disabled by default. Talk to your contact in Zendrive to enable this feature. Only present when driveType is ZendriveDriveType.DRIVE and the SDK was able to determine with confidence whether the user was a driver or a passenger. If the SDK was not able to determine the user mode, this field is null.

distanceMeters

public double distanceMeters

The total distance of the drive in meters.

averageSpeed

public double averageSpeed

The average speed of the drive in meters per second. If we could not estimate the average speed due to lack of reliable location data, this value will be -1.

maxSpeed

public double maxSpeed

The maximum speed of the drive in meters per second. If we could not estimate the maximum speed due to lack of reliable location data, this value will be -1.

waypoints

public java.util.ArrayList<LocationPointWithTimestamp> waypoints

A list of LocationPointWithTimestamp objects corresponding to this drive in increasing order of timestamp. The first point corresponds to drive start location and last to drive end location. This is a sampled approximation of the drive which gives an indication of the path taken by the driver. It is not the full detailed location data of the drive. If no waypoints are recorded during the drive, then this is an empty array.

trackingId

public java.lang.String trackingId

Tracking id is specified by the enclosing application when it wants to start a drive manually. This will be null if no tracking id was specified.

sessionId

public java.lang.String sessionId

Session id is specified by the enclosing application when it wants to record a session. This will be null if there is no session is associated with this drive.

events

public java.util.ArrayList<ZendriveEvent> events

A list of events detected by the sdk for this drive.

score

public DriveScore score

The driving behaviour score for this drive.

CREATOR

public static final android.os.Parcelable.Creator<DriveInfo> CREATOR

Constructor Detail

DriveInfo

public DriveInfo()

Default constructor.

Method Detail

describeContents

public int describeContents()

Description copied from interface: android.os.Parcelable

Describe the kinds of special objects contained in this Parcelable's marshalled representation.

Specified by:

describeContents in interface android.os.Parcelable

Returns:

a bitmask indicating the set of special object types marshalled by the Parcelable.

writeToParcel

public void writeToParcel(android.os.Parcel dest,
                          int flags)

Description copied from interface: android.os.Parcelable

Flatten this object in to a Parcel.

Specified by:

writeToParcel in interface android.os.Parcelable

Parameters:

dest - The Parcel in which the object should be written.

flags - Additional flags about how the object should be written. May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE.

equals

public boolean equals(java.lang.Object o)

Description copied from class: java.lang.Object

Compares this instance with the specified object and indicates if they are equal. In order to be equal, o must represent the same object as this instance using a class-specific comparison. The general contract is that this comparison should be reflexive, symmetric, and transitive. Also, no object reference other than null is equal to null.

The default implementation returns true only if this == o. See Writing a correct equals method if you intend implementing your own equals method.

The general contract for the equals and Object.hashCode() methods is that if equals returns true for any two objects, then hashCode() must return the same value for these objects. This means that subclasses of Object usually override either both methods or neither of them.

Overrides:

equals in class java.lang.Object

Parameters:

o - the object to compare this instance with.

Returns:

true if the specified object is equal to this Object; false otherwise.

See Also:

Object.hashCode()

hashCode

public int hashCode()

Description copied from class: java.lang.Object

Returns an integer hash code for this object. By contract, any two objects for which Object.equals(java.lang.Object) returns true must return the same hash code value. This means that subclasses of Object usually override both methods or neither method.

Note that hash values must not change over time unless information used in equals comparisons also changes.

See Writing a correct hashCode method if you intend implementing your own hashCode method.

Overrides:

hashCode in class java.lang.Object

Returns:

this object's hash code.

See Also:

Object.equals(java.lang.Object)

toString

public java.lang.String toString()

Description copied from class: java.lang.Object

Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:

   getClass().getName() + '@' + Integer.toHexString(hashCode())

See Writing a useful toString method if you intend implementing your own toString method.

Overrides:

toString in class java.lang.Object

Returns:

a printable representation of this object.