Location

This event allow to track the position of the vehicle. The frequency at which it is triggered is variable (depending on the IoT model), from 10 to 15 minutes when the vehicle is idle and every minutes when the vehicle is moving.

Body parameters

• event: location
• vehicle (integer): The identifier of the vehicle.
• data: (json object).
  • status (string): valid when the location is determined, invalid otherwise.
  • latitude (number, optional): The latitude of the vehicle, -90 to 90.
  • longitude (number, optional): The longitude of the vehicle, -180 to 180.
  • time (integer): The time (milliseconds since epoch) of this location.
  • accuracy (number, optional): The HDOP of the gps when the location was computed. HDOP as defined in NMEA0183. The range of the value is 0 – 50. The smaller the value is, the higher the precision will be.
  • altitude (number, optional): The altitude from the sea level in meters.

Body example

{
    "event": "location",
    "vehicle": 156,
    "data": {
        "status": "invalid",
        "time": 1607082857353
    }
}

{
    "event": "status",
    "vehicle": 156,
    "data": {
        "status": "valid",
        "latitude:": 48.542733,
        "longitude": 7.787755,
        "time": 1607082857353,
        "accuracy": 1.1,
        "altitude": 444
    }
}