Position
Represents the position of a vehicle hosted by a MiX Telematics system at a particular point in time.
Fields
SystemType
The type of MiX Telematics system that hosts the position.
VehicleId
The identifier of the vehicle in which the position was generated.
DeviceTimestamp
The date/time at which the position was generated (from the device's clock).
ReceivedTimestamp
The date/time at which the position was received by the MiX Telematics servers.
DriverId
The identifier of the driver who was driving when the position was generated.
CoDriverId
The identifier of the driver who was the co-driver when the position was generated.
IgnitionOn
Indicates whether or not the vehicle's ignition was on when the position was generated.
Odometer
The odometer value of the vehicle when the position was generated.
OdometerUnits
The units for the odometer value.
Longitude
The longitude of the position in decimal degrees.
Latitude
The latitude of the position in decimal degrees.
Location
The location/address of the position.
Speed
The speed of the vehicle when the position was generated.
SpeedUnits
The units for speed value.
Heading
The direction (in degrees) that the vehicle was travelling when the position was generated.
Altitude
The altitude of the device when the position was generated.
AltitudeUnits
The units for the altitude value.
Hdop
The horizontal dilution of precision of the position.
Vdop
The vertical dilution of precision of the position.
Pdop
The averaged dilution of precision of the position.
Satellites
The number of GPS satellites visible to the device when the position was generated.
Age
The time (in minutes) since the device's GPS receiver acquired a position fix.
Note: Fields which are not available will be omitted.
Examples
JSON body:
{"SystemType":"AssetManagement","VehicleId":"ae5992b9-3c71-4005-b6d9-4e7f041a313c","DeviceTimestamp":"\/Date(1318424351000+0000)\/","ReceivedTimestamp":"\/Date(1318424356360+0000)\/","Odometer":0.048,"Longitude":18.84112,"Latitude":-33.97892,"Speed":0,"Heading":355,"Altitude":50,"Hdop":1,"Vdop":2,"Pdop":2,"Satellites":8,"Age":0}
XML body:
<?xml version="1.0"?>
<Position SystemType="AssetManagement" VehicleId="2943efc3-a7a3-4412-965f-067e3891d90c">
<DeviceTimestamp UtcOffset="0">2011-10-12T13:01:30Z</DeviceTimestamp>
<ReceivedTimestamp UtcOffset="0">2011-10-12T13:01:02.463Z</ReceivedTimestamp>
<Odometer>0</Odometer>
<Longitude>18.8410149</Longitude>
<Latitude>-33.9791451</Latitude>
<Speed>0</Speed>
<Heading>0</Heading>
<Altitude>134</Altitude>
<Hdop>1</Hdop>
<Vdop>1</Vdop>
<Pdop>1</Pdop>
<Satellites>8</Satellites>
<Age>0</Age>
</Position>
