pollStatusChanges

Use this endpoint to poll all the statusThe specific activity or task a driver is currently engaged in, typically as part of a process called a "status loop." changes for all active vehiclesAll machines used as a means of production on a construction site or at a batch plant.. Polling must not occur more frequently than 15 seconds.

Request

Parameter

Description

Type

Required

Notes

webkey

Unique webkey associated with an interface.

String

Required

Obtained from InterfaceWS.

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

<soapenv:Header/>

<soapenv:Body>

<v1:pollStatusChangesReqAck>

<!--Optional:-->

<webkey>{webkey}</webkey>

</v1:pollStatusChangesReqAck>

</soapenv:Body>

</soapenv:Envelope>

pollStatusChangesResponse

Parameter

Description

Notes

return

 

 

 

 statusChangeID

Identification number for the status change. With each new status change, the number increases by 1.

 

 

 vehicleID

Unique identifier for the vehicleAll machines used as a means of production on a construction site or at a batch plant. undergoing the status change.

 

 

 vehicleNum

The equipmentAll machines used as a means of production on a construction site or at a batch plant.'s identification number.

 

 

 altVehicleNum

The vehicle's alternate identification number.

 

 

 statusID

Unique identifier for the status.

 

 

 statusNum

The status's corresponding identification number(s).

 

 

 statusDesc

Status description for the status change.

 

 

 timestamp  

 

 

   year

 

 

 

   month  

 

 

   day  

 

 

   hour  

 

 

   minute  

 

 

   second  

 

 

   timezone  

 

 

 statusChangeType

Number associated with the status change type.

 

 

 hotspotID

Unique identifier for the hotspotGeographic areas marked on a map that act as destinations for driver navigation or triggers for automated behaviors in TrackIt. associated with the status change.

 

 

 plantNum

The plantA production plant or material storage location. number for the plant associated with the vehicle that underwent the status change.

 

 

 fuelLevel

Fuel level for the vehicle that underwent the status change.

 

 

 productive

Whether or not the status is productive.

 

 

 paid

Whether or not the status is a paid status.

 

 

 statusMeaning

The status meaning associated with the new status.

 

 

 useAlternateVehicleNum

Whether or not the alternate vehicle number was used to initiate the status change.

 

COMMANDassurance Returns

Parameter

Description

Notes

return

 

 

 

 statusChangeID

Identification number for the status change. With each new status change, the number increases by 1.

 

 

 vehicleID

Unique identifier for the vehicle undergoing the status change.

 

 

 vehicleNum

The equipment's identification number.

 

 

 altVehicleNum

The vehicle's alternate identification number.

 

 

 statusID

Unique identifier for the status.

 

 

 statusNum

The status's corresponding identification number(s).

 

 

 statusDesc

Status description for the status change.

 

 

 timestamp Timestamp of the moment when the status changed.

 

 

   year

 

 

 

   month  

 

 

   day  

 

 

   hour  

 

 

   minute  

 

 

   second  

 

 

   timezone  

 

 

 statusChangeType

Number associated with the status change type.

 

 

 hotspotID

Unique identifier for the hotspot associated with the status change.

 

 

 plantNum

The plant number for the plant associated with the vehicle that underwent the status change.

 

 

 fuelLevel

Fuel level for the vehicle that underwent the status change.

Units of measurement set in the TrackIt Web Console Site Settings page.

 

 productive

Whether or not the status is productive.

 

 

 paid

Whether or not the status is a paid status.

 

 

 statusMeaning

The status meaning associated with the new status.

 

 

 latestProbeData  

 

 

   temperature

Temperature of the truckAll machines used as a means of production on a construction site or at a batch plant.'s loadThe total amount of concrete or asphalt that is being or has been batched for delivery. when the status change occurred.

 

 

     unit

Unit of measurement for the load temperature.

 

 

     value

Actual value of the load temperature.

 

 

   timestamp

Timestamp for the moment the status changed.

 

 

   totalTurns

Total revolutions for the truck's drum at the time of the status change.

 

 

   workabilityThe consistency of fresh concrete before it sets is called workability. The makeup of a mix is measured using a slump flow test to measure both vertical and horizontal settling. Slump factors in the viscous nature of a mixture and is measured vertically. Spread factors in the flow of the material and is measured horizontally.

 

 

 

     type

Type of workability measurement displayed.

 

 

     unit

Unit of measurement for the workability.

Can be inches (INH) or centimeters.

 

     value

Actual value of the workability measurement.

 

 

 useAlternateVehicleNum  

Whether or not the alternate vehicle number was used to initiate the status change.

 

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

<S:Body>

<ns2:pollStatusChangesReqAckResponse xmlns:ns2="http://v1.integration.services.trakitgps.com/">

<return>

<statusChangeID>{status change ID number}</statusChangeID>

<vehicleID>{vehicle ID}</vehicleID>

<vehicleNum>{vehicle number}</vehicleNum>

<altVehicleNum>{alternative vehicle number}</altVehicleNum>

<statusID>{status ID number}</statusID>

<statusNum>{status number}</statusNum>

<statusDesc>{status description}</statusDesc>

<timestamp>

<year>{year}</year>

<month>{month}</month>

<day>{day of the month}</day>

<hour>{hour}</hour>

<minute>{minute(s)</minute>

<second>{seconds}</second>

<timeZone>{timezone}</timeZone>

</timestamp>

<statusChangeType>{status change type}</statusChangeType>

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

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

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

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

</return>

<return>

<statusChangeID>{status change ID number}</statusChangeID>

<vehicleID>{vehicle ID}</vehicleID>

<vehicleNum>{vehicle number}</vehicleNum>

<altVehicleNum>{alternative vehicle number}</altVehicleNum>

<statusID>{status ID number}</statusID>

<statusNum>{status number}</statusNum>

<statusDesc>{status description}</statusDesc>

<timestamp>

<year>{year}</year>

<month>{month}</month>

<day>{day of the month}</day>

<hour>{hour}</hour>

<minute>{minute(s)</minute>

<second>{seconds}</second>

<timeZone>{timezone}</timeZone>

</timestamp>

<statusChangeType>{status change type}</statusChangeType>

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

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

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

<statusMeaning>{status meaning number}</statusMeaning>

<latestProbeData>

<temperature>

<unit>{unit abbreviation}</unit>

<value>{temp value}</value>

</temperature>

<timestamp/>

<totalTurns>{total drum revolutions}</totalTurns>

<workability>

<type>{workability type}</type>

<unit>{unit abbreviation}</unit>

<value>{workability value}</value>

</workability>

</latestProbeData>

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

</return>

<return>

<statusChangeID>{status change ID number}</statusChangeID>

<vehicleID>{vehicle ID}</vehicleID>

<vehicleNum>{vehicle number}</vehicleNum>

<statusID>{status ID number}</statusID>

<statusNum>{status number}</statusNum>

<statusDesc>{status description}</statusDesc>

<timestamp>

<year>{year}</year>

<month>{month}</month>

<day>{day of the month}</day>

<hour>{hour}</hour>

<minute>{minute(s)</minute>

<second>{seconds}</second>

<timeZone>{timezone}</timeZone>

</timestamp>

<statusChangeType>{status change type}</statusChangeType>

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

<plantNum>{plant number}</plantNum>

<fuelLevel>{fuel level}</fuelLevel>

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

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

<statusMeaning>{status meaning number}</statusMeaning>

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

</return>

</ns2:pollStatusChangesResponse>

</S:Body>

</S:Envelope>