Shocks v1

The shocks endpoint retreives all the relevant telematic data from a shock event for a given location using the location_id parameter.

Introduction

/locations/{location_id}/shocks/v1

Definition

A shock event is sent from a piece of equipment which experiences a sharp force from hitting another object or a bump on the ground, for example. The intensity is recorded in two dimentions, as well as the consequence which indicates if the truck can continue driving, has enabled “turtle mode” or in severe cases, has automatically shut down. The transponder_id is defined as gdpr related data, only users that are allowed to see personal data will get this information for a shock. An empty transponder_id indicates that the shock happened outside an operation.

Example entity

{
  "equipment_number": "FA324589",
  "equipment_id": "9f0314ce61a169af6eb8e972babee65c3a0f8f27a2904527ea7265bd9bb06de7",
  "shock": {
    "consequence": 1,
    "impact_level": 1,
    "timestamp": "2020-01-02T09:08:07.000Z",
    "intensity": {
      "horizontal": 7.8,
      "vertical": 0.6
    },
    "transponder_id": "12345678"
  }
}

Frequency

Shock data is sent by the truck so the data up-to-dateness is dependent on the connection of the truck. If a shock is sent it usually takes only a few seconds to appear in the endpoint.

Reference Docs