Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Support representing static Temporary Traffic Control Zone Signs (see MUTCD definition) in the Device Feed #355

Closed
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 44 additions & 0 deletions schemas/4.2/DeviceFeed.json
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,9 @@
{
"$ref": "#/definitions/LocationMarker"
},
{
"$ref": "#/definitions/TemporaryTrafficControlZoneSign"
},
{
"$ref": "#/definitions/TrafficSensor"
}
Expand Down Expand Up @@ -427,6 +430,46 @@
},
"required": ["type"]
},
"TemporaryTrafficControlZoneSign": {
"title": "Temporary Traffic Control Zone Sign",
"description": "A static, non-electronic sign that conveys both general and specific messages by means of words, symbols, and/or arrows (see definition in MUTCD Section 6F.02 General Characteristics of Signs)",
"type": "object",
"allOf": [
{
"properties": {
"core_details": {
"properties": {
"device_type": {
"const": "temporary-traffic-control-zone-sign"
}
},
"required": ["device_type"]
}
},
"required": ["core_details"]
},
{
"properties": {
"core_details": {
"$ref": "#/definitions/FieldDeviceCoreDetails"
},
"mutcd_sign_designation": {
"type": "string",
"description": "The Sign Designation as described in MUTCD Table 6F-1. Temporary Traffic Control Zone Sign and Plaque Sizes"
},
"mutcd_sign_name": {
"type": "string",
"description": "The human-readable name that accompanies the `mutcd_sign_designation` as described in MUTCD Table 6F-1. Temporary Traffic Control Zone Sign and Plaque Sizes"
},
"variable_sign_content": {
"type": "string",
"description": "Additional content on the sign such as a speed, dimension, distance, or direction"
}
},
"required": ["core_details", "mutcd_sign_designation"]
}
]
},
"TrafficSensor": {
"title": "Traffic Sensor Field Device",
"description": "A traffic sensor deployed on a roadway which captures traffic metrics (e.g. speed, volume, occupancy) over a collection interval",
Expand Down Expand Up @@ -574,6 +617,7 @@
"flashing-beacon",
"hybrid-sign",
"location-marker",
"temporary-traffic-control-zone-sign",
"traffic-sensor",
"traffic-signal"
]
Expand Down
1 change: 1 addition & 0 deletions spec-content/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,7 @@ Object | Description
[HybridSign](/spec-content/objects/HybridSign.md) | A hybrid sign that contains static text (e.g. on an alumium sign) along with a single electronic message display, used to provide information to travelers.
[LocationMarker](/spec-content/objects/LocationMarker.md) | Describes any GPS-enabled ITS device that is placed at a point on a roadway to dynamically know the location of something (often the beginning or end of a work zone).
[MarkedLocation](/spec-content/objects/MarkedLocation.md) | Describes a specific location where a [LocationMarker](/spec-content/objects/LocationMarker.md) is placed, such as the start or end of a work zone road event.
[TemporaryTrafficControlZoneSign](/spec-content/objects/TemporaryTrafficControlZoneSign.md) | A static, non-electronic sign that conveys both general and specific messages by means of words, symbols, and/or arrows (see definition in [MUTCD Section 6F.02 General Characteristics of Signs](https://mutcd.fhwa.dot.gov/htm/2009/part6/part6f.htm)).
[TrafficSensor](/spec-content/objects/TrafficSensor.md) | A traffic sensor deployed on a roadway which captures traffic metrics (e.g. speed, volume, occupancy) over a collection interval.
[TrafficSensorLaneData](/spec-content/objects/TrafficSensorLaneData.md) | Data for a single lane within a road event (e.g. [WorkZoneRoadEvent](/spec-content/objects/WorkZoneRoadEvent.md)) measured by a [TrafficSensor](/spec-content/objects/TrafficSensor.md) deployed on the roadway.
[TrafficSignal](/spec-content/objects/TrafficSignal.md) | A temporary traffic signal deployed on a roadway.
Expand Down
1 change: 1 addition & 0 deletions spec-content/enumerated-types/FieldDeviceType.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ Value | Description
`flashing-beacon` | A flashing beacon light of any form, used to indicate caution and capture driver attention. See [FlashingBeacon](/spec-content/objects/FlashingBeacon.md).
`hybrid-sign` | A message sign that contains both static text (e.g. on an aluminium board) along with a variable electronic message sign, used to provide information to travelers. See [HybridSign](/spec-content/objects/HybridSign.md).
`location-marker` | Any GPS-enabled ITS device that is placed at a point on a roadway to mark a location (often the beginning or end of a road event). See [LocationMarker](/spec-content/objects/LocationMarker.md).
`temporary-traffic-control-zone-sign` | A static, non-electronic sign that conveys both general and specific messages by means of words, symbols, and/or arrows (see definition in [MUTCD Section 6F.02 General Characteristics of Signs](https://mutcd.fhwa.dot.gov/htm/2009/part6/part6f.htm)). See [TemporaryTrafficControlZoneSign](/spec-content/objects/TemporaryTrafficControlZoneSign.md).
`traffic-sensor` | A device deployed on a roadway which captures traffic metrics such as speed, volume, or occupancy. See [TrafficSensor](/spec-content/objects/TrafficSensor.md).
`traffic-signal` | A temporary traffic signal deployed on a roadway. See [TrafficSignal](/spec-content/objects/TrafficSignal.md).

Expand Down
1 change: 1 addition & 0 deletions spec-content/objects/FieldDeviceCoreDetails.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,5 +31,6 @@ Property | Object
`core_details` | [FlashingBeacon](/spec-content/objects/FlashingBeacon.md)
`core_details` | [HybridSign](/spec-content/objects/HybridSign.md)
`core_details` | [LocationMarker](/spec-content/objects/LocationMarker.md)
`core_details` | [TemporaryTrafficControlZoneSign](/spec-content/objects/TemporaryTrafficControlZoneSign.md)
`core_details` | [TrafficSensor](/spec-content/objects/TrafficSensor.md)
`core_details` | [TrafficSignal](/spec-content/objects/TrafficSignal.md)
2 changes: 1 addition & 1 deletion spec-content/objects/FieldDeviceFeature.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Name | Type | Description | Conformance | Notes
--- | --- | --- | --- | ---
`id` | String | A unique identifier issued by the data feed provider to identify the field device. It is recommended that this identifier is a Universally Unique IDentifier (UUID) as defined in [RFC 4122](https://datatracker.ietf.org/doc/html/rfc4122) to guarantee uniqueness between feeds and over time. | Required | This is a GeoJSON property.
`type` | String; `"Feature"` | The GeoJSON object type. This MUST be the string `Feature`. | Required | This is a GeoJSON property.
`properties` | One of: [ArrowBoard](/spec-content/objects/ArrowBoard.md), [Camera](/spec-content/objects/Camera.md), [DynamicMessageSign](/spec-content/objects/DynamicMessageSign.md), [FlashingBeacon](/spec-content/objects/FlashingBeacon.md), [HybridSign](/spec-content/objects/HybridSign.md), [LocationMarker](/spec-content/objects/LocationMarker.md), [TrafficSensor](/spec-content/objects/TrafficSensor.md), [TrafficSignal](/spec-content/objects/TrafficSignal.md) | The specific details of the field device. | Required | This is a GeoJSON property.
`properties` | One of: [ArrowBoard](/spec-content/objects/ArrowBoard.md), [Camera](/spec-content/objects/Camera.md), [DynamicMessageSign](/spec-content/objects/DynamicMessageSign.md), [FlashingBeacon](/spec-content/objects/FlashingBeacon.md), [HybridSign](/spec-content/objects/HybridSign.md), [LocationMarker](/spec-content/objects/LocationMarker.md), [TemporaryTrafficControlZoneSign](/spec-content/objects/TemporaryTrafficControlZoneSign.md), [TrafficSensor](/spec-content/objects/TrafficSensor.md), [TrafficSignal](/spec-content/objects/TrafficSignal.md) | The specific details of the field device. | Required | This is a GeoJSON property.
`geometry` | GeoJSON [Geometry](https://tools.ietf.org/html/rfc7946#section-3.1) object with `type` of [Point](https://tools.ietf.org/html/rfc7946#section-3.1.2). | The geometry of the field device, indicating its location. The Geometry object's `type` property MUST be [Point](https://tools.ietf.org/html/rfc7946#section-3.1.2). | Required | This is a GeoJSON property.
`bbox` | GeoJSON [Bounding Box](https://tools.ietf.org/html/rfc7946#section-5) | Information on the coordinate range for this field device. 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`. | Optional | This is a GeoJSON property.

Expand Down
17 changes: 17 additions & 0 deletions spec-content/objects/TemporaryTrafficControlZoneSign.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# TemporaryTrafficControlZoneSign Object
The `TemporaryTrafficControlZoneSign` object describes a [temporary traffic control zone sign, as defined by MUTCD Section 6F.02 General Characteristics of Signs](https://mutcd.fhwa.dot.gov/htm/2009/part6/part6f.htm). A temporary traffic control zone sign is a static, non-electronic sign that conveys both general and specific messages by means of words, symbols, and/or arrows.

The `TemporaryTrafficControlZoneSign` is a type of field device; it has a `core_details` property which contains the [FieldDeviceCoreDetails](/spec-content/objects/FieldDeviceCoreDetails.md) and exists within a [FieldDeviceFeature](/spec-content/objects/FieldDeviceFeature.md).

## Properties
Name | Type | Description | Conformance | Notes
--- | --- | --- | --- | ---
`core_details` | [FieldDeviceCoreDetails](/spec-content/objects/FieldDeviceCoreDetails.md) | The core details of the field device shared by all field devices types, not specific to a temporary traffic control zone sign. | Required | This property appears on all field devices.
`mutcd_sign_designation` | String | The "Sign Designation" as described in [MUTCD Table 6F-1. Temporary Traffic Control Zone Sign and Plaque Sizes](https://mutcd.fhwa.dot.gov/htm/2009/part6/part6f.htm) "Sign Designation" column. | Required |
`mutcd_sign_name` | String | The human-readable name that accompanies the `mutcd_sign_designation` as described in [MUTCD Table 6F-1. Temporary Traffic Control Zone Sign and Plaque Sizes](https://mutcd.fhwa.dot.gov/htm/2009/part6/part6f.htm) "Sign or Plaque" column. | Optional | Values of "XX" in the MUTCD "Sign or Plaque" column should be replaced by the actual value on the sign.
`variable_sign_content` | String | Additional content on the sign such as a speed, dimension, distance, or direction. | Optional | Variable values are often shown in the MUTCD sign name with "XX", such as "Next XX Miles (plaque)" for sign designation `"W7-3aP"`. For example, if `mutcd_sign_designation` is `"W7-3aP"`, `variable_sign_content` of `"5"` would indicate that the sign reads "5 miles.

## Used By
Property | Object
--- | ---
`properties` | [FieldDeviceFeature](/spec-content/objects/FieldDeviceFeature.md)