Events

Situational events describe what a user is doing. Events are derived from time, location and motion data.
They are available as a timeseries of stationaries and transports with duration.
Is the user in transport? In a car? Or a train? Walking? What route?
Is the user stationary? What store or business is at that location?
Is the location a home or work location?

Stationary Events
When a user is stationary for a few minutes at a certain location, a Stationary Event will be available.
This Stationary Event is enriched with:
The significance of what this place means to the user based on historical data.
Values: home, work, regular, non-regular, poi (point of interest), new.
Place/venue information like name and categories
Basic address information like country, city and city_type
Example
​Lookup the Stationary event in the data model reference.
{
  "type": "Stationary",
  "start": "2017-02-22T08:34:50.785+01:00",
  "end": "2017-02-22T16:24:55.244+01:00",
  "event_id": "6dbc1960-03ef-429a-b6f5-befb7607ae46",
  "latitude": 51.19666,
  "longitude": 4.40816,
  "location": {
    "significance": "work",
    "place": {
      "name": "Sentiance HQ",
      "category_hierarchy": [
        "office",
        "private",
        "company"
      ]
    }
  },
  "address": {
    "country": "België - Belgique - Belgien",
    "city": "Antwerpen",
    "city_type": "city"
  }
}
Transport Events
When a user is not stationary at a location, the user is in transport. For each of these transports a Transport Event will be available.
Additional data derived from sensor data--distance, transport mode, advanced map-matching--is computed to build an accurate trajectory and driving behavior analysis.
Transport Modes can include car, walking, biking, train, bus, tram, flight, etc. (check the full list here).
Depending on SDK configuration, additional features are derived from the sensor data. 
Only available in full SDK configuration:
behavior_scores
behavior_features
behavior_annotations
Example
​Lookup the Transport event in the data model reference.
{
  "type": "Transport",
  "start": "2017-02-19T15:13:00.000+01:00",
  "end": "2017-02-19T17:05:00.000+01:00",
  "event_id": "830a3534edca6c0eb24faa19f0c137dc7877592384409de43a30586643272f65",
  "mode": "car",
  "distance": 158773,
  "waypoints": [
    {
      "type": "Waypoint",
      "latitude": 52.35004,
      "longitude": 4.87475,
      "timestamp": "2017-02-19T15:13:31.968+01:00",
      "accuracy": 25
    },
    ...
  ],
  "trajectory": {
    "type": "TransportTrajectory",
    "encoded": "quo~Hmaw\\ACW{... polyline encoding}",
    "waypoints": [
      {
        "type": "TrajectoryWaypoint",
        "latitude": 52.35049,
        "longitude": 4.87463,
        "timestamp": "2017-02-19T15:13:29.967+01:00",
        "road_type": "tertiary",
        "speed": 0,
        "distance": 1.4,
        "speed_limit": 50
      },
      ...
    ]
  },
  "behavior_scores": {
    "type": "CarBehaviorScores",
    "overall": 0.67,
    "smooth": 0.91,
    "legal": 0.79,
    "anticipative": 0.3
  },
  "behavior_annotations": [
    {
      "type": "AccelerationBehaviorAnnotation",
      "start": "2017-02-19T15:43:32.161+01:00",
      "end": "2017-02-19T15:43:38.851+01:00",
      "duration": 6690,
      "acceleration": "accelerate",
      "magnitude": 0.096
    },
    {
      "type": "AccelerationBehaviorAnnotation",
      "start": "2017-02-19T15:50:42.146+01:00",
      "end": "2017-02-19T15:50:55.042+01:00",
      "duration": 12897,
      "acceleration": "brake",
      "magnitude": 0.261
    },
    ...
  ],
  "behavior_features": {
    "type": "CarBehaviorFeatures",
    "phone_handling": 70000,
    "distance_during_annotations": 27455
  }
}
Important topics - Previous
User linking
Next - Library
Moments
Last updated 2 years ago