FAQ
Important topics
Data Explorer
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 3yr ago
Copy link