New Property: Add event_cause to RestrictionRoadEvent

[DeraldDudley]

Summary

Add an optional event_cause property to the RestrictionRoadEvent object

Motivation

Adding the event_cause property to the RestrictionRoadEvent object lets data publishers tell drivers why road access has been detoured, restricted, or closed. Further, implementing this property adds value to road event feeds by reducing driver uncertainty.

Description

The event_cause property emulates the cause element found in the eventDescription property described in section 3.3.8.14 of the Transportation Management Data Dictionary 3.1 (TMDD). The event_cause property will be populated using the Disasters, Special Events, and Winds enumerations described in sections 3.6.5.8, 3.6.5.23, 3.6.5.37 respectively.

Disasters Enumeration: flash flood, major flood, reservoir failure, levee failure, tsunami, tidal wave, volcanic eruption, ash fall, lava flow, serious fire, forest fire, wildfire, building fire, brush fire, grass fire, fire danger extreme, fire danger very high, fire danger high, fire danger medium, fire danger low, earthquake damage, air crash, rail crash, toxic release, toxic leak, radioactive release, radiation hazard, reactor leakage, explosion, major hazardous materials fire.

Special Events Enumeration: major event, airshow, hot air ballooning, concert, state occasion, VIP visit, show, festival, exhibition, performing arts, outdoor market, fair, carnival, fireworks display, trade expo, movie filming, presidential visit, parade, procession, funeral procession, crowd, holiday traffic crowds, event ended

Winds Enumeration: tornado, hurricane, hurricane force winds, tropical storm, gale force winds, storm force winds, strong winds, moderate winds, light winds, calm, gusty winds, crosswinds, windy, strong winds have eased, strong wind forecast withdrawn.

Proposed change

After

Name	Type	Description	Conformance	Notes
core_details	RoadEventCoreDetails	Describes the basic characterisitics of a road event.	Required
restrictions	Array; [Restriction]	A list of zero or more road restrictions that apply to the roadway segment described by this road event.	Conditional: required if lanes property is not provided.	Restrictions can also be provided on an individual lane.
lanes	Array; [Lane]	A list of individual lanes within a road event (roadway segment).	Conditional: required if restrictions property is not provided.
event_cause	Disasters Type, Winds Type, Special Events Type	A value, from an enumeration, describing why a restriction is in place.	Optional

Before

Name	Type	Description	Conformance	Notes
core_details	RoadEventCoreDetails	Describes the basic characterisitics of a road event.	Required
restrictions	Array; [Restriction]	A list of zero or more road restrictions that apply to the roadway segment described by this road event.	Conditional: required if lanes property is not provided.	Restrictions can also be provided on an individual lane.
lanes	Array; [Lane]	A list of individual lanes within a road event (roadway segment).	Conditional: required if restrictions property is not provided.

[jewel1965]

Incident cause enumeration.xlsx
I have attached a file that includes various causes for roadway incidents we have been using in the 511 SF Bay system. Hopefully, this will be useful.

[DeraldDudley]

The extension committee intends to rescind this issue because it will be covered in Issue #13.