Search…
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

1
{
2
"type": "Stationary",
3
"start": "2017-02-22T08:34:50.785+01:00",
4
"end": "2017-02-22T16:24:55.244+01:00",
5
"event_id": "6dbc1960-03ef-429a-b6f5-befb7607ae46",
6
"latitude": 51.19666,
7
"longitude": 4.40816,
8
"location": {
9
"significance": "work",
10
"place": {
11
"name": "Sentiance HQ",
12
"category_hierarchy": [
13
"office",
14
"private",
15
"company"
16
]
17
}
18
},
19
"address": {
20
"country": "België - Belgique - Belgien",
21
"city": "Antwerpen",
22
"city_type": "city"
23
}
24
}
Copied!

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

1
{
2
"type": "Transport",
3
"start": "2017-02-19T15:13:00.000+01:00",
4
"end": "2017-02-19T17:05:00.000+01:00",
5
"event_id": "830a3534edca6c0eb24faa19f0c137dc7877592384409de43a30586643272f65",
6
"mode": "car",
7
"distance": 158773,
8
"waypoints": [
9
{
10
"type": "Waypoint",
11
"latitude": 52.35004,
12
"longitude": 4.87475,
13
"timestamp": "2017-02-19T15:13:31.968+01:00",
14
"accuracy": 25
15
},
16
...
17
],
18
"trajectory": {
19
"type": "TransportTrajectory",
20
"encoded": "quo~Hmaw\\ACW{... polyline encoding}",
21
"waypoints": [
22
{
23
"type": "TrajectoryWaypoint",
24
"latitude": 52.35049,
25
"longitude": 4.87463,
26
"timestamp": "2017-02-19T15:13:29.967+01:00",
27
"road_type": "tertiary",
28
"speed": 0,
29
"distance": 1.4,
30
"speed_limit": 50
31
},
32
...
33
]
34
},
35
"behavior_scores": {
36
"type": "CarBehaviorScores",
37
"overall": 0.67,
38
"smooth": 0.91,
39
"legal": 0.79,
40
"anticipative": 0.3
41
},
42
"behavior_annotations": [
43
{
44
"type": "AccelerationBehaviorAnnotation",
45
"start": "2017-02-19T15:43:32.161+01:00",
46
"end": "2017-02-19T15:43:38.851+01:00",
47
"duration": 6690,
48
"acceleration": "accelerate",
49
"magnitude": 0.096
50
},
51
{
52
"type": "AccelerationBehaviorAnnotation",
53
"start": "2017-02-19T15:50:42.146+01:00",
54
"end": "2017-02-19T15:50:55.042+01:00",
55
"duration": 12897,
56
"acceleration": "brake",
57
"magnitude": 0.261
58
},
59
...
60
],
61
"behavior_features": {
62
"type": "CarBehaviorFeatures",
63
"phone_handling": 70000,
64
"distance_during_annotations": 27455
65
}
66
}
Copied!
Last modified 2yr ago