search

usdot-jpo-ode / wzdx

The Work Zone Data Exchange (WZDx) Specification aims to make harmonized work zone data provided by infrastructure owners and operators (IOOs) available for third party use, making travel on public roads safer and more efficient through ubiquitous access to data on work zone activity.
Creative Commons Zero v1.0 Universal
89 stars 62 forks source link

Enable road restriction feeds #205

Closed DeraldDudley closed 2 years ago

DeraldDudley commented 3 years ago

Enable road restriction feeds; add RestrictionRoadEvent and RoadRestrictionFeed

Contingent on Pull Request #209 and #198.

The RestrictionRoadEvent enables the publication of road restriction feeds (see RoadRestrictionFeed). Restriction feeds inform drivers of hazardous restrictions such as low clearances, narrow widths, weight limits, and more.

New Objects

Object Description
RestrictionRoadEvent A road event describing a section of roadway and the limitations of how that section can be used.
RoadRestrictionFeed The root (highest-level) object of a Road Restriction Feed GeoJSON document.

RestrictionRoadEvent Object

The RestrictionRoadEvent object describes one or more restrictions on a section of a roadway. It describes the location of the road section and the limitations on how it can be used. The RestrictionRoadEvent is a linear road event intended to represent persistent restrictions without a defined start or event date, such as bridge clearances.

The RestrictionRoadEvent is a type of road event; it has a core_details property which contains the RoadEventCoreDetails and exists within a RoadEventFeature.

For representing restrictions due to road work, see the WorkZoneRoadEvent and WZDxFeed.

Properties

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.

Used By

Property Object
properties RoadEventFeature

WZDx Feeds

Feed Name Description Producer Consumer Uses Content
WZDxFeed (existing) Provides information about events ocurring on roadways (called "road events") such as work zones that impact the characteristics of the roadway and involve a change the roadway from the default state (e.g. a lane closure). The WZDxFeed is the original work zone data exchange feed, focused on describing high-level information about road work. Agencies responsible for managing roadways and road work, typically state and local DOTs. Traveling public via third parties such as mapping companies and CAVs. Route planning; increased awareness; "put work zones on the map" Work zone and detour road events (see RoadEventFeature).
SwzDeviceFeed (see #208) Provides information (location, status, live data) about field devices deployed on the roadway in work zones. Smart work zone equipment manufacturers or vendors. Agencies responsible for managing roadways and permitting work, typically state and local DOTs who are often interested in producing a WZDxFeed. Third-parties such as mapping companies and CAVs may also be interested in field device information. Simplifies design process for agencies wanting to interface with equipment manufacturers; aids in dynamically generating a WZDx feed with accurate information; reduces effort for manufacturers to conform to different agencies requirements. Field devices.
RoadRestrictionFeed (new) Locates and describes portions of a road that have restrictions. Restriction types described by this specification are listed in the RestrictionType enumerated type. Transportation Authorities like Tribal, Local, State, or Federal Agencies. Traveling public via third parties such as mapping companies and CAVs. Increased awareness; Route planning; Driver, Passenger, and Road-User Safety; Increased Efficiency; Reduced Damage to Infrastructure. Restriction road events (see RoadEventFeature and RestrictionRoadEvent).

Notes about this PR

This PR is a draft as it cannot be implemented unless #209 and #198 are approved. It contains a JSON schema for the new RoadRestrictionFeed and fully complete markdown documentation for the new objects, but does not update example files nor the object diagram. It targets the source branch of #209 (usdot-jpo-ode:refactor-road-event). The source branch for #198 (DeraldDudley:v4.0-release-restrictions) is merged into the source branch here (DeraldDudley:RestrictionEvent), so some of the changes proposed here are from the restriction change. Thus the files changed shows more than just the "new" changes for the RoadRestrictionfeed and RestrictionRoadEvent.

@j-d-b edit: updated to match the finalized implementation.

j-d-b commented 2 years ago

This was auto-closed because the target branch was deleted—fixed and reopened.