Docs /

Sensor Data Ingestion Interface (SDII) Data Specification

Sensor Data Ingestion Interface Data Specification

Vehicle​Meta​Data

Message Summary

message VehicleMetaData

The vehicle meta data provides information about the vehicle that is valid for the entire path. This includes vehicle type information, the vehicle reference point. All absolute positions (longitude / latitude) that are reported to the Sensor Data Ingestion Interface are expected to be at the center of the vehicle. All offsets that are reported are expected to be offsets from this center point of the vehicle. Altitude that is reported to the Interface are expected to be altitude on the ground (not the altitude of the location of the GPS antenna). Instead of providing the altitude on the ground it is possible to report a different altitude with a constant offset. This offset from the ground must be provided through the vehicle meta data.

Include: sdii.v3.3.1.proto

Properties

Field Type Label Description
vehicle​Type​Generic Vehicle​Type​Generic​Enum optional

The generic vehicle type is an enumeration used to provide information what type of vehicle the sensor data produced.

vehicle​Specific​Meta​Data Key​Value​Pair​String repeated

Some of the data submitted may be very OEM or vehicle specific. For this purpose a generic mechanism of string key value pairs is included that allows submission of such generic information. Based on information provided through such key value pairs in conjunction with individual OEM agreements different processing assumptions may be made.

vehicle​Reference​Point​Delta​Above​Ground​_​m double optional

The vehicle reference point delta above ground provides the difference between the altitude values and the street level. Altitude values should always be provided at street level and hence this value here should be zero. However in case the altitude is provided at a different level (e.g. at the roof of the vehicle) then this delta value shall provide the distance between the altitude points and the street level. This attribute will be deprecated in a future version and replaced by the addition of a 3D Vector for Reference offset (GNSSPositionReferencePointOffset, and RelativePositionReferencePointOffset)

Unit: Meter [m] | Range: 0..20m | Resolution: 0.01m

curvature​Accuracy​_​1pm double optional

Deprecated

The standard deviation for the curvature. Curvature Accuracy is deprecated in Vehicle Meta Data and will be provided with the Curvature Value within Vehicle Dynamics.

Unit: 1/meter [1/m] | Range: -1..1/m | Resolution: 0.00001/m

slope​Accuracy​_​percent double optional

Deprecated

The standard deviation for the slope. Slope Accuracy is deprecated in Vehicle Meta Data and will be provided with the Slope Value within Vehicle Dynamics.

Unit: Percent [%] | Range: -100..100% | Resolution: 0.01%

vehicle​Length​_​m double optional

The length of the vehicle from most front part to the most rear part (including e.g. bumpers and spoilers).

Unit: Meter [m] | Range: 0..100m | Resolution: 0.001m

vehicle​Width​_​m double optional

The registered width of the vehicle from the most left part to the most right part (including e.g. mirrors).

Unit: Meter [m] | Range: 0..100m | Resolution: 0.001m

vehicle​Height​_​m double optional

The total height of the vehicle from lowest part (surface) to the highest part (e.g. antenna).

Unit: Meter [m] | Range: 0..100 | Resolution: 0.001m

primary​Fuel​Tank​Volume double optional

Fuel tank quantity of the primary tank. The unit is arbitrary depending on the Fuel Type described in attribute primaryFuelType.

Unit: arbitrary upon Fuel Type | Range: 0..1000 | Resolution: 0.01

primary​Fuel​Type Fuel​Type​Enum optional

The type of the primary fuel source.

Fuel tank quantity of the secondary tank. The unit is arbitrary depending on the Fuel Type described in attribute secondaryFuelType.

Unit: arbitrary upon Fuel Type | Range: 0..1000 | Resolution: 0.01

secondary​Fuel​Tank​Volume double optional
secondary​Fuel​Type Fuel​Type​Enum optional

The type of the secondary fuel source.

vehicle​Height​Detail Vehicle​Height​Detail repeated

The list of zero or more hight values of the vehicle

GNSSPosition​Reference​Point​Offset Vector​3D optional

The position of the GNSS reference point (latitude, longitude, altitude) as a relative offset of the vehicles reference point. The vehicle reference point may vary or be defined in a future version. The sum of both vectors GNSSPositionReferencePointOffset and RelativePositionReferencePointOffset describe the offset betwenn the absolute position coordinates and the local sensor coordinates in local vehicle orientation.

Unit: Milimeters [mm] in 3D | Range: -5000..5000mm in 3D | Resolution: 1mm

Relative​Position​Reference​Point​Offset Vector​3D optional

The position of the relative offset reference point from which relative distances are returned within the SDII messages. The position is localized from the vehicle reference point. The vehicle reference point may vary or be defined in a future version. The sum of both vectors GNSSPositionReferencePointOffset and RelativePositionReferencePointOffset describe the offset betwenn the absolute position coordinates and the local sensor coordinates in local vehicle orientation.

Unit: Milimeters [mm] in 3D | Range: -5000..5000mm in 3D | Resolution: 1mm