OHGO Public API

Resources

Documentation

Contact

OHGO Public API / Work Zones

Work Zone Documentation

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. The goal of WZDx is to enable widespread access to up-to-date information about dynamic conditions occurring on roads such as construction events. Currently, many IOOs maintain data on work zone activity. However, a lack of common data standards and convening mechanisms makes it difficult and costly for third parties such as original equipment manufacturers (OEMs) and navigation applications to access and use these data across various jurisdictions. WZDx defines a common language for describing work zone information. This simplifies the design process for producers and the processing logic for consumers and makes work zone data more accessible.

For an example of how to call this resource, see Swagger details.
GET

/api/work-zones/wzdx/4.2

Get all work zone information

WZDX 4.2 Model

The GeoJSON output of a WZDx Work Zone Feed (v4.2)

  • FeedInfo ( FeedInfo ) Describes WZDx feed header information such as metadata, contact information, and data sources
  • Features ( Array[Feature] ) An array of GeoJSON Feature objects which represent WZDx road events
  • Type ( String ) The GeoJSON type

Feed Info Model

Describes WZDx feed header information such as metadata, contact information, and data sources

  • ContactName ( String , optional ) The name of the individual or group responsible for the data feed
  • ContactEmail ( String , optional ) The email address of the individual or group responsible for the data feed
  • DataSources ( Array[DataSource] , optional ) A list of specific data sources for the road event data in the feed
  • License ( String , optional ) The URL of the license that applies to the data in the WZDx feed. This *must* be the string \"https://creativecommons.org/publicdomain/zero/1.0/\"
  • Publisher ( String , optional ) The organization responsible for publishing the feed
  • UpdateFrequency ( Int32 , optional ) The frequency in seconds at which the data feed is updated
  • Version ( String , optional ) The WZDx specification version used to create the data feed, in 'major.minor' format

Data Source Model

  • DataSourceId ( String , optional )
  • OrganizationName ( String , optional )

Road Event Feature Model

Road Event Feature

  • Id ( String ) Road Event Feature unique id
  • Properties ( Properties_4_2 ) Road Event Properties
  • Geometry ( Geometry ) GeoJSON LineString or GeoJSON MultiPoint
  • Type ( String ) The GeoJSON object type; must be 'Feature'

Properties Model

Road Event Properties

  • CoreDetails ( CoreDetails_4_2 ) The core details of an event occurring on a roadway (i.e. a road event) that is shared by all types of road events
  • StartDate ( String ) The UTC date and time (formatted according to RFC 3339, Section 5.6) when the road event begins (e.g. 2020-11-03T19:37:00Z)
  • EndDate ( String ) The UTC date and time (formatted according to RFC 3339, Section 5.6) when the road event ends (e.g. 2020-11-03T19:37:00Z)
  • LocationMethod ( String ) The typical method used to locate the beginning and end of a work zone impact area
  • VehicleImpact ( String ) The impact to vehicular lanes along a single road in a single direction
  • IsStartDateVerified ( Boolean ) Indicates if work has been confirmed to have started, such as from a person or field device
  • IsEndDateVerified ( Boolean ) Indicates if work has been confirmed to have ended, such as from a person or field device
  • IsStartPositionVerified ( Boolean ) Indicates if the start position (first geometric coordinate pair) is based on actual reported data from a GPS-equipped device that measured the location of the start of the work zone.
  • IsEndPositionVerified ( Boolean ) Indicates if the end position (last geometric coordinate pair) is based on actual reported data from a GPS-equipped device that measured the location of the end of the work zone.
  • BeginningAccuracy ( String ) An indication of how a geographical coordinate was defined
  • EndingAccuracy ( String ) An indication of how a geographical coordinate was defined

Geometry Model

GeoJSON LineString or GeoJSON MultiPoint

  • Type ( String ) LineString or Multipoint type
  • Coordinates ( Array[Coordinate] ) Longitude and Latitude map points