MiX Telematics REST API

Trip

Represents a trip driven by a vehicle hosted by a MiX Telematics system.

Fields

SystemType
The type of MiX Telematics system that hosts the trip.
VehicleId
The identifier of the vehicle which drove the trip.
ReceivedTimestamp
The date/time at which the trip was received by the MiX Telematics servers.
TripType
The type of the trip.
DriverId
The identifier of the driver who was driving during the trip.
CoDriverId
The identifier of the driver who was the co-driver during the trip.
StartTimestamp
The date/time at which the trip started (from the device's clock).
StartPosition
The Position resource representing where and when the trip started.
EndTimestamp
The date/time at which the trip ended (from the device's clock).
EndPosition
The Position resource representing where and when the trip ended.
Distance
The trip distance.
DistanceUnits
The units for the trip distance.
EndOdometer
The odometer reading (in kilometres) of the vehicle at the end of the trip.
EndOdometerUnits
The units for the end odometer value.
MaxSpeed
The maximum speed (in kilometres per hour) reached during the trip.
MaxSpeedUnits
The units for the maximum speed value.
OverSpeedingCount
The number of over speeding events that occurred during the trip.
MaxAcceleration
The maximum acceleration reached during the trip.
MaxAccelerationUnits
The units for the maximum acceleration value.
HarshAccelerationCount
The number of harsh acceleration events that occurred during the trip.
MaxDeceleration
The maximum deceleration reached during the trip.
MaxDecelerationUnits
The units for the maximum deceleration value.
HarshBrakingCount
The number of harsh braking events that occurred during the trip.
SubTrips
The collection of sub trips which make up the trip.

Note: Fields which are not available will be omitted.

Examples

JSON body:

{"SystemType":"AssetManagement","VehicleId":"c89a9db7-46a5-4fb4-ab28-dc0ae807b5dc","ReceivedTimestamp":"\/Date(1306295232870+0000)\/","TripType":"Unknown","DriverId":"047d6331-23b4-42c9-bca6-26a3f67c4e85","StartTimestamp":"\/Date(1306295250000+0000)\/","StartPosition":{"SystemType":"AssetManagement","VehicleId":"c89a9db7-46a5-4fb4-ab28-dc0ae807b5dc","DeviceTimestamp":"\/Date(1306295250000+0000)\/","ReceivedTimestamp":"\/Date(1306295232867+0000)\/","DriverId":"047d6331-23b4-42c9-bca6-26a3f67c4e85","Odometer":116.52,"Longitude":7.567398,"Latitude":50.36023,"Speed":0,"Heading":182,"Altitude":79,"Hdop":2,"Vdop":2,"Pdop":3,"Satellites":8,"Age":0},"EndTimestamp":"\/Date(1306295259000+0000)\/","EndPosition":{"SystemType":"AssetManagement","VehicleId":"c89a9db7-46a5-4fb4-ab28-dc0ae807b5dc","DeviceTimestamp":"\/Date(1306295259000+0000)\/","ReceivedTimestamp":"\/Date(1306295232870+0000)\/","DriverId":"047d6331-23b4-42c9-bca6-26a3f67c4e85","Odometer":116.52,"Longitude":7.567451,"Latitude":50.36024,"Speed":0,"Heading":119,"Altitude":79,"Hdop":2,"Vdop":2,"Pdop":3,"Satellites":8,"Age":0},"Distance":0}

XML body:

<?xml version="1.0"?>
<Trip SystemType="AssetManagement" VehicleId="c89a9db7-46a5-4fb4-ab28-dc0ae807b5dc">
	<ReceivedTimestamp UtcOffset="0">2011-05-25T03:47:12.87Z</ReceivedTimestamp>
	<TripType>Unknown</TripType>
	<DriverId>047d6331-23b4-42c9-bca6-26a3f67c4e85</DriverId>
	<StartTimestamp UtcOffset="0">2011-05-25T03:47:30Z</StartTimestamp>
	<StartPosition SystemType="AssetManagement" VehicleId="c89a9db7-46a5-4fb4-ab28-dc0ae807b5dc">
		<DeviceTimestamp UtcOffset="0">2011-05-25T03:47:30Z</DeviceTimestamp>
		<ReceivedTimestamp UtcOffset="0">2011-05-25T03:47:12.867Z</ReceivedTimestamp>
		<DriverId>047d6331-23b4-42c9-bca6-26a3f67c4e85</DriverId>
		<Odometer>116.52</Odometer>
		<Longitude>7.567398</Longitude>
		<Latitude>50.36023</Latitude>
		<Speed>0</Speed>
		<Heading>182</Heading>
		<Altitude>79</Altitude>
		<Hdop>2</Hdop>
		<Vdop>2</Vdop>
		<Pdop>3</Pdop>
		<Satellites>8</Satellites>
		<Age>0</Age>
	</StartPosition>
	<EndTimestamp UtcOffset="0">2011-05-25T03:47:39Z</EndTimestamp>
	<EndPosition SystemType="AssetManagement" VehicleId="c89a9db7-46a5-4fb4-ab28-dc0ae807b5dc">
		<DeviceTimestamp UtcOffset="0">2011-05-25T03:47:39Z</DeviceTimestamp>
		<ReceivedTimestamp UtcOffset="0">2011-05-25T03:47:12.87Z</ReceivedTimestamp>
		<DriverId>047d6331-23b4-42c9-bca6-26a3f67c4e85</DriverId>
		<Odometer>116.52</Odometer>
		<Longitude>7.567451</Longitude>
		<Latitude>50.3602448</Latitude>
		<Speed>0</Speed>
		<Heading>119</Heading>
		<Altitude>79</Altitude>
		<Hdop>2</Hdop>
		<Vdop>2</Vdop>
		<Pdop>3</Pdop>
		<Satellites>8</Satellites>
		<Age>0</Age>
	</EndPosition>
	<Distance>0</Distance>
	<MaxAcceleration xsi:nil="true"/>
</Trip>