Adopt traffic participant role specification

.github/spelling_custom_words_en_US.txt

@@ -250,6 +250,7 @@ OSI's
 osmp
 Ouml
 ouml
+oversized
 parametrization
 parametrize
 Parkausweis
@@ -259,6 +260,7 @@ Parkschein
 Parkstände
 Paulat
 pdf
+perceivably
 png
 Polizeikontrolle
 polyline

osi_object.proto

@@ -1250,6 +1250,10 @@ message MovingObject
         //
         enum Role
         {
+            // Allow aliases in enum
+            //
+            option allow_alias = true;
+
             // Role of vehicle is unknown (must not be used in ground truth).
             //
             ROLE_UNKNOWN = 0;
@@ -1258,41 +1262,109 @@ message MovingObject
             //
             ROLE_OTHER = 1;
 
-            // The vehicle role is civil, e.g. a "normal" car.
+            // Traffic participant that can be perceived as regular civilian and
+            // does not perceivably indicate any other role.
             //
             ROLE_CIVIL = 2;
 
-            // The vehicle role is ambulance.
+            // Traffic participant that can be perceived as belonging to a
+            // medical emergency service.
             //
             ROLE_AMBULANCE = 3;
 
+            // Traffic participant that can be perceived as belonging to the
+            // fire brigade.
+            //
+            ROLE_FIRE_BRIGADE = 4;
+
             // The vehicle role is fire fighting, e.g. fire engine.
             //
+            // \note Deprecated differentiation, use ROLE_FIRE_BRIGADE instead
+            //
             ROLE_FIRE = 4;
 
-            // The vehicle role is police.
+            // Traffic participant that can be perceived as belonging to a law
+            // enforcement agency.
             //
             ROLE_POLICE = 5;
 
-            // The vehicle role is public transport, e.g. a school bus.
+            // Traffic participant that can be perceived as a form of mass
+            // passenger transportation mode (e.g. public transport bus, rental
+            // passenger bus, tram) or clearly recognizable passenger
+            // transportation mode (e.g. taxi).
+            //
+            // \note Should not be used for HOV (high-occupancy vehicle) lane
+            // access: No indication of occupation state.
             //
             ROLE_PUBLIC_TRANSPORT = 6;
 
+            // Traffic participant that can be perceived as belonging to a
+            // roadside/breakdown assistance service, e.g. towing vehicle.
+            //
+            ROLE_ROADSIDE_ASSISTANCE = 7;
+
             // The vehicle role is roadside assistance, e.g. tow truck.
             //
+            // \note Deprecated differentiation, use ROLE_ROADSIDE_ASSISTANCE
+            // instead
+            //
             ROLE_ROAD_ASSISTANCE = 7;
 
-            // The vehicle role is garbage collection, e.g. a garbage truck or sweeper.
+            // Traffic participant that can be perceived as belonging to a
+            // garbage collection service.
             //
             ROLE_GARBAGE_COLLECTION = 8;
 
-            // The vehicle role is road construction, e.g. a excavator or tipper truck.
+            // Traffic participant that can be perceived as construction
+            // vehicle/construction worker (e.g. road construction, rail
+            // construction).
+            //
+            ROLE_CONSTRUCTION = 9;
+
+            // The vehicle role is road construction, e.g. a excavator or tipper
+            // truck.
+            //
+            // \note Deprecated differentiation, use ROLE_CONSTRUCTION instead
             //
             ROLE_ROAD_CONSTRUCTION = 9;
 
-            // The vehicle role is military, e.g. camouflaged truck.
+            // Traffic participant that can be perceived as belonging to a
+            // military force.
             //
             ROLE_MILITARY = 10;
+
+            // Traffic participant that can be perceived as freight transport,
+            // e.g. freight truck, delivery van, delivery bike, postman.
+            //
+            ROLE_FREIGHT_TRANSPORT = 11;
+
+            // Traffic participant that can be perceived as part of special
+            // transport (e.g. heavy or oversized load).
+            //
+            // \note The transport vehicle may be accompanied by support
+            // vehicles which can be assigned to the role Traffic Control.
+            //
+            ROLE_SPECIAL_TRANSPORT = 12;
+
+            // Traffic participant that can be perceived as part of dangerous
+            // goods/hazardous materials transport.
+            //
+            // \note The transport vehicle may be accompanied by support
+            // vehicles which can be assigned to the role Traffic Control.
+            //
+            ROLE_DANGEROUS_GOODS_TRANSPORT = 13;
+
+            // Traffic participant that can be perceived as agricultural
+            // machinery.
+            //
+            ROLE_AGRICULTURE = 14;
+
+            // Traffic participant that can be perceived as an obligated traffic
+            // control unit (e.g. railroad flagman, person responsible for
+            // traffic control at construction site, support vehicle for
+            // dangerous goods transport).
+            //
+            ROLE_TRAFFIC_CONTROL = 15;
         }
     }