XML Help
The following pages have help content: Speeds for all Roads, Destinations, Road Conditions, Alerts, Cameras, Message Signs, Weather Stations, Speed Segment Polylines, Speed Route Polylines and Weather Route Polylines

Speeds XML Help
SegmentId
Unique ID for the Segment
SegmentName Name that describe the segment's location. The first part of the segment name is the Highway Number (3 digits) Direction (1 digit) and Mile-marker (3 digits and start) of the Segment. The next is the common descriptive name.

Segment's are unique, have only 1 direction and do not overlap.
SegmentType Four types exist in cotrip: Highway, Arterial, Frontage and HOV. Currently only Highway and Arterial types are implemented.
RoadName Highway road name
Direction Only 1 per segment. Values include: North, South, East and West
SpeedLimit Segment's have 1 speed limit. If there are physically 2 speed limits on the actual roadway, the segment will use the lower one. For example, if the speed limit changes in the middle of the segment, the system will use the lower one
Length In miles, the length of the segment. This is the actual distance when driven by a calibrated car and not necessarily the difference between the start and end-milemarker of the segment
StartMileMarker Mile-marker at the start of the segment
EndMileMarker Mile-marker at the end of the segment
Status Only enabled segments will be available through this api. The other value is 'disabled' and these segments will not be available.
ExpectedTravelTime The current expected or estimated travel time for the segment. This is determined by the speed algorithm. Please refer to How is Speed Calculated for more details
CalculatedDate The timestamp and date of when this segment data was calculated. This is done every two minutes
AverageSpeed In miles, the expected Average Speed of the segment. This is determined by the speed algorithm. See the link above for more. If there is a '-1' here, then it means we have no data for the segment and hence cannot calculate a speed. We need to get data at least once in 6 minutes to make this calculation. In other words, if we do not get data on a given segment for 6 minutes, its Travel Time, Average Speed etc. will be set to -1 (or no data).
AverageOccupancy In %, the Occupancy for the past 2 minutes on the segment. The occupancy is the amount of time the loop was occupied during the last 2 minutes. Note, on the highway, an occupancy of 30% or greater is considered very congested or stop-n-go traffic. This is calculated by the Speed application.
AverageVolume The number of cars that the loop counted over the past two minutes across all the lanes in that segment. This is done by the speed application as well.
TravelTime Current travel time on the segment
SpeedUnitOfMeasure Measuring unit of speed
AverageTrafficFlow This is a term that we are using to denote the congestion on arterial segments (i.e. city streets). This is represented as a %. A higher number here is better while a smaller one denote more congestion. Refer to the City Congestion section of How is Speed Calculated for more information
TypeTrafficFlowCd The AverageTrafficFlow is translated into a meaning text value that is presented on the map with a color. The values are: 1-4.
TypeTrafficFlowTxt The text value of the above mentioned code. The values are: Wide Open, Slowing, Heavy and Stop-n-go traffic flow.
IsSlowDown Used on our website to display segments that are in a slow down state (see Speed page)

Destinations XML Help
RouteId
Unique ID for the Route. A Route is a destination. It is basically a summation of all the segments in it.
RouteName Name that describe the routes's location. The first part of the name is the Highway Number (3 digits) Direction (1 digit) and Mile-marker (3 digits and start) of the route. The next is the common descriptive name.

Routes can cover more than 1 road. But will have a given direction on each road.
Description The description of the route's location.
Status Only enabled destinations (routes) will be available through this api. The other value is 'disabled' and these routes will not be available.
ExpectedTravelTime This is the summation of all the segment travel times in the route (based on the length of the segment that is in the route). Please refer to How is Speed Calculated for more details
CalculatedDate The timestamp and date of when this data was calculated. This is done every two minutes
AverageSpeed In miles, the average (expected) speed of the route. This is based on the travel times in each of the segments and the total distance traveled. If it is not know this values will be set to -1 (or no data). (For example, if even 1 segment in the entire route doesn't have data, we will set the route's data to -1).
RoadInfo Routes can have more than 1 road associated with them.
RoadName For each road, there will be a road name
DirectionTxt For each road, there will be a direction. Values include: North, South, East and West
DirectionCd The type code in our tables for the direction text
Length In miles, the length of the route. This is the actual distance when driven by a calibrated car

Weather Route Road Condition XML Help
WeatherRouteId Unique ID for the Weather Route. A Weather Route is a section of roadway that CDOT provides a road condition for. It is updated 4 times a day in the winter and once daily in the summer
RouteName The name of the weather route (descriptive, location)
Status Will always be enabled
StartMileMarker The start mile-marker of the weather route (highway)
EndMileMarker Mile-marker at the end of the Weather Route
Length In miles, the length of the Weather Route
CalculatedDate The timestamp and date of when the road condition was last set (most recent)
RoadName A Weather Route can have ONLY 1 Road. This is its Road Name. And Weather Routes do not have a direction
Comment Additional comments added by the operator
RoadConditionCategoryTxt The road condition has a category associated with it. A Weather Route can have more than 1 road condition category associated with it
RoadConditionCategoryCd The type code in our tables for the road condition. See the values listed below.
RouteGroupTxt The name of the group to which weather route belongs
IsHazardousCondition We use this on CoTrip to display the weather route in the Hazardous (aka Active Conditions) driving section. The business logic on our end determines this (such as Blowing Snow, or a combination of conditions)
RoadCondition The road condition that is currently set to the Weather Route. There can be more than 1 road condition associated with a weather route. The values possible are:
No Data 11
Error 10
Dry 9
Scattered Showers 8
Rain 8
Wet 8
Slushy 8
Slide 0
High Wind 7
Poor Visibility 6
Snow 5
Snow Packed 5
Snow Packed Icy Spots 5
Icy 4
Icy Spots 4
Closed 1
Blowing Snow 3

Alert XML Help
Type
The type of Alert. Possible values are: Road Work, Road Closure, Amber Alert, Partial Closure, Seasonal Closure, Restriction, Incident, Response and Adhoc Alert. An Alert can only be of one type.
Title The title of the alert. For example: Planned Closure, Emergency Roadwork.
Headline The short description of the alert. Headline includes highway, location and road name
Description The detailed description of the alert. It includes the work being done or the reason for closure, any alternate route information and the estimated time to clear
Location Description This field provides the detailed description of the location of an alert
Impact The traffic impact of the event. Possible values include: Severe, Moderate, Minimal
Location The latitude and longitude of the start location of the alert
ReportedTime The date and time of when this alert was created in CDOT system
LastUpdateDate The timestamp and date indicating when this alert was last updated in CDOT system
AlertIcon The icon used to display the alert on the map on cotrip.org (url)
ExpectedEndTime Brief information about when the alert is expected to end
Direction The direction of travel associated with the alert. Possible values are North, South, East and West
DirectionType The direction code associated with the alert. Possible values are 1=North, 2=South, 3=East and 4=West
RoadId The unique identifier for a road in CDOT system. For I-70 roadId=32. For I-25 roadId=31
RoadName The name of the road that the alert is on. There can be only 1 road name for a given alert
End Location The latitude and longitude of the end location of the alert
StartMileMarker The mile-marker at the start location of the alert
EndMileMarker The mile-marker at the end location of the alert
IsBothDirectionFlg Indicates that the alert is valid for both direction. The value is true for a bidirectional alert
Images The images that are associated with each alert. There can be multiple images for each alert
Destinations This is the list of CDOT systems for which the alert is intended. Possible values include: 511, CoTrip and Smartphone App
Polyline This is a list of all points used to draw a polyline on the cotrip.org map for the Alert. String format: longitude, latitude, 0 separated by blank space
Alternate Routes This is the list of alternate routes suggested for the alert. Each Alternate Route has a description of the route and the information to draw a polyline to represent the route on the map. Polyline String format is: longitude, latitude, 0 seperated by blank space

Camera XML Help
Location The latitude and longitude of the Camera
CameraId Unique ID for the Camera
CameraType The type of Camera. The values could be: Still, Streaming, Camera Tour. Note: Streaming camera content is not currently available through this API. The system block's this content from being rendered from outside cotrip
Name The name of the Camera (descriptive, location)
Description A more descriptive name for the camera
Status Will always be enabled
IsWeatherStation If this camera is part of a weather station, this will be checked (weather station cameras are of type still)
Source Which Agency this camera belongs to (i.e. CDOT ITS)
Icon An icon representing the camera type that we use on Cotrip
CameraView 1 to many relationship with camera. A camera can have many views (typically, still and camera tour have more than 1 view, while the streaming has only 1)
CameraViewId Unique Id for the CameraView. The CameraId, CameraName, CameraType, ImageSource are repeated in this list table and the CameraId is what relates it to the view
ViewDescription For each view, the description of the direction the camera view is pointing. This is more descriptive than just the direction
Direction The directions associated with this view. The values could be: North, South, East or West. Each Camera View will have 1 value here
ImageLocation The url for the location of the image for the camera view
DisplayOrder We use this in our balloon window to order the view presented
RoadName The road name that the camera is on. There can be only 1 road name for a given alert
LastUpdateDate The timestamp and date of when this device was last updated (when the picture was taken). Typically, we collect images from our still cameras every 20 minutes
CameraDisplayType The type of interface the camera will be displayed at. This field has two values Kiosk and Web

DMS XML Help (Dynamic Message Sign)
Location The latitude and longitude of the device
DeviceId Unique ID for the Device
CommonName
The name of the device. The format is always 3 digit hwy 1 digit direction 3 digit mile-marker space common descritive location name. For example: 025E146 GARDEN OF THE GODS
Status Will always be enabled
EntityId An internal ID for the group / division that owns the sign. For external purposes, please assume that the sign is owned by CDOT
RoadName The road name that the device is on. There can be only 1 road name for a given alert
Direction The direction the device faces. The values could be: North, South, East or West. Can have only 1 value here
MileMarker The milemarker the device is on
LastUpdateDate The timestamp and date of when the device was last updated
Icon An icon representing the device type that we use on Cotrip
DMSId The specific device entity id (in our system we have a relationship between device (generic, all devices) and specific device type entity tables (dms in this case). This is the DMS Id that is unique across DMSes (Dynamic Message Sign)
BlankMessage If the Sign is blank, this will be true
MessageImg An image that is based on the sign's configuration with the current message (this is typically an animated gif image that shows up to 3 pages depending on the actual message)

Weather Station XML Help
Location The latitude and longitude of the weather station
DeviceId Unique ID for the Device
CommonName
The name of the device. The format is always 3 digit hwy 1 digit direction 3 digit mile-marker space common descriptive location name. For example: 025E146 GARDEN OF THE GODS
Status Will always be enabled
EntityId An internal ID for the group / division that owns the sign. For external purposes, please assume that the sign is owned by CDOT
RoadName The road name that the device is on. There can be only 1 road name for a given alert
Direction The direction the device faces. The values could be: North, South, East or West. Can have only 1 value here
MileMarker The milemarker the device is on
LastUpdateDate The timestamp and date of when the device was last updated
Icon An icon representing the device type that we use on Cotrip
WeatherStationId The specific device entity id (in our system we have a relationship between device (generic, all devices) and specific device type entity tables (weather station in this case). This is the Weather Station Id that is unique across Weather Stations
ConfigurationId The Id for this weather station from it's external system. In CDOT ITS case, the weather stations are part of an SSI system and this is the primary key in it
Manufacturer The maker of this weather station. The values include: SSI and Vaisalla
DeviceCollectionDt The timestamp and date of when the device collected the data
SystemCollectionDt The timestamp and date of when the our system collected the information from the device
WeatherInfo For each Weather Station, one weather info section will provide information about the reading from the environment
EssAirTemp Air temperature at the site (F)
EssRelHumidity Percent of moisture in the air. A relative humidity of 0% shows that the air contains no moisture and 100% shows that the air is completely saturated and cannot absorb more moisture
EssDewPointTemp Temperature at which the air becomes saturated as it cools. If the road or runway temperature drops to or below the dew point, moisture may develop on the surface. The form the moisture takes depends on the surface temperature and the amount of chemical present
EssWetBulbTemp The wet bulb temperature is the temperature of a thermometer whose bulb is wrapped in wet muslin. The wetbulb is always in between the temperature and dew point, except at saturation, when all three are equivalent
EssMinTemp The minimum temperature recorded during the 24 hours preceding the observation
EssMaxTemp The maximum temperature recorded during the 24 hours preceding the observation
EssAtmosPressure The force per unit area exerted by the atmosphere, measured in inches of mercury (inHg). This reading is not adjusted for site elevation
EssAvgWindSpeed Average wind speed measured during an evaluation cycle. The time period over which wind gust speed is monitored can vary based on the type and manufacturer of the RWIS site
EssAvgWindDir Average wind direction during an evaluation cycle. Wind direction can be displayed in two formats: cardinal points or degrees. Cardinal format has 8 possible headings. Degree format displays wind direction in values ranging from 1 to 360. This field will have the actual degree range
Direction Cardinal Format Degree Range
North N 338 - 22
Northeast NE 23 - 68
East E 69 - 112
Southeast SE 113 - 158
South S 159 - 202
Southwest SW 203 - 248
West W 249 - 292
Northwest NW 293 - 337
EssMaxWindGustSpeed Maximum wind speed measured during an evaluation cycle. The time period over which wind gust speed is monitored can vary based on the type and manufacturer of the RWIS site
EssMaxWindGustDir See EssAvgWindDir for details
EssVisibility Average distance that you can see, both day and night, computed every three minutes
EssPrecipRate Average precipitation rate computed every minute. Snowfall is converted to water equivalent and the rate represents the rate of liquid equivalent
EssPrecipStartDt The time at which the most recent precipitation event began
EssPrecipEndDt The time at which the most recent precipitation event ended
TenMinPrecipAccum Rainfall amount or snowfall liquid equivalent for the previous 10 minute period
EssPrecip1Hr Rainfall amount or snowfall liquid equivalent for the previous 1 hour period
EssPrecip3Hr Rainfall amount or snowfall liquid equivalent for the previous 3 hour period
EssPrecip6Hr Rainfall amount or snowfall liquid equivalent for the previous 6 hour period
EssPrecip12Hr Rainfall amount or snowfall liquid equivalent for the previous 12 hour period
EssPrecip24Hr Rainfall amount or snowfall liquid equivalent for the previous 24 hour period
WindDir See EssAverageWindDir. This field will have the Cardinal format
WindDirIcon url for the location of the arrow that Cotrip uses to display the wind direction
WindGustDir See EssAverageWindDir. This field will have the Cardinal format
WindGustDirIcon Url for the location of the arrow that Cotrip uses to display the wind direction
EssVisibilityTxt The text value of the EssAverageVisibility (for example: Clear)
RwisPrecipStatus Type of precipitation detected by a precipitation sensor, if one is available. Certain types of precipitation sensors can only detect the presence or absence of precipitation and will display Yes or No. Other types of precipitation sensors, such as the Weather Identifier and Visibility Sensor (WIVIS) or Optical Weather Identifier (OWI), can classify the type of precipitation and will report a specific type of precipitation. The WIVIS and OWI precipitation sensors may report Yes at the onset of precipitation until sufficient time has elapsed to classify the precipitation type. The values include: None, Yes, Rain, Snow, Mixed, Upper, Lower, Both, Light, Light Freezing, Freezing Rain, Sleet, Hail, Lens Dirty, No Com, Fault, Initialized, Other, Unidentified, Unknown, Frozen, No Data
RwisPrecipIntensity Intensity of the precipitation as derived from the precipitation rate. The National Weather Service defines the following intensity classes: light, moderate, or heavy. The values include: None, Reserved, Light, Moderate, Heavy, Reserved, Reserved, Initialized, Slight, Other, Unknown, No Data
SurfaceSensorData It is the most recent RWIS surface data collected by a weather station sensor. There can be zero or many sensors for each weather station and hence the corresponding SurfaceSensorData.
WeatherStationSensorId It is the system generated unique identifier for each of the 'weather station sensor' collecting RWIS surface data.
TypeWeatherSensorTxt Identifies the type of sensor at the weather station.
SensorId The external system identifier for the weather station sensor.
SensorName Weather station Sensor name.
DeviceCollectionDt Date and time that surface data were last collected by the RWIS weather station sensor.
RwisSurfaceStatus The status of the surface data collected by the RWIS weather station sensor.
EssSurfaceTemperature Temperature of the pavement sensor roughly 3 mm (1/8 inch) below the surface of the sensor, in degrees Fahrenheit.
EssSubSurfaceTemperature Temperature approximately 43cm (17 inches) below the top of the pavement, in degrees Fahrenheit.
EssSurfaceFreezePoint Freezing point of the moisture on the pavement sensor based upon the specific chemical in use, in degrees Fahrenheit.
ChemicalFactor Relative indication of chemical present in the moisture on the surface. Chemical factor uses a relative scale ranging from 5 to 95 in increments of 5.
ChemicalPercentage Percent of chemical saturation in the moisture.
EssWaterDepth Depth of water layer on the sensor, in inches.
IcePercentage Percent of ice in the moisture.
EssSurfaceConductivity Conductance of the ice/liquid mixture on the pavement.
EssSurfaceSalinity Number of grams of dissolved matter per kilogram of seawater, in parts per 100,000.
EssSurfaceBlackIce NTCIP 1204 value indicating if black ice is detected by the RWIS weather station sensor.
EssPvmtSensorError NTCIP 1204 classification of the type of error at the RWIS weather station pavement sensor.
WeatherStation Camera Please refer to the Camera Device Help. The XML is exactly the same, except the value of the IsWeatherStation is true. The device type will be still camera (click here )

Speed Segment Polylines Help
Id Unique ID for the Segment
Name Name that describe the segment's location. The first part of the segment name is the Highway Number (3 digits) Direction (1 digit) and Mile-marker (3 digits and start) of the Segment. The next is the common descriptive name.

Segment's are unique, have only 1 direction and do not overlap
Points A series of longitude, latitude, and altitude (always 0) points that identify the polyline feature of a speed segment

Speed Route Polylines Help
Id Unique ID for the Route
Name Name that describe the routes's location. The first part of the name is the Highway Number (3 digits) Direction (1 digit) and Mile-marker (3 digits and start) of the route. The next is the common descriptive name.

Routes can cover more than 1 road. But will have a given direction on each road
Points A series of longitude, latitude, and altitude (always 0) points that identify the polyline feature of a speed route.

Weather Route Polylines Help
Id Unique ID for the Weather Route
Name The name of the weather route (descriptive, location)
Points A series of longitude, latitude, and altitude (always 0) points that identify the polyline feature of a weather route

Snowplows XML Help
AVLAssetId Unique ID for the AVL device
AssetDBId Unique ID for the AVL within the Database
ExsId Unique ID of the Snow Plow vehicle to which a given AVL device is associated
DistanceTraveledTxt Distance traveled by Snow Plow in the last hour (to tenth of a mile)
HeadingTxt The direction that the plow is heading
Direction Cardinal Format Degree Range
North N 348.75-11.25
North by North East NNE 11.25-33.75
North East NE 33.75-56.25
East by North East ENE 56.25-78.75
East E 78.75-101.25
East by South East ESE 101.25-123.75
South East SE 123.75-146.25
South by South East SSE 146.25-168.75
South S 168.75-191.25
South by South West SSW 191.25-213.75
South West SW 213.75-236.25
West by South West WSW 236.25-258.75
West W 258.75-281.25
West by North West WNW 281.25-303.75
North West NW 303.75-326.25
North by North West NNW 326.25-378.75
DirectionTxt The direction that the plow is heading
Direction Cardinal Format Degree Range
North N 338 - 22
Northeast NE 23 - 68
East E 69 - 112
Southeast SE 113 - 158
South S 159 - 202
Southwest SW 203 - 248
West W 249 - 292
Northwest NW 293 - 337
IsActiveFlg 0=Not active.
1=Active.
SpeedFlt The speed of the Snow Plow (MPH)
Latitude The latitude of the Snow Plow location
Longitude The longitude of the Snow Plow location
AVLCollectionDt The date and time at which the AVL System last collected information for the Snow Plow
SystemCollectionDt The date and time at which the CTMS/CTIS system last collected information from the AVL System
RoadId The unique ID for the Road on which the Snow Plow was located at the last update
FleetTxt Text string indicating the Fleet of the SnowPlow which includes ExsID and SectionID