StatusBreakdownReport v1

The Status Breakdown report XML response is invoked by external calls for the StatusBreakdownReport table.

This report breaks down individual statusThe specific activity or task a driver is currently engaged in, typically as part of a process called a "status loop." durations, the triggering action for that status, and when the trigger occurred. To query and group data by status number, use the StatusBreakdownReportUsingStatusNum web service.

Parameters

statusBreakdownParams
Parameter Description Type Required Notes

statusNums

The status's corresponding identification number(s).

Integer

Required

Separate multiple entries with a comma.

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

 

 

typeID

The employee or vehicle type ID depending on which one the query is focused.

Integer

 

statusTypeId

The status type's identification number.

Integer

 

showMiles

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

Boolean

 

The values provided in the response will always be in miles and gallons.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://v1.report.services.trakitgps.com/">

<soapenv:Header/>

<soapenv:Body>

<v1:StatusBreakdownReport>

<!--Optional:-->

<webkey>{webkey}</webkey>

<!--Optional:-->

<StatusBreakdownParams>

<!--1 or more repetitions:-->

<statusNums>{status numbers}</statusNums>

<dateRange>

<startDate>

<year>{year}</year>

<month>{month}</month>

<day>{day}</day>

<hour>{hour}</hour>

<minute>{minute}</minute>

<second>{second}</second>

<!--Optional:-->

<timeZone>{time zone}</timeZone>

</startDate>

<endDate>

<year>{year}</year>

<month>{month}</month>

<day>{day}</day>

<hour>{hour}</hour>

<minute>{minute}</minute>

<second>{second}</second>

<!--Optional:-->

<timeZone>{time zone}</timeZone>

</endDate>

</dateRange>

<!--Optional:-->

<employeeNum>{employee number}</employeeNum>

<!--Optional:-->

<vehicleNum>{vehicle number}</vehicleNum>

<!--Optional:-->

<typeID>{type ID}</typeID>

<!--Optional:-->

<statusTypeId>{status type ID}</statusTypeId>

<showMiles>{true or false}</showMiles>

</StatusBreakdownParams>

</v1:StatusBreakdownReport>

</soapenv:Body>

</soapenv:Envelope>

Returns

statusBreakdownData
Parameter Description Notes

distance

 Distance vehicle traveled in miles between status changes.

 

employeeNum

The employee's identification number.

 

fuelUsed

 Amount of fuel used in gallons.

 

hotspotID

The hotspotGeographic areas marked on a map that act as destinations for driver navigation or triggers for automated behaviors in TrackIt.'s identification number.

 

latitude

The north/south coordinates for the GPS fixCoordinates for a vehicle's location. These are fetched by TrackIt at regular intervals to map equipment routes over the course of a day. received.

 

longitude

The west/east coordinates for the GPS fix received.

 

plantNum

The plantA production plant or material storage location. number associated with the employee and/or equipmentAll machines used as a means of production on a construction site or at a batch plant..

 

startTime

The time stamp associated with the status when the status first became active.

 

statusChangeType

The action that caused the status change, such as a user- or system-triggered response.

Values:

0 UNKNOWN unknown
1 STATUSCHANGE status_change
2 DISPATCH dispatch
3 INTERFACE interface
4 INTERFACEDIVERTED interface_diverted

statusNum

The status's corresponding identification number.

 

timeSpent

The total time spent in a status before a change is triggered.

Measured in minutes.

timeSpentMillis

The total time spent in a status before a change is triggered.

Measured in milliseconds.

vehicleNum

The equipment's identification number.

 

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">

<S:Body>

<ns2:StatusBreakdownReportResponse xmlns:ns2="http://v1.report.services.trakitgps.com/">

<return>

<distance>{distance}</distance>

<employeeNum>{employee number}</employeeNum>

<fuelUsed>{fuel used}</fuelUsed>

<hotspotID>{hotspot ID number}</hotspotID>

<latitude>{latitude}</latitude>

<longitude>{longitude}</longitude>

<plantNum>{plant number}</plantNum>

<startTime>

<year>{year}</year>

<month>{month}</month>

<day>{day}</day>

<hour>{hour}</hour>

<minute>{minute}</minute>

<second>{second}</second>

<timeZone>{time zone}</timeZone>

</startTime>

<statusChangeType>{change type}</statusChangeType>

<statusNum>{status number}</statusNum>

<timeSpent>{time spent in status}</timeSpent>

<timeSpentMillis>{time spent}</timeSpentMillis>

<vehicleNum>{vehicle number}</vehicleNum>

</return>

<return>

<distance>{distance}</distance>

<employeeNum>{employee number}</employeeNum>

<fuelUsed>{fuel used}</fuelUsed>

<hotspotID>{hotspot ID number}</hotspotID>

<latitude>{latitude}</latitude>

<longitude>{longitude}</longitude>

<plantNum>{plant number}</plantNum>

<startTime>

<year>{year}</year>

<month>{month}</month>

<day>{day}</day>

<hour>{hour}</hour>

<minute>{minute}</minute>

<second>{second}</second>

<timeZone>{time zone}</timeZone>

</startTime>

<statusChangeType>{change type}</statusChangeType>

<statusNum>{status number}</statusNum>

<timeSpent>{time spent in status}</timeSpent>

<timeSpentMillis>{time spent}</timeSpentMillis>

<vehicleNum>{vehicle number}</vehicleNum>

</return>

</ns2:StatusBreakdownReportResponse>

</S:Body>

</S:Envelope>