TripSummary

The Trip Summary report XML response is invoked by external calls for the TripSummary table.

This report allows you to gauge driver performance, process trends, and average time spent performing tasks.

Parameters

tripParams
Parameter Description Type Required Notes

dateRange

The day(s) desired for report data querying.

Date Range

Required

 

employeeNum

The identification numbers for the employeeUser accounts for drivers, dispatchers, and other staff to perform varying functions in TrackIt.(s) queried.

Integer

 

 

vehicleNum

The identifying numbers for the vehicleAll machines used as a means of production on a construction site or at a batch plant.(s) queried.

Integer

Required

 

plantNum

The identifying numbers for the plantA production plant or material storage location.(s) queried.

Integer

Required

 

beginStatusNum

The identification number of the statusThe specific activity or task a driver is currently engaged in, typically as part of a process called a "status loop." to indicate the start of a trip.

Integer

Required

 

endStatusNum

The identification number of the status to indicate the end of a trip.

Integer

Required

 

statusTypeID

The status type's identification number.

Integer

Required

 

includeBeginningStatus

The time spent in the beginning status of the trip is or is not factored into trip statistics.

Boolean

 

 

includeEndingStatus

The time spent in the ending status of the trip is or is not factored into trip statistics.

Boolean

 

 

showMiles

Indicates whether statuses should include mileage traveled and fuel used while in the status.

Boolean

 

The values provided will always be in miles and gallons.

Returns

tripData
Parameter Description Notes

avgTime

The average amount of time spent by equipmentAll machines used as a means of production on a construction site or at a batch plant. on a trip, as measured in seconds.

 

avgTimeMillis

The average amount of time spent by equipment on a trip, as measured in milliseconds.

 

count

The total number of occurrences when equipment completed this status loopA series of statuses that constitute the typical process a driver should progress through as part of their daily duties. the specified date range.

 

employeeNum

The employee's identification number.

 

endStatusNum

The identification number of the last status in the trip's status loop.

 

maxTime

The greatest amount of time spent by equipment on a trip, as measured in seconds.

 

maxTimeMillis

The greatest amount of time spent by equipment on a trip, as measured in milliseconds.

 

minTime

The smallest amount of time spent by equipment on a trip, as measured in seconds.

 

minTimeMillis

The smallest amount of time spent by equipment on a trip, as measured in milliseconds.

 

startStatusNum

The identification number of the first status in the trip's status loop.

 

totalTime

The total amount of time spent on a trip by equipment during the specified date range, as measured in seconds.

 

totalTimeMillis

The total amount of time spent on a trip by equipment during the specified date range, as measured in milliseconds.

 

vehicleNum

The equipment's identification number.