MiX Telematics REST API

SubTrip

Represents a sub trip driven by a vehicle hosted by a MiX Telematics Fleet Manager system.

Fields

Sequence
The sequence number of the sub trip.
SartTimestamp
The date/time at which the sub trip started (from the device's clock).
StartPosition
The Position resource representing where and when the sub trip started.
EndTimestamp
The date/time at which the sub trip ended (from the device's clock).
EndPosition
The Position resource representing where and when the sub trip ended.
Distance
The sub trip distance.
DistanceUnits
The units for the sub trip distance.
EndOdometer
The odometer reading of the vehicle at the end of the sub trip.
EndOdometerUnits
The units for the end odometer value.
MaxSpeed
The maximum speed reached during the sub trip.
MaxSpeedUnits
The units for the maximum speed value.

Note: Fields which are not available will be omitted.

Examples

JSON body:

{"Sequence":1,"StartTimestamp":"\/Date(1334733704000+0000)\/","StartPosition":{"SystemType":"FM","VehicleId":"712","DeviceTimestamp":"\/Date(1334726260000+0000)\/","DriverId":"0","Longitude":31.06608,"Latitude":-29.73536,"Speed":1,"Heading":256,"Altitude":148,"Hdop":5,"Satellites":4,"Age":1068},"EndTimestamp":"\/Date(1334733704000+0000)\/","EndPosition":{"SystemType":"FM","VehicleId":"712","DeviceTimestamp":"\/Date(1334727645000+0000)\/","DriverId":"0","Longitude":31.01142,"Latitude":-29.83128,"Speed":0,"Heading":0,"Altitude":94,"Hdop":1,"Satellites":10,"Age":0},"Distance":14.9,"EndOdometer":4892.2,"MaxSpeed":96}

XML body:

<?xml version="1.0"?>
<SubTrip Sequence="1">
	<StartTimestamp UtcOffset="0">2012-04-18T07:21:44Z</StartTimestamp>
	<StartPosition SystemType="FM" VehicleId="712">
		<DeviceTimestamp UtcOffset="0">2012-04-18T05:17:40Z</DeviceTimestamp>
		<DriverId>0</DriverId>
		<Longitude>31.06608</Longitude>
		<Latitude>-29.73536</Latitude>
		<Speed>1</Speed>
		<Heading>256</Heading>
		<Altitude>148</Altitude>
		<Hdop>5</Hdop>
		<Satellites>4</Satellites>
		<Age>1068</Age>
	</StartPosition>
	<EndTimestamp UtcOffset="0">2012-04-18T07:21:44Z</EndTimestamp>
	<EndPosition SystemType="FM" VehicleId="712">
		<DeviceTimestamp UtcOffset="0">2012-04-18T05:40:45Z</DeviceTimestamp>
		<DriverId>0</DriverId>
		<Longitude>31.01142</Longitude>
		<Latitude>-29.83128</Latitude>
		<Speed>0</Speed>
		<Heading>0</Heading>
		<Altitude>94</Altitude>
		<Hdop>1</Hdop>
		<Satellites>10</Satellites>
		<Age>0</Age>
	</EndPosition>
	<Distance>14.9</Distance>
	<EndOdometer>4892.2</EndOdometer>
	<MaxSpeed>96</MaxSpeed>
</SubTrip>