Path Events
Path Events
provide additional information along a path, as follows:
- Singular events - for example, a change of vehicle operation mode or information about an electronic stability program event.
- Continuously collected information - for example, velocity or curvature measurements.
The Path Events
list can contain Path Events of different types. Path Events are referencing the Path based on the timestamp of each Path Event. As this timestamp may not exactly match a timestamp in the Path, interpolation is required during processing of the information in the HERE Location Cloud.
Path Events
are optional in the sensor data submission message. A message that contains only a Path has a meaning of its own without actual events. Nevertheless given that the HERE is supposed to collect rich sensor data, it is expected that a number of Path Events are typically included.
A Path Event
is a complex data type, which may contain several mandatory and optional elements. You can configure the vehicles to report the status consistently using the Path Event
elements.
Example:
A vehicle is reporting transmission mode and temperature as part of the VehicleStatus
complex type. The vehicle must report this information at the very beginning of the path initially.
The following situations might occur:
- Transmission mode is changing - the vchicle reports another Path Event that indicates the new transmission mode in the
VehicleStatus
complex type. - Temperature is changing - the vehicle reports another Path Event that indicates the temperature change in the
VehicleStatus
complex type. - If the vehicle reports two Path Events at the exact same timestamp, then the information is merged into one combined Path Event, as long as both events do not have conflicting information.
For an example of a path event structure, see Sample Message.