com.zendrive.sdk

Class DriveInfo

java.lang.Object

com.zendrive.sdk.DriveInfo

All Implemented Interfaces:

Parcelable

Direct Known Subclasses:

AnalyzedDriveInfo, EstimatedDriveInfo

public class DriveInfo
extends Object
implements 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

Modifier and Type	Class and Description
static class	DriveInfo.Warning Enum representing warnings detected for the current drive.

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

Parcelable.ClassLoaderCreator<T>, 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 Parcelable.Creator<DriveInfo>	CREATOR
double	distanceMeters The total distance of the drive in meters.
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.
ZendriveEventRatings	eventRatings Ratings associated with various event types for this drive.
ArrayList<ZendriveEvent>	events A list of events detected by the sdk for this drive.
ZendriveInsurancePeriod	insurancePeriod The insurance period in which the drive was detected.
double	maxSpeed The maximum speed of the drive in meters per second.
PhonePosition	phonePosition Position of the phone or device for the majority of the drive.
DriveScore	score The driving behaviour score for this drive.
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.
ArrayList<ZendriveTagInfo>	tags A list of tag infos for this drive.
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.
ArrayList<DriveInfo.Warning>	warnings A list of warnings for this drive.
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

Modifier	Constructor and Description
	DriveInfo() Default constructor.
protected	DriveInfo(Parcel in)

Method Summary

Modifier and Type	Method and Description
int	describeContents()
boolean	equals(Object o)
int	hashCode()
String	toString()
void	writeToParcel(Parcel dest, int flags)

Methods inherited from class java.lang.Object

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

Field Detail

driveId

public 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

@Nullable
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. Driver/Passenger detection will only be available in AnalyzedDriveInfo.

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.

phonePosition

@NonNull
public PhonePosition phonePosition

Position of the phone or device for the majority of the drive.

waypoints

public 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

@Nullable
public 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

@Nullable
public 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.

insurancePeriod

@Nullable
public ZendriveInsurancePeriod insurancePeriod

The insurance period in which the drive was detected. This will be null if there is no insurance period associated with this drive.

events

public 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.

eventRatings

public ZendriveEventRatings eventRatings

Ratings associated with various event types for this drive.

warnings

public ArrayList<DriveInfo.Warning> warnings

A list of warnings for this drive.

tags

public ArrayList<ZendriveTagInfo> tags

A list of tag infos for this drive.

The list will be populated only in the AnalyzedDriveInfo.

See Also:

ZendriveVehicleTagging.getAssociatedVehicleIdForDrive(com.zendrive.sdk.DriveInfo)

CREATOR

public static final Parcelable.Creator<DriveInfo> CREATOR

Constructor Detail

DriveInfo

public DriveInfo()

Default constructor.

DriveInfo

protected DriveInfo(Parcel in)

Method Detail

describeContents

public int describeContents()

Specified by:

describeContents in interface Parcelable

writeToParcel

public void writeToParcel(Parcel dest,
                          int flags)

Specified by:

writeToParcel in interface Parcelable

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object