IRIS

Intelligent Roadway Information System


Weather Sensors

Weather sensors can collect data such as precipitation rate, road surface temperature, wind speed, etc. The NTCIP and Org-815 protocols can collect this data.

API Resources 🕵️
  • iris/rwis (see below)
  • iris/api/weather_sensor (primary)
  • iris/api/weather_sensor/{name}
Access Primary Secondary
👁️ View name, location geo_loc, settings, sample, sample_time
💡 Manage site_id, alt_id, notes device_request †
🔧 Configure controller pin

Write only

Public JSON Data

The iris/rwis endpoint produces a JSON document containing an array of all weather sensor objects.

Key Value
name Weather sensor name
location Location description
lat Latitude of sensor
lon Longitude of sensor
settings Settings object
sample Observation sample object
sample_time Time stamp of observation

Settings

This object contains sensor settings and configuration.

Key Value
reference_elevation Reference elevation above mean sea level (meters)
pressure_sensor_height Height relative to reference_elevation (meters)
wind_sensor Array of wind sensor settings objects
height Height relative to reference_elevation (meters)
temperature_sensor Array of temperature sensor settings objects
height Height relative to reference_elevation (meters)
pavement_sensor Array of pavement sensor settings objects
location Sensor location description
pavement_type Pavement type description
height Pavement height relative to reference_elevation (meters)
exposure Rough estimate of solar energy (percent)
sensor_type Sensor type description
sub_surface_sensor Array of sub-surface settings objects
location Sensor location description
sub_surface_type Sub-surface type description
depth Depth below pavement surface (meters)

Sample

This object contains all collected observation data from the most recent polling period. The wind_sensor, temperature_sensor, pavement_sensor and sub_surface_sensor arrays match the order from the settings object.

Key Value
atmospheric_pressure Atmospheric pressure (pascals)
visibility Visibility (meters)
visibility_situation Visibility situation description
wind_sensor Array of wind sensor observations
avg_speed Two minute average wind speed (m/s)
avg_direction Two minute average wind direction †
spot_speed Spot wind speed (m/s)
spot_direction Spot wind direction †
gust_speed Ten minute maximum wind gust speed (m/s)
gust_direction Ten minute maximum wind gust direction †
situation Wind situation description
temperature_sensor Array of temperature sensor observations
air_temp Instantaneous air temperature (℃)
wet_bulb_temp Instantaneous wet-bulb temperature (℃)
dew_point_temp Instantaneous dew point temperature (℃)
max_air_temp Maximum 24 hour air temperature (℃)
min_air_temp Minimum 24 hour air temperature (℃)
relative_humidity Relative humidity (percent)
precip_rate Precipitation rate (mm/hr)
precip_1_hour One hour accumulated precipitation (mm)
precip_3_hours Three hour accumulated precipitation (mm)
precip_6_hours Six hour accumulated precipitation (mm)
precip_12_hours Twelve hour accumulated precipitation (mm)
precip_24_hours Twenty-four hour accumulated precipitation (mm)
precip_situation Precipitation situation description
pavement_sensor Array of pavement sensor observations
surface_status Surface status description
surface_temp Surface temperature (℃)
pavement_temp Pavement temperature (℃)
sensor_error Sensor error description
ice_or_water_depth Surface ice or water depth (meters)
salinity Salinity (ppm by weight)
freeze_point Surface freeze point (℃)
black_ice_signal Black ice signal description
friction Coefficient of friction (percent)
sub_surface_sensor Array of sub-surface observations
temp Sub-surface temperature (℃)
moisture Sub-surface moisture saturation (percent)
sensor_error Sensor error description
total_sun Sun during previous day (minutes; 0-1440)
cloud_situation Cloud situation description
solar_radiation Solar radiation (joules / m²) deprecated
instantaneous_terrestrial_radiation Terrestrial radiation (watts / m²)
instantaneous_solar_radiation Solar radiation (watts / m²)
total_radiation Total from collection period (watts / m²)
total_radiation_period Total radiation period (seconds)

Wind direction in degrees clockwise from due north.