# Schema Structure

## General Information

|               | type                   | String; "FeatureCollection" | Yes                 | The GeoJSON object type. For WZDx, this must be the string FeatureCollection.                                                                     |
| ------------- | ---------------------- | --------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Feed Info** | update\_date           | String                      | <p>Yes </p><p> </p> | The UTC date and time when the GeoJSON file (representing the instance of the feed) was generated.                                                |
|               | publisher              | <p>String </p><p> </p>      | Yes                 | The organization responsible for publishing the feed.                                                                                             |
|               | contact\_name          | <p>String</p><p> </p>       | <p>Yes</p><p> </p>  | <p>The name of the individual or group responsible for the data feed. </p><p> </p>                                                                |
|               | contact\_email         | <p>String</p><p> </p>       | Yes                 | The email address of the individual or group responsible for the data feed                                                                        |
|               | <p>version</p><p> </p> | String                      | Yes                 | The WZDx format version – 4.2                                                                                                                     |
|               | <p>license</p><p> </p> | 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/>". |
|               | data\_source\_id       |                             |                     |                                                                                                                                                   |
|               | organization\_name     |                             |                     |                                                                                                                                                   |

## Specific Work Zone Information

<table data-header-hidden><thead><tr><th width="163">Object</th><th>Data Field</th><th>Type</th><th>Mandatory</th><th>Description</th></tr></thead><tbody><tr><td> </td><td></td><td></td><td></td><td></td></tr><tr><td><strong>Geometry</strong> </td><td>Coordinates </td><td> </td><td> </td><td> </td></tr><tr><td></td><td>Type</td><td> Enumerated {LineString, MultiPoint} </td><td>Type of event geometry provided  </td><td>Type of event geometry provided  </td></tr><tr><td> </td><td>ID  </td><td> </td><td> </td><td>The unique Identifier of the work zone  </td></tr><tr><td> </td><td>bbox </td><td> </td><td> </td><td>Information on the coordinate range for this RoadEventFeature. Must be an array of length 2n where n is the number of dimensions represented in the geometry property, with all axes of the most southwesterly point followed by all axes of the more northeasterly point. The axes order of a bbox follows the axes order of the geometry. </td></tr><tr><td><strong>Core details</strong> </td><td>event_type </td><td>Enumerated {work-zone, detour} </td><td>Yes </td><td>The type/classification of road event. </td></tr><tr><td></td><td>data_source_id  </td><td>String</td><td>Yes </td><td>Identifies the data source from which the road event originates. </td></tr><tr><td></td><td>road_names </td><td>Array (string)</td><td>Yes </td><td>A list of publicly known names of the road on which the event occurs. This may include the road number designated by a jurisdiction such as a county, state or interstate (e.g. I-5, VT 133).</td></tr><tr><td></td><td> <a href="https://github.com/usdot-jpo-ode/wzdx/blob/main/spec-content/enumerated-types/Direction.md">direction</a> </td><td></td><td>Yes</td><td>The digitization direction of the road that is impacted by the event. This value is based on the standard naming for US roadways and indicates the direction of the traffic flow regardless of the real heading angle. </td></tr><tr><td></td><td>name</td><td>String </td><td> Optional</td><td>A human-readable name for the road event. </td></tr><tr><td> </td><td>description </td><td>String</td><td>Optional</td><td>Short free text description of road event. </td></tr><tr><td> </td><td>creation_date</td><td> String </td><td></td><td>The UTC time and date when the activity or event was created. </td></tr><tr><td> </td><td> update_date</td><td> </td><td></td><td>The UTC date and time when any information in the RoadEventFeature that the RoadEventCoreDetails applies to was most recently updated or confirmed as up to date. </td></tr><tr><td> </td><td>start_date  </td><td>string </td><td>Yes </td><td><p>The UTC time and date when the event begins. </p><p> </p></td></tr><tr><td> </td><td>end_date </td><td>string </td><td>Yes </td><td>The UTC time and date when the event ends. </td></tr><tr><td> </td><td><p>is_start_date_verified </p><p> </p></td><td>Boolean  </td><td>Optional  </td><td>Indicates if work has been confirmed to have started, such as from a person or field device. </td></tr><tr><td> </td><td>is_end_date_verified </td><td><p>Boolean </p><p> </p></td><td><p>Optional </p><p> </p></td><td>Indicates if work has been confirmed to have ended, such as from a person or field device. </td></tr><tr><td> </td><td>is_start_position_verified </td><td>Boolean </td><td><p>Optional </p><p> </p></td><td>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. </td></tr><tr><td> </td><td>is_end_position_verified </td><td>Boolean </td><td><p>Optional </p><p> </p></td><td>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. </td></tr><tr><td> </td><td><a href="https://github.com/usdot-jpo-ode/wzdx/blob/main/spec-content/enumerated-types/WorkZoneType.md">work_zone_type</a> </td><td>Enumerated {static, moving, planned-moving-area} </td><td>Optional  </td><td>The type of work zone road event, such as if the road event is static or actively moving as part of a moving operation </td></tr><tr><td> </td><td><a href="https://github.com/usdot-jpo-ode/wzdx/blob/main/spec-content/enumerated-types/LocationMethod.md">location_method</a> </td><td><p>Enumerated {channel device method,sign-method, junction-method, other, unknown </p><p> </p><p> </p></td><td>Yes </td><td>The typical method used to locate the beginning and end of a work zone impact area. </td></tr><tr><td></td><td><a href="https://github.com/usdot-jpo-ode/wzdx/blob/main/spec-content/enumerated-types/VehicleImpact.md">vehicle_impact</a> </td><td><p>Enumerated {all-lanes-closed, some-lanes-closed, all-lanes-open, alternating-one-way, some-lanes-closed-merge-left, some-lanes-closed-merge-right, all-lanes-open-shift-left, all-lanes-open-shift-right, some-lanes-closed-split, flagging, temporary-traffic-signal, unknown} </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p></td><td>Yes </td><td>The impact to vehicular lanes along a single road in a single direction. </td></tr><tr><td><p></p><p> <a href="https://github.com/usdot-jpo-ode/wzdx/blob/main/spec-content/objects/Lane.md"><strong>Lane</strong></a> </p></td><td>order </td><td>Positive Integer</td><td>Yes </td><td>The position of a lane in sequence on the roadway. This value is used as an index to indicate the order of all lanes provided for a road event, starting with 1 for the left-most lane. </td></tr><tr><td></td><td><a href="https://github.com/usdot-jpo-ode/wzdx/blob/main/spec-content/enumerated-types/LaneType.md">type</a> </td><td>Enumerated {general, exit-lane, exit-ramp, entrance-lane, entrance-ramp , sidewalk, bike-lane, shoulder, parking, median, two-way-center-turn-lane}  </td><td>Yes</td><td>An indication of the type of lane or shoulder. </td></tr><tr><td></td><td>    <a href="https://github.com/usdot-jpo-ode/wzdx/blob/main/spec-content/enumerated-types/LaneStatus.md">Status</a>  </td><td>Enumerated {open, closed, shift-left, shift-right, merge-left, merge-right, alternating-flow} </td><td>Yes</td><td>Status of the lane for the traveling public. </td></tr><tr><td></td><td>  <a href="https://github.com/usdot-jpo-ode/wzdx/blob/main/spec-content/objects/Restriction.md">restrictions</a> </td><td>Array {type, value, unit}  </td><td>Optional </td><td>A list of zero or more restrictions specific to the lane. </td></tr><tr><td> </td><td>beginning_cross_street </td><td>String  </td><td>Optional </td><td><p>Name or number of the nearest cross street along the roadway where the event begins. </p><p> </p><p> </p></td></tr><tr><td> </td><td>ending_cross_street </td><td>String  </td><td>Optional </td><td><p>Name or number of the nearest cross street along the roadway where the event ends. </p><p> </p><p> </p></td></tr><tr><td> </td><td>beginning_milepost </td><td>Number  </td><td>Optional </td><td><p>The linear distance measured against a milepost marker along a roadway where the event begins. </p><p> </p><p> </p></td></tr><tr><td><strong>Types_of_work</strong> </td><td><a href="https://github.com/usdot-jpo-ode/wzdx/blob/main/spec-content/enumerated-types/WorkTypeName.md">type_name</a> </td><td>Enumerated {maintenance, minor-road-defect-repair, roadside-work, overhead-work, below-road-work, barrier-work, surface-work, painting, roadway-relocation, roadway-creation </td><td>yes </td><td>A high-level text description of the type of work being done. </td></tr><tr><td><p></p><p> </p><p> </p></td><td>is_architectural_change </td><td>Boolean    </td><td>Optional </td><td>A flag indicating whether the type of work will result in an architectural change to the roadway </td></tr><tr><td><strong>worker_presence</strong> </td><td>are_workers_present </td><td><p>Boolean </p><p> </p></td><td>Yes  </td><td>Whether workers are present in the work zone event area. This value should be set in accordance with the definition provided in the definition property if it is provided. </td></tr><tr><td></td><td>definition</td><td><a href="https://github.com/usdot-jpo-ode/wzdx/blob/main/spec-content/enumerated-types/WorkerPresenceDefinition.md">Array</a> {workers-in-work-zone-working, workers-in-work-zone-not-working, mobile-equipment-in-work-zone-moving , mobile-equipment-in-work-zone-not-moving , fixed-equipment-in-work-zone, humans-behind-barrier, humans-in-right-of-way} </td><td><p>Optional </p><p> </p><p> </p></td><td>A list of situations in which workers are considered present in the data provider's jurisdiction. </td></tr><tr><td></td><td> <a href="https://github.com/usdot-jpo-ode/wzdx/blob/main/spec-content/enumerated-types/WorkerPresenceMethod.md">method</a> </td><td>Enumerated {camera-monitoring, arrow-board-present, cones-present, maintenance-vehicle-present, wearables-present, mobile-device-present, check-in-app, check-in-verbal, scheduled   </td><td>Optional  </td><td>Describes the method for how worker presence in a work zone event area is determined. </td></tr><tr><td></td><td>worker_presence_last_confirmed_date </td><td>String </td><td>Optional   </td><td>The UTC date and time at which the presence of workers was last confirmed.</td></tr><tr><td> </td><td>confidence</td><td><a href="https://github.com/usdot-jpo-ode/wzdx/blob/main/spec-content/enumerated-types/WorkerPresenceConfidence.md">Enumerated</a> {low, medium, high} </td><td>Optional</td><td>The data producer’s confidence in the value of are_workers_present. </td></tr></tbody></table>

## &#x20;