Growth

Weather Data APIs

Iteris’ comprehensive weather data solutions combine the vast knowledge and experience of Iteris’ in-house meteorological team. ClearAg’s continuously-updating forecast system leverages the best available data for any location globally.

Current and Forecast Weather

last updated 11/7/18

The following data endpoints provide current (now) and forecast (future) weather conditions for purposes such as providing users with weather information through your company’s applications and delivering current and forecast weather information for your company’s own agronomic models. All of the following endpoints provide data for any location in the world. Please note that daily values represent summaries of conditions spanning midnight to midnight local time for the requested location time zone.

Multiple data center regions are available to meet users’ legal and performance needs. Currently, data centers exist within the United States (ag.us.clearapis.com) and the European Union (ag.eu.clearapis.com). Data resolution and availability vary by region, and each region requires a unique set of credentials. Please contact your account representative for account creation or data coverage information.

Please note that API responses are currently only provided in English.

Iteris requires the use of https when working within the ClearAg APIs.

Additional API information, such as details on supported unit sets and API behavior, is available in the Appendix.

Current Conditions - v1.1

The Current Conditions service provides the latest weather conditions occurring at a specified location.

URL Description

https://ag.us.clearapis.com/v1.1/currentconditions?app_id={string}&app_key={string}
&location={lat, lon coordinates}&unitcode={string}&lang={string}
&icon_resolution={string}&icon_style={string}&icon_version={string}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Users are allowed a maximum of five coordinates,1 formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)]."

unitcode

string

no

Unit conversion set to be used. Default is "us-std." Valid values are "us-std," "si-std," "us-std-precise," and "si-std-precise." Values of "us-std-precise" and "si-std-precise" round output values to six decimal places.

lang

string

no

Language setting. Default is "en-us." Currently, only "en-us" is supported.

icon_resolution

string

no

Icon resolution setting. Default is "128." Valid values are 32, 64, 128, or 256.

icon_style

string

no

Icon style setting. Default is "style1." Currently, only "style1" is supported.

icon_version

string

no

Icon version setting. Default is "v1." Currently, only "v1" is supported.

1 Additional coordinates are not counted against a client’s account.

Response Object (JSON)

The response may vary based on language and unit code selected.

Field Description

air_temp

Current air temperature data.

cloud_cover

Current cloud cover data. Cloud cover refers to the percentage of the sky that is covered by clouds.

cloud_cover_descriptor

Cloud cover descriptor data. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

precipitation_descriptor

Precipitation descriptor data. Precipitation descriptor includes information about precipitation type, probability, and intensity when applicable. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

visibility_obstruction_descriptor

Visibility obstruction descriptor data. Visibility obstruction is the obscuration of one’s line of sight by some meteorological phenomenon. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

weather_descriptor

General weather descriptor data. Weather descriptor contains information about the prevailing weather conditions, which may include cloud cover, precipitation, visibility obstruction, or wind information. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

wind_direction_descriptor

Wind direction descriptor data. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

dew_point

Dew point temperature data. Dew point temperature is defined as the temperature to which the air must be cooled for saturation and condensation to occur.

ice_acc_last_hour

Ice precipitation (e.g., sleet or ice pellets) accumulation data over the course of the previous hour.

liquid_acc_last_hour

Liquid precipitation (e.g., rain, drizzle, freezing rain, or freezing drizzle) accumulation data over the course of the previous hour.

long_wave_radiation

Downwelling longwave radiation flux data. Longwave radiation is the energy emitted from non-solar radiation sources.

msl_pressure

Current mean sea level pressure data.

precip_acc_last_hour

Precipitation accumulation data over the course of the previous hour, representing the liquid-equivalent precipitation total.

relative_humidity

Current relative humidity data. Relative humidity is the ratio of the actual amount of water vapor in the air to the maximum amount that can physically exist at a given air temperature.

short_wave_radiation

Current downwelling shortwave radiation flux data. Shortwave radiation is the high-energy solar radiation that reaches Earth’s surface.

snow_acc_last_hour

Snow (e.g., snow or flurries) accumulation data over the course of the previous hour.

station_pressure

Current station pressure data. Station pressure is the barometric pressure at a specific elevation and is the true barometric pressure at the observing location.

u_wind_speed

"U" wind speed at 10 meters above ground level. Note that "U" wind speed is the east-west-oriented component of the wind. If positive, the "U" wind component is blowing from the west; if negative, it is blowing from the east.

v_wind_speed

"V" wind speed at 10 meters above ground level. Note that "V" wind speed is the north-south-oriented component of the wind. If positive, the "V" wind component is blowing from the south; if negative, it is blowing from the north.

valid_time_end

Specifies the end time (Epoch time) of the period during which the current condition data were collected or created. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

valid_time_start

Specifies the start time (Epoch time) of the period during which the current condition data were collected or created. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

visibility

Current visibility data. Visibility is a measure of the lateral distance one can see before one’s line of sight is obstructed due to weather conditions.

wind_direction

Current wind direction data, measured with respect to true north. A wind direction from true north corresponds to a value of 0 degrees, which increases to 360 degrees with corresponding clockwise shifts in wind direction.

wind_speed

Wind speed at 10 meters above ground level.

Example Request

https://ag.us.clearapis.com/v1.1/currentconditions?app_id=123&app_key=321
&location=47.922759,-97.089954

Example Response

{
    "47.922759,-97.089954":{
        "current_conditions":{
            "air_temp":{
                "unit":"F",
                "value":41.0
            },
            "cloud_cover":{
                "unit":"%",
                "value":100.0
            },
            "descriptors":{
                "cloud_cover_descriptor":{
                    "code":21000,
                    "icon":"https://.../cover_cloudy.png",
                    "text":"Overcast"
                },
                "precipitation_descriptor":{
                    "code":60300,
                    "icon":"https://.../precip_rain.png",
                    "text":"Light Rain"
                },
                "visibility_obstruction_descriptor":{
                    "code":30000,
                    "icon":"https://.../visibility_hazeday.png",
                    "text":"Haze"
                },
                "weather_descriptor":{
                    "code":60300,
                    "icon":"https://.../precip_rain.png",
                    "text":"Light Rain"
                },
                "wind_direction_descriptor":{
                    "code":51500,
                    "icon":"https://.../direction_ssw.png",
                    "text":"South-Southwest"
                }
            },
            "dew_point":{
                "unit":"F",
                "value":41.0
            },
            "ice_acc_last_hour":{
                "unit":"in",
                "value":0.0
            },
            "liquid_acc_last_hour":{
                "unit":"in",
                "value":0.02
            },
            "long_wave_radiation":{
                "unit":"W/m^2",
                "value":307
            },
            "msl_pressure":{
                "unit":"mb",
                "value":1013.0
            },
            "precip_acc_last_hour":{
                "unit":"in",
                "value":0.02
            },
            "relative_humidity":{
                "unit":"%",
                "value":100.0
            },
            "short_wave_radiation":{
                "unit":"W/m^2",
                "value":263.0
            },
            "snow_acc_last_hour":{
                "unit":"in",
                "value":0.0
            },
            "station_pressure":{
                "unit":"mb",
                "value":982.0
            },
            "u_wind_speed":{
                "unit":"mph",
                "value":3.0
            },
            "v_wind_speed":{
                "unit":"mph",
                "value":4.0
            },
            "valid_time_end":1380657600,
            "valid_time_start":1380654000,
            "visibility":{
                "unit":"mi",
                "value":4.0
            },
            "wind_direction":{
                "unit":"degrees",
                "value":216.9
            },
            "wind_speed":{
                "unit":"mph",
                "value":5.0
            }
        }
    }
}

Real-Time Rain Gauge - v1.1

The Real-Time Rain Gauge service provides recent historical precipitation accumulations and radar reflectivity data. Note that this is a "virtual" rain gauge service, whereby accumulations are obtained using radar data (where available), satellite estimates, surface observations, and/or numerical weather analysis and prediction information.

URL Description

https://ag.us.clearapis.com/v1.1/realtime_raingauge?app_id={string}&app_key={string}
&location={lat, lon coordinates}&unitcode={string}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Users are allowed a maximum of five coordinates,1 formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)]."

unitcode

string

no

Unit conversion set to be used. Default is "us-std." Valid values are "us-std," "si-std," "us-std-precise," and "si-std-precise." Values of "us-std-precise" and "si-std-precise" round output values to six decimal places.

1 Additional coordinates are not counted against a client’s account.

Response Object (JSON)

The response may vary based on language and unit code selected. The "hourly_precip" and "radar_refl" fields may contain several entries in the response.

Field Description

precip_acc_0hr

Amount of precipitation that has accumulated since the top of the hour.

precip_acc_12hr

Amount of precipitation accumulating within the past full 12 hours, in addition to precipitation occurring during the current hour.

precip_acc_1hr

Amount of precipitation accumulating within the past full hour, in addition to precipitation occurring during the current hour.

precip_acc_24hr

Amount of precipitation accumulating within the past full 24 hours, in addition to precipitation occurring during the current hour.

precip_acc_6hr

Amount of precipitation accumulating within the past full six hours, in addition to precipitation occurring during the current hour.

precip_acc_hourly

Hourly precipitation data for the past 24 hours.

radar_refl

Five-minute radar reflectivity data for the past two hours. Radar reflectivity is a measure of the amount of power reflected off of hydrometeors and returned to the radar, and increases with increasing precipitation intensity.

Example Request

https://ag.us.clearapis.com/v1.1/realtime_raingauge?app_id=123&app_key=321
&location=47.922759,-97.089954

Example Response

{
    "47.922759,-97.089954":{
        "precip_acc_0hr":{
            "unit":"in",
            "valid_time_end":1402048800,
            "valid_time_start":1402048800,
            "value":0.0
        },
        "precip_acc_12hr":{
            "unit":"in",
            "valid_time_end":1402048800,
            "valid_time_start":1402005600,
            "value":1.0
        },
        "precip_acc_1hr":{
            "unit":"in",
            "valid_time_end":1402048800,
            "valid_time_start":1402045200,
            "value":0.04
        },
        "precip_acc_24hr":{
            "unit":"in",
            "valid_time_end":1402048800,
            "valid_time_start":1401987600,
            "value":1.0
        },
        "precip_acc_6hr":{
            "unit":"in",
            "valid_time_end":1402048800,
            "valid_time_start":1402041600,
            "value":1.0
        },
        "precip_acc_hourly":[
            {
                "unit":"in",
                "valid_time_end":1402048800,
                "valid_time_start":1402045200,
                "value":0.04
            }
        ],
        "radar_refl":[
            {
                "unit":"dBZ",
                "valid_time_end":1402048800,
                "valid_time_start":1402048500,
                "value":20.0
            }
        ]
    }
}

Hourly Forecast - v1.1

The Hourly Forecast endpoint provides 240-hour weather forecasts for a specified location.

URL Description

https://ag.us.clearapis.com/v1.1/forecast/hourly?app_id={string}&app_key={string}
&start={integer}&end={integer}&location={lat, lon coordinates}
&unitcode={string}&lang={string}&icon_resolution={string}&icon_style={string}
&icon_version={string}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

start

integer

yes

Start of time range. Supported ranges are from 0 to 240. Hour 0 represents the current hour.

end

integer

yes

End of time range. Supported ranges are from 0 to 240. (Hours beyond 240 may not be returned.)

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Users are allowed a maximum of five coordinates,1 formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)]."

unitcode

string

no

Unit conversion set to be used. Default is "us-std." Valid values are "us-std," "si-std," "us-std-precise," and "si-std-precise." Values of "us-std-precise" and "si-std-precise" round output values to six decimal places.

lang

string

no

Language setting. Default is "en-us." Currently, only "en-us" is supported.

icon_resolution

string

no

Icon resolution setting. Default is "128." Valid values are 32, 64, 128, or 256.

icon_style

string

no

Icon style setting. Default is "style1." Currently, only "style1" is supported.

icon_version

string

no

Icon version setting. Default is "v1." Currently, only "v1" is supported.

1 Additional coordinates are not counted against a client’s account.

Response Object (JSON)

The response may vary based on language and unit code selected.

Field Description

air_temp

Air temperature data.

cloud_cover

Cloud cover data. Cloud cover refers to the percentage of the sky that is covered by clouds.

conditional_prob_freezing

Conditional probability of freezing precipitation (e.g., freezing rain or freezing drizzle), which indicates the likelihood of receiving freezing precipitation if precipitation were actually to occur. Actual probability of receiving precipitation of any type can be found by multiplying the conditional probability by the probability of receiving precipitation. (E.g., if conditional_prob_freezing = 50% and precip_prob = 60%, the probability of freezing precipitation is 50% times 60%, or 30%.) Conditional probabilities sum to 100%.

conditional_prob_frozen

Conditional probability of frozen precipitation (e.g., snow or flurries).

conditional_prob_liquid

Conditional probability of liquid precipitation (e.g., rain or drizzle).

conditional_prob_refrozen

Conditional probability of refrozen precipitation (e.g., sleet or ice pellets).

delta_t

Delta-T data. Delta-T is the difference between the air temperature and wet-bulb temperature. Note that units are sensitive to unitcode setting.

cloud_cover_descriptor

Cloud cover descriptor data. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

precipitation_descriptor

Precipitation descriptor data. Precipitation descriptor includes information about precipitation type, probability, and intensity when applicable. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

visibility_obstruction_descriptor

Visibility obstruction descriptor data. Visibility obstruction is the obscuration of one’s line of sight by some meteorological phenomenon. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

weather_descriptor

General weather descriptor data. Weather descriptor contains information about the prevailing weather conditions, which may include cloud cover, precipitation, visibility obstruction, or wind information. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

wind_direction_descriptor

Wind direction descriptor data. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

dew_point

Dew point temperature data. Dew point temperature is defined as the temperature to which the air must be cooled for saturation and condensation to occur.

ice_acc_overall

Ice accumulation data (e.g., sleet or ice pellets). This parameter represents the forecast running-total ice accumulation, valid from the start hour through the end hour.

ice_acc_period

Hourly ice accumulation data.

liquid_acc_overall

Liquid accumulation data (e.g., rain, drizzle, freezing rain, or freezing drizzle). This parameter represents the forecast running-total liquid accumulation, valid from the start hour through the end hour.

liquid_acc_period

Hourly liquid accumulation data.

long_wave_radiation

Downwelling longwave radiation flux data. Longwave radiation is the energy emitted from non-solar radiation sources.

precip_acc_overall

Liquid-equivalent precipitation accumulation data. This parameter represents the forecast running-total liquid-equivalent precipitation accumulation, valid from the start hour through the end hour.

precip_acc_period

Hourly liquid-equivalent precipitation accumulation data.

precip_prob

Precipitation probability data. This quantity represents the likelihood of receiving precipitation.

relative_humidity

Relative humidity data. Relative humidity is the ratio of the actual amount of water vapor in the air to the maximum amount that can physically exist at a given air temperature.

short_wave_radiation

Downwelling shortwave radiation flux data. Shortwave radiation is the high-energy solar radiation that reaches Earth’s surface.

snow_acc_overall

Snow accumulation data. This parameter represents the forecast running-total snow accumulation, valid from the start hour through the end hour.

snow_acc_period

Hourly snow accumulation data.

valid_time_end

Valid end time (Epoch time) for the hourly period. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

valid_time_start

Valid start time (Epoch time) for the hourly period. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

visibility

Visibility data. Visibility is a measure of the lateral distance one can see before one’s line of sight is obstructed due to weather conditions. Currently not available for more than the first 72 hours of the forecast.

wind_direction

Wind direction at 10 meters above ground level, measured with respect to true north. A wind direction from true north corresponds to a value of 0 degrees, which increases to 360 degrees with corresponding clockwise shifts in wind direction.

wind_gust

Wind gust at 10 meters above ground level. The wind gust value is reported as "n/a" if the difference between the wind gust and wind speed is less than 5.0 mph. Note that this difference is actually determined in the raw units (m/s) before conversion to specified units.

wind_speed

Wind speed at 10 meters above ground level.

wind_speed_2m

Wind speed at 2 meters above ground level.

Example Request

https://ag.us.clearapis.com/v1.1/forecast/hourly?app_id=123&app_key=321&start=1&end=1
&location=47,-97

Example Response

{
    "47,-97":{
        "1448316000":{
            "air_temp":{
                "unit":"F",
                "value":34.0
            },
            "cloud_cover":{
                "unit":"%",
                "value":76.0
            },
            "conditional_prob_freezing":{
                "unit":"%",
                "value":14.0
            },
            "conditional_prob_frozen":{
                "unit":"%",
                "value":69.0
            },
            "conditional_prob_liquid":{
                "unit":"%",
                "value":13.0
            },
            "conditional_prob_refrozen":{
                "unit":"%",
                "value":4.0
            },
            "delta_t":{
                "unit":"F",
                "value":9.0
            },
            "descriptors":{
                "cloud_cover_descriptor":{
                    "code":20300,
                    "icon":"https://.../cover_partlyclearday.png",
                    "text":"Partly Sunny"
                },
                "precipitation_descriptor":{
                    "code":10500,
                    "icon":"https://.../error_none.png",
                    "text":"None"
                },
                "visibility_obstruction_descriptor":{
                    "code":30000,
                    "icon":"https://.../visibility_hazeday.png",
                    "text":"Haze"
                },
                "weather_descriptor":{
                    "code":30000,
                    "icon":"https://.../visibility_hazeday.png",
                    "text":"Haze"
                },
                "wind_direction_descriptor":{
                    "code":51900,
                    "icon":"https://.../direction_wnw.png",
                    "text":"West-Northwest"
                }
            },
            "dew_point":{
                "unit":"F",
                "value":28.0
            },
            "ice_acc_overall":{
                "unit":"in",
                "value":0.0
            },
            "ice_acc_period":{
                "unit":"in",
                "value":0.0
            },
            "liquid_acc_overall":{
                "unit":"in",
                "value":0.0
            },
            "liquid_acc_period":{
                "unit":"in",
                "value":0.0
            },
            "long_wave_radiation":{
                "unit":"W/m^2",
                "value":277.0
            },
            "precip_acc_overall":{
                "unit":"in",
                "value":0.0
            },
            "precip_acc_period":{
                "unit":"in",
                "value":0.0
            },
            "precip_prob":{
                "unit":"%",
                "value":0.0
            },
            "relative_humidity":{
                "unit":"%",
                "value":78.0
            },
            "short_wave_radiation":{
                "unit":"W/m^2",
                "value":68.0
            },
            "snow_acc_overall":{
                "unit":"in",
                "value":0.0
            },
            "snow_acc_period":{
                "unit":"in",
                "value":0.0
            },
            "valid_time_end":1448319600,
            "valid_time_start":1448316000,
            "visibility":{
                "unit":"mi",
                "value":5.0
            },
            "wind_direction":{
                "unit":"degrees",
                "value":293.0
            },
            "wind_gust":{
                "unit":"n/a",
                "value":"n/a"
            },
            "wind_speed":{
                "unit":"mph",
                "value":4.0
            },
            "wind_speed_2m":{
                "unit":"mph",
                "value":3.0
            }
        }
    }
}

Daily Forecast - v1.1

The Daily Forecast endpoint provides a 10-day weather forecast summary, available for daytime, nighttime, and overall hours. Daytime periods span from 7 a.m. to 6:59 p.m. on a given date, nighttime periods span from 7 p.m. on a given date to 6:59 a.m. on the next date, and overall periods span from midnight to 11:59 p.m., all times valid in the time zone of the location queried.

URL Description

https://ag.us.clearapis.com/v1.1/forecast/daily?app_id={string}&app_key={string}
&start={integer}&end={integer}&location={lat, lon coordinates}
&unitcode={string}&lang={string}&icon_resolution={string}&icon_style={string}
&icon_version={string}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

start

integer

yes

Start of time range. Valid start values range from 0 to 9. Day 0 represents the current day.

end

integer

yes

End of time range. Valid end values range from 0 to 9.

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Users are allowed a maximum of five coordinates,1 formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)]."

unitcode

string

no

Unit conversion set to be used. Default is "us-std." Valid values are "us-std," "si-std," "us-std-precise," and "si-std-precise." Values of "us-std-precise" and "si-std-precise" round output values to six decimal places.

lang

string

no

Language setting. Default is "en-us." Currently, only "en-us" is supported.

icon_resolution

string

no

Icon resolution setting. Default is "128." Valid values are 32, 64, 128, or 256.

icon_style

string

no

Icon style setting. Default is "style1." Currently, only "style1" is supported.

icon_version

string

no

Icon version setting. Default is "v1." Currently, only "v1" is supported.

1 Additional coordinates are not counted against a client’s account.

Response Object (JSON)

The response may vary based on language and unit code selected.

Field Description

air_temp_avg

Average air temperature data.

air_temp_max

Maximum air temperature data.

air_temp_min

Minimum air temperature data.

cloud_cover_avg

Average cloud cover data. Cloud cover refers to the percentage of the sky that is covered by clouds.

cloud_cover_descriptor

Cloud cover descriptor data. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

precipitation_descriptor

Precipitation descriptor data. Precipitation descriptor includes information about precipitation type, probability, and intensity when applicable. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

weather_descriptor

General weather descriptor data. Weather descriptor contains information about the prevailing weather conditions, which may include cloud cover, precipitation, visibility obstruction, or wind information. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

wind_direction_descriptor

Wind direction descriptor data. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

wind_trend_descriptor

Wind trend descriptor data. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

dew_point_avg

Average dew point temperature data. Dew point temperature is defined as the temperature to which the air must be cooled for saturation and condensation to occur.

dew_point_max

Maximum dew point temperature data.

dew_point_min

Minimum dew point temperature data.

ice_acc_period

Amount of ice accumulating during the period (e.g., sleet or ice pellets).

liquid_acc_period

Amount of liquid precipitation accumulating during the period (e.g., rain, drizzle, freezing rain, or freezing drizzle).

long_wave_radiation_avg

Downwelling longwave radiation flux data. Longwave radiation is the energy emitted from non-solar radiation sources.

pet_period

Accumulated reference evapotranspiration data. Reference evapotranspiration is the amount of water that would transpire and evaporate from a hypothetical reference crop, assuming that ample water is available. In this case, short green grass is used as the reference crop.

precip_acc_period

Expected liquid-equivalent precipitation accumulation for a given time period.

precip_prob

Probability of precipitation. This quantity represents the likelihood of receiving precipitation.

relative_humidity_avg

Average relative humidity data. Relative humidity is the ratio of the actual amount of water vapor in the air to the maximum amount that can physically exist at a given air temperature.

relative_humidity_max

Maximum relative humidity data.

relative_humidity_min

Minimum relative humidity data.

short_wave_radiation_avg

Average downwelling shortwave radiation flux data. Shortwave radiation is the high-energy solar radiation that reaches Earth’s surface.

snow_acc_period

Amount of snow accumulating during the period, represented as physical snow depth (not liquid equivalent).

sunshine_duration

Number of hours that the amount of downwelling shortwave radiation flux exceeds 120 W/m^2, which is dictated by the time of day and local weather conditions. Note that hours are not necessarily consecutive.

wind_gust_max

Maximum wind gust at 10 meters above ground level. The wind gust value is reported as "n/a" if the difference between the maximum wind gust and maximum wind speed is less than 5.0 mph. Note that this difference is actually determined in the raw units (m/s) before conversion to specified units.

wind_speed_2m_avg

Average wind speed at 2 meters above ground level.

wind_speed_2m_max

Maximum wind speed at 2 meters above ground level.

wind_speed_2m_min

Minimum wind speed at 2 meters above ground level.

wind_speed_avg

Average wind speed at 10 meters above ground level.

wind_speed_max

Maximum wind speed at 10 meters above ground level.

wind_speed_min

Minimum wind speed at 10 meters above ground level.

Example Request

https://ag.us.clearapis.com/v1.1/forecast/daily?app_id=123&app_key=321&start=0
&end=1&location=47,-97

Example Response

{
    "47,-97":{
        "2016-12-15":{
            "day":{
                "air_temp_max":{
                    "unit":"F",
                    "value":5.0
                },
                "cloud_cover_avg":{
                    "unit":"%",
                    "value":16.3
                },
                "descriptors":{
                    "cloud_cover_descriptor":{
                        "code":21107,
                        "icon":"https://.../cover_partlycloudyday.png",
                        "text":"Increasing Clouds"
                    },
                    "precipitation_descriptor":{
                        "code":10500,
                        "icon":"https://.../error_none.png",
                        "text":"None"
                    },
                    "weather_descriptor":{
                        "code":21107,
                        "icon":"https://.../cover_partlycloudyday.png",
                        "text":"Increasing Clouds"
                    },
                    "wind_direction_descriptor":{
                        "code":51600,
                        "icon":"https://.../direction_sw.png",
                        "text":"Southwest"
                    },
                    "wind_trend_descriptor":{
                        "code":10500,
                        "icon":"https://.../error_none.png",
                        "text":"None"
                    }
                },
                "dew_point_avg":{
                    "unit":"F",
                    "value":-9.0
                },
                "ice_acc_period":{
                    "unit":"in",
                    "value":0.0
                },
                "liquid_acc_period":{
                    "unit":"in",
                    "value":0.0
                },
                "long_wave_radiation_avg":{
                    "unit":"W/m^2",
                    "value":168.0
                },
                "precip_acc_period":{
                    "unit":"in",
                    "value":0.0
                },
                "precip_prob":{
                    "unit":"%",
                    "value":0.0
                },
                "relative_humidity_avg":{
                    "unit":"%",
                    "value":67.0
                },
                "short_wave_radiation_avg":{
                    "unit":"W/m^2",
                    "value":141.0
                },
                "snow_acc_period":{
                    "unit":"in",
                    "value":0.0
                },
                "wind_gust_max":{
                    "unit":"n/a",
                    "value":"n/a"
                },
                "wind_speed_2m_avg":{
                    "unit":"mph",
                    "value":7.0
                },
                "wind_speed_2m_max":{
                    "unit":"mph",
                    "value":8.0
                },
                "wind_speed_2m_min":{
                    "unit":"mph",
                    "value":5.0
                }
                "wind_speed_avg":{
                    "unit":"mph",
                    "value":9.0
                },
                "wind_speed_max":{
                    "unit":"mph",
                    "value":11.0
                },
                "wind_speed_min":{
                    "unit":"mph",
                    "value":6.0
                }
            },
            "night":{
                "air_temp_min":{
                    "unit":"F",
                    "value":1.0
                },
                "cloud_cover_avg":{
                    "unit":"%",
                    "value":85.9
                },
                "descriptors":{
                    "cloud_cover_descriptor":{
                        "code":20400,
                        "icon":"https://.../cover_mostlycloudynight.png",
                        "text":"Mostly Cloudy"
                    },
                    "precipitation_descriptor":{
                        "code":61219,
                        "icon":"https://.../precip_snow.png",
                        "text":"Good Chance of Light Snow"
                    },
                    "weather_descriptor":{
                        "code":61219,
                        "icon":"https://.../precip_snow.png",
                        "text":"Good Chance of Light Snow"
                    },
                    "wind_direction_descriptor":{
                        "code":51500,
                        "icon":"https://.../direction_ssw.png",
                        "text":"South-Southwest"
                    },
                    "wind_trend_descriptor":{
                        "code":52009,
                        "icon":"https://.../direction_nw.png",
                        "text":"Becoming Northwest"
                    }
                },
                "dew_point_avg":{
                    "unit":"F",
                    "value":-3.0
                },
                "ice_acc_period":{
                    "unit":"in",
                    "value":0.0
                },
                "liquid_acc_period":{
                    "unit":"in",
                    "value":0.0
                },
                "long_wave_radiation_avg":{
                    "unit":"W/m^2",
                    "value":229.0
                },
                "precip_acc_period":{
                    "unit":"in",
                    "value":0.01
                },
                "precip_prob":{
                    "unit":"%",
                    "value":50.0
                },
                "relative_humidity_avg":{
                    "unit":"%",
                    "value":74.0
                },
                "short_wave_radiation_avg":{
                    "unit":"W/m^2",
                    "value":0.0
                },
                "snow_acc_period":{
                    "unit":"in",
                    "value":0.3
                },
                "wind_gust_max":{
                    "unit":"n/a",
                    "value":"n/a"
                },
                "wind_speed_2m_avg":{
                    "unit":"mph",
                    "value":5.0
                },
                "wind_speed_2m_max":{
                    "unit":"mph",
                    "value":8.0
                },
                "wind_speed_2m_min":{
                    "unit":"mph",
                    "value":3.0
                },
                "wind_speed_avg":{
                    "unit":"mph",
                    "value":7.0
                },
                "wind_speed_max":{
                    "unit":"mph",
                    "value":10.0
                },
                "wind_speed_min":{
                    "unit":"mph",
                    "value":4.0
                }
            },
            "overall":{
                "air_temp_avg":{
                    "unit":"F",
                    "value":-3.0
                },
                "air_temp_max":{
                    "unit":"F",
                    "value":5.0
                },
                "air_temp_min":{
                    "unit":"F",
                    "value":-11.0
                },
                "cloud_cover_avg":{
                    "unit":"%",
                    "value":26.4
                },
                "descriptors":{
                    "cloud_cover_descriptor":{
                        "code":21107,
                        "icon":"https://.../cover_partlycloudyday.png",
                        "text":"Increasing Clouds"
                    },
                    "precipitation_descriptor":{
                        "code":61113,
                        "icon":"https://.../precip_flurries.png",
                        "text":"Slight Chance of Flurries"
                    },
                    "weather_descriptor":{
                        "code":61113,
                        "icon":"https://.../precip_flurries.png",
                        "text":"Slight Chance of Flurries"
                    },
                    "wind_direction_descriptor":{
                        "code":51600,
                        "icon":"https://.../direction_sw.png",
                        "text":"Southwest"
                    },
                    "wind_trend_descriptor":{
                        "code":10500,
                        "icon":"https://.../error_none.png",
                        "text":"None"
                    }
                },
                "dew_point_avg":{
                    "unit":"F",
                    "value":-11.0
                },
                "dew_point_max":{
                    "unit":"F",
                    "value":-4.0
                },
                "dew_point_min":{
                    "unit":"F",
                    "value":-19.0
                },
                "ice_acc_period":{
                    "unit":"in",
                    "value":0.0
                },
                "liquid_acc_period":{
                    "unit":"in",
                    "value":0.0
                },
                "long_wave_radiation_avg":{
                    "unit":"W/m^2",
                    "value":170.0
                },
                "pet_period":{
                    "unit":"in",
                    "value":0.009
                },
                "precip_acc_period":{
                    "unit":"in",
                    "value":0.001
                },
                "precip_prob":{
                    "unit":"%",
                    "value":10.0
                },
                "relative_humidity_avg":{
                    "unit":"%",
                    "value":68.0
                },
                "relative_humidity_max":{
                    "unit":"%",
                    "value":77.0
                },
                "relative_humidity_min":{
                    "unit":"%",
                    "value":61.0
                },
                "short_wave_radiation_avg":{
                    "unit":"W/m^2",
                    "value":70.0
                },
                "snow_acc_period":{
                    "unit":"in",
                    "value":0.02
                },
                "sunshine_duration":{
                    "unit":"hours",
                    "value":6
                },
                "wind_gust_max":{
                    "unit":"n/a",
                    "value":"n/a"
                },
                "wind_speed_2m_avg":{
                    "unit":"mph",
                    "value":6.0
                },
                "wind_speed_2m_max":{
                    "unit":"mph",
                    "value":8.0
                },
                "wind_speed_2m_min":{
                    "unit":"mph",
                    "value":2.0
                },
                "wind_speed_avg":{
                    "unit":"mph",
                    "value":8.0
                },
                "wind_speed_max":{
                    "unit":"mph",
                    "value":11.0
                },
                "wind_speed_min":{
                    "unit":"mph",
                    "value":3.0
                }
            }
        },...
    }
}

Daily Forecast Air Temperature - v1.2

The Daily Forecast Air Temperature endpoint provides 10-day air temperature forecasts. Data are valid from midnight to 11:59 p.m. in the time zone of the location queried.

URL Description

https://ag.us.clearapis.com/v1.2/forecast/daily/air_temp?app_id={string}
&app_key={string}&start={integer}&end={integer}
&location={lat, lon coordinates}&unitcode={string}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

start

integer

yes

Start of time range. Valid start values range from 0 to 9. Day 0 represents the current day.

end

integer

yes

End of time range. Valid end values range from 0 to 9.

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Users are allowed a maximum of five coordinates,1 formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)]."

unitcode

string

no

Unit conversion set to be used. Default is "us-std." Valid values are "us-std," "si-std," "us-std-precise," and "si-std-precise." Values of "us-std-precise" and "si-std-precise" round output values to six decimal places.

1 Additional coordinates are not counted against a client’s account.

Response Object (JSON)

The response may vary based on language and unit code selected.

Field Description

air_temp_max

Maximum forecasted air temperature.

air_temp_min

Minimum forecasted air temperature.

Example Request

https://ag.us.clearapis.com/v1.2/forecast/daily/air_temp?app_id=123&app_key=321
&location=39,-106&start=0&end=1

Example Response

{
    "39,-106":{
        "2014-10-14":{
            "air_temp_max":{
                "unit":"F",
                "value":65.0
            },
            "air_temp_min":{
                "unit":"F",
                "value":36.0
            }
        },...
    }
}

Daily Forecast Ag Weather - v1.0

The Daily Forecast Ag Weather endpoint provides a 10-day forecast geared toward agricultural applications. Data are valid from midnight to 11:59 p.m. in the time zone of the location queried.

URL Description

https://ag.us.clearapis.com/v1.0/forecast/daily/ag_weather?app_id={string}
&app_key={string}&start={integer}&end={integer}
&location={lat, lon coordinates}&unitcode={string}&lang={string}
&icon_resolution={string}&icon_style={string}&icon_version={string}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

start

integer

yes

Start of time range. Valid start values range from 0 to 9. Day 0 represents the current day.

end

integer

yes

End of time range. Valid end values range from 0 to 9.

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Users are allowed a maximum of five coordinates,1 formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)]."

unitcode

string

no

Unit conversion set to be used. Default is "us-std." Valid values are "us-std," "si-std," "us-std-precise," and "si-std-precise." Values of "us-std-precise" and "si-std-precise" round output values to six decimal places.

lang

string

no

Language setting. Default is "en-us." Currently, only "en-us" is supported.

icon_resolution

string

no

Icon resolution setting. Default is "128." Valid values are 32, 64, 128, or 256.

icon_style

string

no

Icon style setting. Default is "style1." Currently, only "style1" is supported.

icon_version

string

no

Icon version setting. Default is "v1." Currently, only "v1" is supported.

1 Additional coordinates are not counted against a client’s account.

Response Object (JSON)

The response may vary based on language and unit code selected.

Field Description

air_temp_5cm_avg

Average air temperature at five centimeters above ground level.

air_temp_5cm_max

Maximum air temperature at five centimeters above ground level.

air_temp_5cm_min

Minimum air temperature at five centimeters above ground level.

air_temp_avg

Average air temperature at two meters above ground level.

air_temp_max

Maximum air temperature at two meters above ground level.

air_temp_min

Minimum air temperature at two meters above ground level.

cloud_cover_avg

Average cloud cover data. Cloud cover refers to the percentage of the sky that is covered by clouds.

cloud_cover_descriptor

Cloud cover descriptor data. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

precipitation_descriptor

Precipitation descriptor data. Precipitation descriptor includes information about precipitation type, probability, and intensity when applicable. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

weather_descriptor

General weather descriptor data. Weather descriptor contains information about the prevailing weather conditions, which may include cloud cover, precipitation, visibility obstruction, or wind information. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

wind_direction_descriptor

Wind direction descriptor data. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

wind_trend_descriptor

Wind trend descriptor data. Please refer to the Textual Form of Numerical Outputs section of the Appendix for additional information on descriptor codes.

dew_point_avg

Average dew point temperature data. Dew point temperature is defined as the temperature to which the air must be cooled for saturation and condensation to occur.

dew_point_max

Maximum dew point temperature data.

dew_point_min

Minimum dew point temperature data.

ice_acc_period

Amount of ice accumulating during the period (e.g., sleet or ice pellets).

liquid_acc_period

Amount of liquid precipitation accumulating during the period (e.g., rain, drizzle, freezing rain, or freezing drizzle).

long_wave_radiation_avg

Downwelling longwave radiation flux data. Longwave radiation is the energy emitted from non-solar radiation sources.

pet_period

Accumulated reference evapotranspiration data. Reference evapotranspiration is the amount of water that would transpire and evaporate from a hypothetical reference crop, assuming that ample water is available. In this case, short green grass is used as the reference crop.

precip_acc_period

Amount of liquid-equivalent precipitation accumulating during the period.

precip_duration

Number of hours that the amount of liquid-equivalent precipitation exceeds 0.1 mm. Note that hours are not necessarily consecutive.

precip_prob

Probability of precipitation. This quantity represents the likelihood of receiving precipitation.

relative_humidity_avg

Average relative humidity data. Relative humidity is the ratio of the actual amount of water vapor in the air to the maximum amount that can physically exist at a given air temperature.

relative_humidity_max

Maximum relative humidity data.

relative_humidity_min

Minimum relative humidity data.

short_wave_radiation_avg

Average downwelling shortwave radiation flux data. Shortwave radiation is the high-energy solar radiation that reaches Earth’s surface.

snow_acc_period

Amount of snow accumulating during the period, represented as physical snow depth (not liquid equivalent).

sunshine_duration

Number of hours that the amount of downwelling shortwave radiation flux exceeds 120 W/m^2, which is dictated by the time of day and local weather conditions. Note that hours are not necessarily consecutive.

wind_direction

Predominant wind direction in degrees. A wind direction of true north corresponds to a value of 0 degrees, which increases clockwise to 360 degrees.

wind_gust_max

Maximum wind gust at 10 meters above ground level. The wind gust value is reported as "n/a" if the difference between the maximum wind gust and maximum wind speed is less than 5.0 mph. Note that this difference is actually determined in the raw units (m/s) before conversion to specified units.

wind_speed_2m_avg

Average wind speed at two meters above ground level.

wind_speed_2m_max

Maximum wind speed at two meters above ground level.

wind_speed_2m_min

Minimum wind speed at two meters above ground level.

wind_speed_avg

Average wind speed at 10 meters above ground level.

wind_speed_max

Maximum wind speed at 10 meters above ground level.

wind_speed_min

Minimum wind speed at 10 meters above ground level.

Example Request

https://ag.us.clearapis.com/v1.0/forecast/daily/ag_weather?
app_id=123&app_key=321&start=0&end=1&location=47,-97

Example Response

{
    "47,-97":{
        "2017-01-13":{
            "air_temp_5cm_avg":{
                "unit":"F",
                "value":-7.0
            },
            "air_temp_5cm_max":{
                "unit":"F",
                "value":7.0
            },
            "air_temp_5cm_min":{
                "unit":"F",
                "value":-24.0
            },
            "air_temp_avg":{
                "unit":"F",
                "value":-6.0
            },
            "air_temp_max":{
                "unit":"F",
                "value":7.0
            },
            "air_temp_min":{
                "unit":"F",
                "value":-22.0
            },
            "cloud_cover_avg":{
                "unit":"%",
                "value":25.9
            },
            "descriptors":{
                "cloud_cover_descriptor":{
                    "code":21110,
                    "icon":"https://.../cover_partlycloudyday.png",
                    "text":"Variable Clouds"
                },
                "precipitation_descriptor":{
                    "code":61113,
                    "icon":"https://.../precip_flurries.png",
                    "text":"Slight Chance of Flurries"
                },
                "weather_descriptor":{
                    "code":61113,
                    "icon":"https://.../precip_flurries.png",
                    "text":"Slight Chance of Flurries"
                },
                "wind_direction_descriptor":{
                    "code":51309,
                    "icon":"https://.../direction_sse.png",
                    "text":"Becoming South-Southeast"
                },
                "wind_trend_descriptor":{
                    "code":10500,
                    "icon":"https://.../error_none.png",
                    "text":"None"
                }
            },
            "dew_point_avg":{
                "unit":"F",
                "value":-13.0
            },
            "dew_point_max":{
                "unit":"F",
                "value":0.0
            },
            "dew_point_min":{
                "unit":"F",
                "value":-28.0
            },
            "ice_acc_period":{
                "unit":"in",
                "value":0.0
            },
            "liquid_acc_period":{
                "unit":"in",
                "value":0.0
            },
            "long_wave_radiation_avg":{
                "unit":"W/m^2",
                "value":173.0
            },
            "pet_period":{
                "unit":"in",
                "value":0.007
            },
            "precip_acc_period":{
                "unit":"in",
                "value":0.0
            },
            "precip_duration":{
                "unit":"hours",
                "value":0
            },
            "precip_prob":{
                "unit":"%",
                "value":20.0
            },
            "relative_humidity_avg":{
                "unit":"%",
                "value":72.0
            },
            "relative_humidity_max":{
                "unit":"%",
                "value":84.0
            },
            "relative_humidity_min":{
                "unit":"%",
                "value":60.0
            },
            "short_wave_radiation_avg":{
                "unit":"W/m^2",
                "value":50.0
            },
            "snow_acc_period":{
                "unit":"in",
                "value":0.01
            },
            "sunshine_duration":{
                "unit":"hours",
                "value":6
            },
            "wind_direction":{
                "unit":"degrees",
                "value":167.0
            },
            "wind_gust_max":{
                "unit":"mph",
                "value":36.0
            },
            "wind_speed_2m_avg":{
                "unit":"mph",
                "value":9.0
            },
            "wind_speed_2m_max":{
                "unit":"mph",
                "value":15.0
            },
            "wind_speed_2m_min":{
                "unit":"mph",
                "value":1.0
            },
            "wind_speed_avg":{
                "unit":"mph",
                "value":11.0
            },
            "wind_speed_max":{
                "unit":"mph",
                "value":20.0
            },
            "wind_speed_min":{
                "unit":"mph",
                "value":1.0
            }
        },...
    }
}

NowCast - v1.2

The ClearAg NowCast service provides a near-term precipitation and radar reflectivity forecast in addition to recent historical data. Historical weather data is provided for the previous four hours, with forecast data provided for up to two hours into the future.

URL Description

https://ag.us.clearapis.com/v1.2/nowcast?app_id={string}&app_key={string}
&location={lat, lon coordinates}&unitcode={string}&lang={string}
&icon_resolution={string}&icon_style={string}&icon_version={string}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Users are allowed a maximum of five coordinates,1 formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)]."

unitcode

string

no

Unit conversion set to be used. Default is "us-std." Valid values are "us-std," "si-std," "us-std-precise," and "si-std-precise." Values of "us-std-precise" and "si-std-precise" round output values to six decimal places.

lang

string

no

Language setting. Default is "en-us." Currently, only "en-us" is supported.

icon_resolution

string

no

Icon resolution setting. Default is "128." Valid values are 32, 64, 128, or 256.

icon_style

string

no

Icon style setting. Default is "style1." Currently, only "style1" is supported.

icon_version

string

no

Icon version setting. Default is "v1." Currently, only "v1" is supported.

1 Additional coordinates are not counted against a client’s account.

Response Object (JSON)

The response may vary based on language and unit code selected.

Field Description

precipitation_type_ descriptor

Precipitation type descriptor data, including a code, icon, and text string describing the precipitation type.

radar_refl_confidence_ descriptor

Radar reflectivity confidence descriptor data, including a code, icon, and text string describing the forecast confidence. Radar reflectivity confidence is an estimate of certainty in the accuracy of the forecast reflectivity values. Only available for forecast timeframes. Please note that confidence icons are not yet available.

precip_acc_nowcast

Liquid-equivalent precipitation accumulation calculated from forecast reflectivity values.

precip_acc_overall

Liquid-equivalent precipitation accumulation calculated from forecast and observed reflectivity values spanning the entire result timeframe.

radar_refl

Radar reflectivity data. Radar reflectivity is a measure of the amount of power reflected off of hydrometeors and returned to the radar, and increases with increasing precipitation intensity. Observed and forecast values provided.

Example Request

https://ag.us.clearapis.com/v1.2/nowcast?app_id=123&app_key=321&location=47,-97

Example Response

{
    "47,-97":{
        "descriptors:[
            {
                "precipitation_type_descriptor":{
                    "code":60500,
                    "icon":"https://.../precip_rain.png",
                    "text":"Rain"
                },
                "radar_refl_confidence_descriptor":{
                    "code":10900,
                    "icon":"https://.../error_datanotavailable.png",
                    "text":"High"
                },
                "valid_time_end":1474409100,
                "valid_time_start":1474408800
            },...
        ],
        "precip_acc_nowcast":{
            "unit":"in",
            "valid_time_end":1474416300,
            "valid_time_start":1474408800,
            "value":0.15
        },
        "precip_acc_overall":{
            "unit":"in",
            "valid_time_end":1474416300,
            "valid_time_start":1474394400,
            "value":0.27
        },
        "radar_refl":[
            {
                "unit":"dBZ",
                "valid_time_end":1474409100,
                "valid_time_start":1474408800
                "value":15.0
            },...
        ]
    }
}

Precipitation Summary - v1.0

The Precipitation Summary endpoint provides real-time historical precipitation statistics, with totals aggregated by accumulation timeframe.

URL Description

https://ag.us.clearapis.com/v1.0/precip_summary?app_id={string}&app_key={string}
&location={lat, lon coordinates}&unitcode={string}&include_daily

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Users are allowed a maximum of five coordinates,1 formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)]."

unitcode

string

no

Unit conversion set to be used. Default is "us-std." Valid values are "us-std," "si-std," "us-std-precise," and "si-std-precise." Values of "us-std-precise" and "si-std-precise" round output values to six decimal places.

include_daily

flag

no

Switches on the display of the daily historical precipitation values used in the calculation of the aggregate values.

1 Additional coordinates are not counted against a client’s account.

Response Object (JSON)

Field Description

precip_acc_24hr

Precipitation accumulation of the last full 24 hours, plus the accumulation occurring in the current hour.

precip_acc_30day

Precipitation accumulation of the last full 30 days, plus the accumulation occurring in the current day.

precip_acc_60min

Precipitation accumulation of the last full hour, plus the accumulation occurring in the current hour.

precip_acc_7day

Precipitation accumulation of the last full 7 days, plus the accumulation occurring in the current day.

precip_acc_90day

Precipitation accumulation of the last full 90 days, plus the accumulation occurring in the current day.

precip_acc_today

Precipitation accumulation since midnight today in the time zone of the location queried.

precip_acc_year_to_date

Precipitation accumulation since January 1st of the current year.

precip_daily

List of daily precipitation accumulation values used in the aggregate calculations.

Example Request

https://ag.us.clearapis.com/v1.0/precip_summary?app_id=123&app_key=321
&location=47.922759,-97.089954&include_daily

Example Response

{
    "47.922759,-97.089954":{
        "precip_aggregates":{
            "precip_acc_24hr":{
                "unit":"in",
                "valid_time_end":1430865000,
                "valid_time_start":1430776800,
                "value":0.0
            },
            "precip_acc_30day":{
                "unit":"in",
                "valid_time_end":1430865000,
                "valid_time_start":1428210000,
                "value":1.2
            },
            "precip_acc_60min":{
                "unit":"in",
                "valid_time_end":1430865000,
                "valid_time_start":1430859600,
                "value":0.0
            },
            "precip_acc_7day":{
                "unit":"in",
                "valid_time_end":1430865000,
                "valid_time_start":1430197200,
                "value":0.22
            },
            "precip_acc_90day":{
                "unit":"in",
                "valid_time_end":1430865000,
                "valid_time_start":1423026000,
                "value":2.59
            },
            "precip_acc_today":{
                "unit":"in",
                "valid_time_end":1430865000,
                "valid_time_start":1430802000,
                "value":0.0
            },
            "precip_acc_year_to_date":{
                "unit":"in",
                "valid_time_end":1430865000,
                "valid_time_start":1420088400,
                "value":3.48
            }
        },
        "precip_daily":[
            {
                "2015-01-01":{
                    "unit":"in",
                    "valid_time_end":1420174800,
                    "valid_time_start":1420088400,
                    "value":0.12
                }
            },
            {
                "2015-01-02":{
                    "unit":"in",
                    "valid_time_end":1420261200,
                    "valid_time_start":1420174800,
                    "value":0.28
                }
            },...
        ]
    }
}

Frost Forecast - v1.0

The Frost Forecast endpoint provides users with up to 72 hours of 15-minute frost forecasts, which indicate whether or not frost is to be expected on surface vegetation.

URL Description

https://ag.us.clearapis.com/v1.0/forecast/frost?app_id={string}&app_key={string}
&start={integer}&end={integer}&location={lat, lon coordinates}&unitcode={string}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

start

integer

yes

Start of time range. Supported range is from 0 to 72. Hour 0 represents the current hour.

end

integer

yes

End of time range. Supported range is from 0 to 72.

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Users are allowed a maximum of five coordinates,1 formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)]."

unitcode

string

no

Unit conversion set to be used. Default is "us-std." Valid values are "us-std," "si-std," "us-std-precise," and "si-std-precise." Values of "us-std-precise" and "si-std-precise" round output values to six decimal places.

1 Additional coordinates are not counted against a client’s account.

Response Object (JSON)

Field Description

canopy_surface_water

The measure of the amount of water on surface vegetation.

frost_expected

Indicates whether or not frost is expected to be present. (May be true or false.)

skin_temp

Temperature of the soil surface.

Example Request

https://ag.us.clearapis.com/v1.0/forecast/frost?app_id=123&app_key=321&start=0
&end=1&location=47,-97

Example Response

{
    "47,-97":{
        "1509494400":{
            "canopy_surface_water":{
                "unit":"in",
                "value":0.0043
            },
            frost_expected":{
                "unit":"n/a",
                "value":true
            },
            "skin_temp":{
                "unit":"F",
                "value":30.0
            }
        },...
    }
}

Growing Degree Days - v1.0

The Growing Degree Days endpoint provides users historical and forecast growing degree-day estimates using the single sine method. This method uses a day’s minimum and maximum temperatures to produce a sine curve over a 24-hour period, and then estimates degree-days for that day by calculating the area above the threshold (base) temperature and below the sine curve. This method assumes the temperature curve is symmetrical around the maximum temperature.

URL Description

https://ag.us.clearapis.com/v1.0/crop_health/general/single_sine_gdd?app_id={string}
&app_key={string}&location={lat, lon coordinates}&start_date={timestamp}
&days={integer}&base_temp={integer}&upper_limit_temp={integer}

Request Parameters

Parameter Type Required Description

app_id

string

yes

API ID provided by Iteris.

app_key

string

yes

API key provided by Iteris.

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. Please verify that latitude/longitude coordinates are over soil representative of your field. Users are allowed a maximum of five coordinates1, formatted as "&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)]."

start_date

timestamp

yes

Epoch timestamp representing the start time for the model. Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

days

integer

yes

Number of days for which to calculate results. Possible values range from 1 to 366.

base_temp

integer

yes

The base temperature in degrees Fahrenheit.

upper_limit_temp

integer

yes

The upper-limit temperature in degrees Fahrenheit.

1 Additional coordinates are not counted against a client’s account.

Response Object (JSON)

Field Description

gdd

Growing degree days accumulated on the current date.

agdd

Aggregate growing degree days from plant date, including the current period’s date.

air_temp_min

Minimum air temperature valid for the current period’s date. This value is obtained from recorded values, forecasted values, or climatological averages, depending on the given time frame.

air_temp_max

Maximum air temperature valid for the current period’s date. This value is obtained from recorded values, forecasted values, or climatological averages, depending on the given time frame.

Example Request

https://ag.us.clearapis.com/v1.0/crop_health/general/single_sine_gdd?app_id=123
&app_key=321&location=47.4,-101.7&start_date=1393632000&days=160&base_temp=50
&upper_limit_temp=95

Example Response

{
    "data":{
        "47.4,-101.7":{
            "2014-07-14":{
                "agdd":876.1,
                "air_temp_max":74.0,
                "air_temp_min":43.0,
                "gdd":9.9
            },...
        },...
    }
}

Appendix

Common HTTP response codes

The following are common HTTP response codes and their meanings. These are standard across all API services.

  • 200 OK - The request was successful.

  • 400 Bad Request - The request was invalid. An accompanying error message will be provided if available.

  • 401 Unauthorized - Authentication to the API has failed. Authentication credentials are missing or incorrect.

  • 403 Forbidden - You are trying to access a resource for which you do not have the appropriate privileges.

  • 404 Not found - The requested resource was not found. An accompanying error message will be provided if available.

  • 500 Internal Server Error - An internal server error has occurred while processing the request.

  • 502 Bad Gateway - The service is not reachable.

Null or Empty Values

In some cases values will be represented as "n/a." This indicates that the requested data is not available or is not applicable.

Epoch/Unix Timestamp

Iteris employs Epoch/Unix timestamps for some time-based parameters. Timestamps are defined as the number of seconds since 1970-01-01 00:00 Coordinated Universal Time (UTC).

Note that in daily endpoints, timestamps as URL arguments do not necessarily conform to this definition. In these endpoints, timestamps can be thought of as being relative to the local time zone. For example, a plant_date timestamp corresponding to 2016-05-01 00:00 UTC in the Corn Growth endpoint can be viewed as 2016-05-01 00:00 local time, and the endpoint returns data starting on that date.

Regional-based Account Access

Any data stored by the Account API in one region is not available in another. Each region will require a unique set of credentials. Please contact your account representative if interested in utilizing an additional region. When attempting to use the credentials from one region with the services in another, an 'account not found' error will be returned with HTTP status code 400. See example below:

<title>400 Bad Request</title>
<h1>Bad Request</h1>
<p>Account not found.</p>

Textual Form of Numerical Outputs

This section outlines what numerical outputs represent in textual form. When reviewing data outputs, the last number in the numerical sequence ("code") correlates to the given text description ("qualifier").

Leading Qualifiers

Code Qualifier

1

Widely Scattered

2

Scattered

3

Numerous

4

Widespread

5

Chance of

6

Pending

7

Increasing

8

Decreasing

9

Becoming

10

Variable

11

Turning

12

Occasional

13

Slight Chance of

14

Isolated

15

Lightly

16

Some Risk of

17

Intermittent

18

Intermittently

19

Good Chance of

Trailing Qualifiers

Code Qualifier

50

Likely

51

Beginning

52

Starting

53

Developing

54

Increasing

55

Ending

56

Lifting

57

Diminishing

58

Decreasing

59

Dissipating

60

Variable

61

Pending

62

Watch

63

Warning

64

Advisory

65

In the Vicinity

66

Continuing

67

Conditions Continuing

68

Imminent

69

Conditions Developing

70

Conditions Diminishing

71

Near Freezing

Error / Other

Code Description Leading Codes Leading Qualifiers Trailing Codes Trailing Qualifiers

10000

Data Not Available

10100

Bad Location

10200

Error

10300

Other

10400

Unknown

10500

None

10600

Low

10700

Moderate

10800

Medium

10900

High

11000

Yes

11100

No

Sky Cover

Code Description Leading Codes Leading Qualifiers Trailing Codes Trailing Qualifiers

20000

Clear

9

Becoming

20100

Mostly Clear

9

Becoming

20200

Partly Cloudy

9

Becoming

20300

Partly Clear

9

Becoming

20400

Mostly Cloudy

9

Becoming

20500

Cloudy

9

Becoming

20600

Fair

9

Becoming

20700

Few Clouds

53

Developing

20800

Scattered Clouds

53

Developing

20900

Broken Overcast

9

Becoming

21000

Overcast

9

Becoming

21100

Clouds

7, 8, 10

Increasing, Decreasing, Variable

21200

Visibility

Code Description Leading Codes Leading Qualifiers Trailing Codes Trailing Qualifiers

30000

Haze

30100

Hazy

30200

Mist

30300

Patchy Fog

50, 53, 56, 59, 64, 65, 66

Likely, Developing, Lifting, Dissipating, Advisory, In the Vicinity, Continuing

30400

Fog

50, 53, 56, 59, 64, 65, 66

Likely, Developing, Lifting, Dissipating, Advisory, In the Vicinity, Continuing

30500

Dense Fog

50, 53, 56, 59, 64, 65, 66

Likely, Developing, Lifting, Dissipating, Advisory, In the Vicinity, Continuing

30600

Freezing Mist

50, 53, 55, 59, 65, 66

Likely, Developing, Ending, Dissipating, In the Vicinity, Continuing

30700

Freezing Fog

50, 53, 56, 59, 64, 65, 66

Likely, Developing, Lifting, Dissipating, Advisory, In the Vicinity, Continuing

30800

Ice Fog

50, 53, 56, 59, 64, 65, 66

Likely, Developing, Lifting, Dissipating, Advisory, In the Vicinity, Continuing

30900

Blowing Snow

2, 4, 5, 13, 19

Scattered, Widespread, Chance of, Slight Chance of, Good Chance of

50, 53, 55, 57, 59, 62, 63, 64, 65, 66

Likely, Developing, Ending, Diminishing, Dissipating, Watch, Warning, Advisory, In the Vicinity, Continuing

31000

Drifting Snow

2, 4, 5, 13, 19

Scattered, Widespread, Chance of, Slight Chance of, Good Chance of

50, 53, 55, 57, 59, 62, 63, 64, 65, 66

Likely, Developing, Ending, Diminishing, Dissipating, Watch, Warning, Advisory, In the Vicinity, Continuing

31100

Dust

31200

Blowing Dust

31300

Blowing Sand

31400

Smoke

59, 65, 66

Dissipating, In the Vicinity, Continuing

31500

Volcanic Ash

65

In the Vicinity

31600

Spray

65

In the Vicinity

Temperature

Code Description Leading Codes Leading Qualifiers Trailing Codes Trailing Qualifiers

40000

Very Cold

9

Becoming

67

Conditions Continuing

40100

Cold

9

Becoming

67

Conditions Continuing

40200

Cool

67

Conditions Continuing

40300

Mild

67

Conditions Continuing

40400

Warm

67

Conditions Continuing

40500

Hot

9

Becoming

67

Conditions Continuing

40600

Very Hot

9

Becoming

67

Conditions Continuing

40700

Humid

9

Becoming

67

Conditions Continuing

40800

Warm and Humid

9

Becoming

67

Conditions Continuing

40900

Hot and Humid

9

Becoming

67

Conditions Continuing

41000

Very Hot and Humid

9

Becoming

67

Conditions Continuing

41100

More Humid

9, 11

Becoming, Turning

41200

Colder

9, 11

Becoming, Turning

41300

Warmer

9, 11

Becoming, Turning

Wind

Code Description Leading Codes Leading Qualifiers Trailing Codes Trailing Qualifiers

50000

Calm

9

Becoming

67

Conditions Continuing

50100

Light Winds

66

Continuing

50200

Light Breeze

66

Continuing

50300

Windy

9, 11

Becoming, Turning

67, 69, 70

Conditions Continuing, Conditions Developing, Conditions Diminishing

50400

Breezy

9, 11

Becoming, Turning

67, 69, 70

Conditions Continuing, Conditions Developing, Conditions Diminishing

50500

Gusty Winds

53, 57, 66

Developing, Diminishing, Continuing

50600

North

9, 11

Becoming, Turning

50700

North-Northeast

9, 11

Becoming, Turning

50800

Northeast

9, 11

Becoming, Turning

50900

East-Northeast

9, 11

Becoming, Turning

51000

East

9, 11

Becoming, Turning

51100

East-Southeast

9, 11

Becoming, Turning

51200

Southeast

9, 11

Becoming, Turning

51300

South-Southeast

9, 11

Becoming, Turning

51400

South

9, 11

Becoming, Turning

51500

South-Southwest

9, 11

Becoming, Turning

51600

Southwest

9, 11

Becoming, Turning

51700

West-Southwest

9, 11

Becoming, Turning

51800

West

9, 11

Becoming, Turning

51900

West-Northwest

9, 11

Becoming, Turning

52000

Northwest

9, 11

Becoming, Turning

52100

North-Northwest

9, 11

Becoming, Turning

52200

Variable

9, 11

Becoming, Turning

Precipitation

Code Description Leading Codes Leading Qualifiers Trailing Codes Trailing Qualifiers

60000

Drizzle

2, 4, 5, 12, 13, 19

Scattered, Widespread, Chance of, Occasional, Slight Chance of, Good Chance of

50, 53, 55, 59, 66

Likely, Developing, Ending, Dissipating, Continuing

60100

Freezing Drizzle

2, 4, 5, 12, 13, 19

Scattered, Widespread, Chance of, Occasional, Slight Chance of, Good Chance of

50, 53, 55, 59, 66

Likely, Developing, Ending, Dissipating, Continuing

60200

Sprinkles

0, 1, 2, 5, 12, 13, 19

Isolated, Widely Scattered, Scattered, Chance of, Occasional, Slight Chance of, Good Chance of

50, 53, 55, 57, 59, 65, 66

Likely, Developing, Ending, Diminishing, Dissipating, In the Vicinity, Continuing

60300

Light Rain

4, 5, 12, 13, 19

Widespread, Chance of, Occasional, Slight Chance of, Good Chance of

50, 53, 55, 59, 65, 66

Likely, Developing, Ending, Dissipating, In the Vicinity, Continuing

60400

Light Rain Showers

0, 1, 2, 5, 12, 13, 19

Isolated, Widely Scattered, Scattered, Chance of, Occasional, Slight Chance of, Good Chance of

50, 53, 55, 59, 65, 66

Likely, Developing, Ending, Dissipating, In the Vicinity, Continuing

60500

Rain

4, 5, 13, 19

Widespread, Chance of, Slight Chance of, Good Chance of

50, 53, 55, 59, 65, 66

Likely, Developing, Ending, Dissipating, In the Vicinity, Continuing

60600

Rain Showers

0, 1, 2, 5, 12, 13, 19

Isolated, Widely Scattered, Scattered, Chance of, Occasional, Slight Chance of, Good Chance of

50, 53, 55, 59, 65, 66

Likely, Developing, Ending, Dissipating, In the Vicinity, Continuing

60700

Heavy Rain

4, 5, 13, 19

Widespread, Chance of, Slight Chance of, Good Chance of

50, 53, 55, 59, 65, 66

Likely, Developing, Ending, Dissipating, In the Vicinity, Continuing

60800

Thundershowers

0, 1, 2, 3, 4, 5, 12, 13, 19

Isolated, Widely Scattered, Scattered, Numerous, Widespread, Chance of, Occasional, Slight Chance of, Good Chance of

50, 53, 55, 57, 59, 65, 66, 68

Likely, Developing, Ending, Diminishing, Dissipating, In the Vicinity, Continuing, Imminent

60900

Thunderstorms

0, 1, 2, 3, 4, 5, 12, 13, 19

Isolated, Widely Scattered, Scattered, Numerous, Widespread, Chance of, Occasional, Slight Chance of, Good Chance of

50, 53, 55, 57, 59, 65, 66, 68

Likely, Developing, Ending, Diminishing, Dissipating, In the Vicinity, Continuing, Imminent

61000

Thunder

65

In the Vicinity

61100

Flurries

0, 1, 2, 5, 12, 13, 19

Isolated, Widely Scattered, Scattered, Chance of, Occasional, Slight Chance of, Good Chance of

50, 53, 55, 57, 59, 65, 66

Likely, Developing, Ending, Diminishing, Dissipating, In the Vicinity, Continuing

61200

Light Snow

4, 5, 12, 13, 19

Widespread, Chance of, Occasional, Slight Chance of, Good Chance of

50, 53, 55, 59, 65, 66

Likely, Developing, Ending, Dissipating, In the Vicinity, Continuing

61300

Light Snow Showers

0, 1, 2, 5, 12, 13, 19

Isolated, Widely Scattered, Scattered, Chance of, Occasional, Slight Chance of, Good Chance of

50, 53, 55, 59, 65, 66

Likely, Developing, Ending, Dissipating, In the Vicinity, Continuing

61400

Snow

4, 5, 13, 19

Widespread, Chance of, Slight Chance of, Good Chance of

50, 53, 55, 59, 65, 66

Likely, Developing, Ending, Dissipating, In the Vicinity, Continuing

61500

Snow Showers

0, 1, 2, 5, 12, 13

Isolated, Widely Scattered, Scattered, Chance of, Occasional, Slight Chance of, Good Chance of

50, 53, 55, 59, 65, 66

Likely, Developing, Ending, Dissipating, In the Vicinity, Continuing

61600

Heavy Snow

4, 5, 13

Widespread, Chance of, Slight Chance of, Good Chance of

50, 53, 55, 59, 65, 66

Likely, Developing, Ending, Dissipating, In the Vicinity, Continuing

61700

Rain and Snow

4, 5, 12, 13, 19

Widespread, Chance of, Occasional, Slight Chance of, Good Chance of

50, 53, 55, 59, 65, 66

Likely, Developing, Ending, Dissipating, In the Vicinity, Continuing

61800

Wintry Mix

4, 5, 12, 13, 19

Widespread, Chance of, Occasional, Slight Chance of, Good Chance of

50, 53, 55, 59, 65, 66

Likely, Developing, Ending, Dissipating, In the Vicinity, Continuing

61900

Freezing Rain

4, 5, 12, 13, 19

Widespread, Chance of, Occasional, Slight Chance of, Good Chance of

50, 53, 55, 59, 65, 66

Likely, Developing, Ending, Dissipating, In the Vicinity, Continuing

62000

Sleet

5, 12, 13, 19

Chance of, Occasional, Slight Chance of, Good Chance of

50, 53, 55, 59, 65, 66

Likely, Developing, Ending, Dissipating, In the Vicinity, Continuing

62100

Ice Pellets

65

In the Vicinity

62200

Hail

65

In the Vicinity

62300

Severe Thunderstorm

62, 63, 65, 68

Watch, Warning, In the Vicinity, Imminent

62400

Tornado

62, 63, 65

Watch, Warning, In the Vicinity

62500

Winter Storm

53, 55, 59, 62, 63, 64, 68

Developing, Ending, Dissipating, Watch, Warning, Advisory, Imminent

62600

Winter Weather

64, 68

Advisory, Imminent

62700

Blizzard

62, 63, 67, 68

Watch, Warning, Conditions Continuing, Imminent

62800

Ice Storm

62, 63, 64, 66, 68

Watch, Warning, Advisory, Continuing, Imminent

62900

Tropical Storm

62, 63, 64, 66, 68

Watch, Warning, Advisory, Continuing, Imminent

63000

Hurricane

62, 63, 64, 66, 68

Watch, Warning, Advisory, Continuing, Imminent

Severe Weather

Code Description Leading Codes Leading Qualifiers Trailing Codes Trailing Qualifiers

80000

Minimal or No Hail

80100

Slight Possibility of Hail

80200

Hail Possible

80300

Hail Likely

80400

Severe Hail Likely

80500

Extreme Hail Likely

Layer Legend Data

This section contains legend data for each layer type. The following tables include listings of legend values and corresponding RGB values.

Hail Probability

R Value G Value B Value Color Legend Value

255

255

0

255 255 0

Minimal

255

232

0

255 232 0

Minimal

255

210

0

255 210 0

Minimal

255

187

0

255 187 0

Minimal

255

165

0

255 165 0

Minimal

255

143

0

255 143 0

Slight

247

114

0

247 114 0

Slight

239

85

0

239 85 0

Slight

231

57

0

231 57 0

Slight

223

28

0

223 28 0

Slight

215

0

0

215 0 0

Possible

223

0

51

223 0 51

Possible

231

0

102

231 0 102

Possible

239

0

153

239 0 153

Possible

247

0

204

247 0 204

Possible

255

0

255

255 0 255

Likely

235

17

244

235 17 244

Likely

215

34

234

215 34 234

Likely

195

52

223

195 52 223

Likely

175

69

213

175 69 213

Likely

155

87

203

155 87 203

Severe

164

109

202

164 109 202

Severe

173

132

201

173 132 201

Severe

182

154

201

182 154 201

Severe

191

177

200

191 177 200

Severe

200

200

200

200 200 200

Extreme

Hourly Precipitation

R Value G Value B Value Color Legend Value (in)

136

192

200

136 192 200

T

120

168

200

120 168 200

0.005

104

144

200

104 144 200

0.01

104

156

232

104 156 232

0.02

72

124

250

72 124 250

0.03

8

28

250

8 28 250

0.04

56

250

40

56 250 40

0.05

28

187

20

28 187 20

0.06

0

124

0

0 124 0

0.07

75

161

0

75 161 0

0.08

175

212

0

175 212 0

0.09

250

250

0

250 250 0

0.10

249

231

0

249 231 0

0.11

249

213

0

249 213 0

0.12

248

194

0

248 194 0

0.13

248

176

0

248 176 0

0.14

248

158

0

248 158 0

0.15

248

146

0

248 146 0

0.16

248

134

0

248 134 0

0.17

249

123

0

249 123 0

0.18

249

111

0

249 111 0

0.19

250

100

0

250 100 0

0.20

200

50

0

200 50 0

0.225

150

0

0

150 0 0

0.25

175

5

0

175 5 0

0.275

200

10

0

200 10 0

0.30

212

8

0

212 8 0

0.325

225

5

0

225 5 0

0.35

238

3

0

238 3 0

0.375

250

0

0

250 0 0

0.40

224

0

46

224 0 46

0.425

197

0

92

197 0 92

0.45

171

0

138

171 0 138

0.475

145

0

185

145 0 185

0.50

159

5

178

159 5 178

0.55

173

10

171

173 10 171

0.60

187

15

164

187 15 164

0.65

201

20

157

201 20 157

0.70

215

25

150

215 25 150

0.75

223

20

171

223 20 171

0.80

231

15

192

231 15 192

0.85

239

10

213

239 10 213

0.90

247

5

234

247 5 234

0.95

255

0

255

255 0 255

1.00+

Hourly Snow

R Value G Value B Value Color Legend Value (in)

136

192

200

136 192 200

T

104

144

200

104 144 200

0.2

104

156

232

104 156 232

0.4

72

124

250

72 124 250

0.6

8

28

250

8 28 250

0.8

56

250

40

56 250 40

1.0

0

124

0

0 124 0

1.25

250

250

0

250 250 0

1.50

248

158

0

248 158 0

1.75

250

100

0

250 100 0

2.00

150

0

0

150 0 0

2.25

200

10

0

200 10 0

2.50

250

0

0

250 0 0

2.75

145

0

185

145 0 185

3.00

215

25

150

215 25 150

3.50

255

0

255

255 0 255

4.00+

Precipitation

R Value G Value B Value Color Legend Value (in)

180

195

210

180 195 210

T

150

185

210

150 185 210

0.01

120

170

220

120 170 220

0.02

105

155

225

105 155 225

0.03

90

140

230

90 140 230

0.04

75

115

235

75 115 235

0.05

50

85

250

50 85 250

0.06

35

55

252

35 55 252

0.07

20

30

255

20 30 255

0.08

0

255

0

0 255 0

0.10

0

240

0

0 240 0

0.12

4

225

4

4 225 4

0.15

8

195

8

8 195 8

0.20

12

165

12

12 165 12

0.25

16

130

16

16 130 16

0.30

85

170

33

85 170 33

0.35

155

205

50

155 205 50

0.40

205

205

25

205 205 25

0.45

255

255

0

255 255 0

0.50

252

235

0

252 235 0

0.60

250

215

0

250 215 0

0.70

247

190

0

247 190 0

0.80

247

175

0

247 175 0

0.90

245

160

0

245 160 0

1.0

245

130

0

245 130 0

1.1

240

100

0

240 100 0

1.25

150

0

0

150 0 0

1.50

175

0

0

175 0 0

1.75

200

0

0

200 0 0

2.0

225

5

0

225 5 0

2.5

250

10

0

250 10 0

3.0

225

15

60

225 15 60

3.5

212

17

88

212 17 88

4.0

205

20

115

205 20 115

4.5

175

25

150

175 25 150

5.0

145

30

185

145 30 185

6.0

165

60

195

165 60 195

7.0

185

95

205

185 95 205

8.0

220

162

220

220 162 220

9.0

240

130

240

240 130 240

10.0

247

65

245

247 65 245

11.0

255

0

255

255 0 255

12.0

205

0

205

205 0 205

15.0+

Precipitation Alerts

R Value G Value B Value Color Legend Value (in)

180

195

210

180 195 210

T

150

185

210

150 185 210

0.01

120

170

220

120 170 220

0.02

90

140

230

90 140 230

0.04

50

85

250

50 85 250

0.06

20

30

255

20 30 255

0.08

0

255

0

0 255 0

0.10

4

225

4

4 225 4

0.15

8

195

8

8 195 8

0.20

12

165

12

12 165 12

0.25

16

130

16

16 130 16

0.3

155

205

50

155 205 50

0.4

255

255

0

255 255 0

0.5

250

215

0

250 215 0

0.75

245

165

0

245 165 0

1.0

240

100

0

240 100 0

1.25

150

0

0

150 0 0

1.5

200

0

0

200 0 0

2.0

250

10

0

250 10 0

3.0

205

20

115

205 20 115

4.0

145

30

185

145 30 185

6.0

185

95

205

185 95 205

8.0

240

130

240

240 130 240

10.0

255

0

255

255 0 255

12.0

205

0

205

205 0 205

15.0+

The image below details the different hatching levels used to describe precipitation probabilities.

precip hatch

Precipitation Probability Alerts

R Value G Value B Value Color Legend Value

0

255

0

0 255 0

None

255

255

0

255 255 0

Slight

255

128

0

255 128 0

Chance

255

0

0

255 0 0

Good Chance

255

0

255

255 0 255

Likely

Precipitation Start Times

R Value G Value B Value Color Legend Value (hour)

0

70

70

0 70 70

12am

0

100

100

0 100 100

1am

0

130

130

0 130 130

2am

0

160

160

0 160 160

3am

0

190

190

0 190 190

4am

0

220

220

0 220 220

5am

0

250

250

0 250 250

6am

0

250

190

0 250 190

7am

0

250

130

0 250 130

8am

0

250

70

0 250 70

9am

70

250

70

70 250 70

10am

100

250

0

100 250 0

11am

160

250

0

160 250 0

12pm

220

250

0

220 250 0

1pm

250

250

0

250 250 0

2pm

250

230

0

250 230 0

3pm

250

210

0

250 210 0

4pm

250

190

70

250 190 70

5pm

220

170

70

220 170 70

6pm

190

150

70

190 150 70

7pm

160

130

70

160 130 70

8pm

130

110

70

130 110 70

9pm

100

90

70

100 90 70

10pm

70

70

70

70 70 70

11pm

Radar / Forecast Type & Probability

Freezing Precipitation

R Value G Value B Value Color Legend Value (Intensity)

255

220

220

255 220 220

Very Light

255

172

172

255 172 172

Light

255

124

124

255 124 124

Moderate

255

80

80

255 80 80

Heavy

255

0

0

255 0 0

Very Heavy

Liquid Precipitation

R Value G Value B Value Color Legend Value (Intensity)

0

175

0

0 175 0

Very Light

0

100

0

0 100 0

Light

240

240

0

240 240 0

Moderate

255

135

0

255 135 0

Heavy

175

0

0

175 0 0

Very Heavy

Sleet & Snow

R Value G Value B Value Color Legend Value (Intensity)

0

239

255

0 239 255

Very Light

0

191

255

0 191 255

Light

0

123

255

0 123 255

Moderate

0

38

255

0 38 255

Heavy

0

0

137

0 0 137

Very Heavy

Wintry Mix

R Value G Value B Value Color Legend Value (Intensity)

255

156

255

255 156 255

Very Light

255

0

255

255 0 255

Light

200

0

255

200 0 255

Moderate

128

0

128

128 0 128

Heavy

64

0

64

64 0 64

Very Heavy

The image below details the different hatching levels used to describe precipitation probabilities.

precip hatch

Radar / Reflectivity & Type

Freezing Precipitation

R Value G Value B Value Color Legend Value (dBZ)

255

220

200

255 220 200

1

255

220

200

255 220 200

3

255

220

200

255 220 200

5

255

213

193

255 213 193

7

255

207

187

255 207 187

9

255

200

180

255 200 180

11

255

194

174

255 194 174

13

255

188

168

255 188 168

15

255

181

161

255 181 161

17

255

175

155

255 175 155

19

255

168

149

255 168 149

21

255

162

143

255 162 143

23

255

156

137

255 156 137

25

255

149

130

255 149 130

27

255

143

123

255 143 123

29

255

136

118

255 136 118

31

255

130

116

255 130 116

33

255

124

114

255 124 114

35

255

117

107

255 117 107

37

255

111

101

255 111 101

39

255

105

95

255 105 95

41

255

100

90

255 100 90

43

255

96

86

255 96 86

45

255

89

83

255 89 83

47

255

83

81

255 83 81

49

255

76

76

255 76 76

51

255

70

70

255 70 70

53

255

64

64

255 64 64

55

255

57

57

255 57 57

57

255

51

51

255 51 51

59

255

44

44

255 44 44

61

255

38

38

255 38 38

63

255

32

32

255 32 32

65

255

25

25

255 25 25

67

255

19

19

255 19 19

69

255

12

12

255 12 12

71

255

6

6

255 6 6

73

255

0

0

255 0 0

75

Liquid Precipitation

R Value G Value B Value Color Legend Value (dBZ)

0

255

128

0 255 128

1

0

255

128

0 255 128

3

0

255

128

0 255 128

5

0

255

76

0 255 76

7

0

255

25

0 255 25

9

0

244

0

0 244 0

11

0

222

0

0 222 0

13

0

200

0

0 200 0

15

0

180

0

0 180 0

17

0

160

0

0 160 0

19

0

140

0

0 140 0

21

0

120

0

0 120 0

23

0

100

0

0 100 0

25

0

80

0

0 80 0

27

0

60

0

0 60 0

29

42

82

0

42 82 0

31

126

146

0

126 146 0

33

210

210

0

210 210 0

35

228

228

0

228 228 0

37

246

246

0

246 246 0

39

255

234

0

255 234 0

41

255

192

0

255 192 0

43

255

150

0

255 150 0

45

255

110

0

255 110 0

47

255

70

0

255 70 0

49

244

40

0

244 40 0

51

222

20

0

222 20 0

53

200

0

0

200 0 0

55

180

0

0

180 0 0

57

160

0

0

160 0 0

59

171

0

51

171 0 51

61

213

0

153

213 0 153

63

255

0

255

255 0 255

65

215

34

234

215 34 234

67

175

69

213

175 69 213

69

167

112

205

167 112 205

71

191

163

210

191 163 210

73

215

215

215

215 215 215

75

Sleet & Snow

R Value G Value B Value Color Legend Value (dBZ)

0

239

255

0 239 255

1

0

239

255

0 239 255

3

0

239

255

0 239 255

5

0

228

255

0 228 255

7

0

217

255

0 217 255

9

0

207

255

0 207 255

11

0

199

255

0 199 255

13

0

191

255

0 191 255

15

0

183

255

0 183 255

17

0

176

255

0 176 255

19

0

168

255

0 168 255

21

0

158

255

0 158 255

23

0

148

255

0 148 255

25

0

138

255

0 138 255

27

0

128

255

0 128 255

29

0

119

255

0 119 255

31

0

111

255

0 111 255

33

0

104

255

0 104 255

35

0

96

255

0 96 255

37

0

88

255

0 88 255

39

0

81

255

0 81 255

41

0

74

255

0 74 255

43

0

67

255

0 67 255

45

0

55

255

0 55 255

47

0

43

255

0 43 255

49

0

33

255

0 33 255

51

0

23

255

0 23 255

53

0

14

255

0 14 255

55

0

8

255

0 8 255

57

0

2

255

0 2 255

59

0

0

248

0 0 248

61

0

0

235

0 0 235

63

0

0

223

0 0 223

65

0

0

215

0 0 215

67

0

0

207

0 0 207

69

0

0

189

0 0 189

71

0

0

163

0 0 163

73

0

0

137

0 0 137

75

Wintry Mix

R Value G Value B Value Color Legend Value (dBZ)

255

179

255

255 179 255

1

255

179

255

255 179 255

3

255

179

255

255 179 255

5

248

176

238

248 176 238

7

242

174

222

242 174 222

9

240

167

211

240 167 211

11

243

157

206

243 157 206

13

247

147

202

247 147 202

15

247

140

200

247 140 200

17

247

134

198

247 134 198

19

243

127

196

243 127 196

21

237

121

192

237 121 192

23

231

115

189

231 115 189

25

231

108

189

231 108 189

27

231

101

189

231 101 189

29

229

94

187

229 94 187

31

225

88

184

225 88 184

33

222

82

181

222 82 181

35

218

75

177

218 75 177

37

215

68

174

215 68 174

39

213

62

170

213 62 170

41

211

57

166

211 57 166

43

209

53

162

209 53 162

45

202

48

158

202 48 158

47

196

44

155

196 44 155

49

193

39

152

193 39 152

51

193

34

148

193 34 148

53

193

30

145

193 30 145

55

187

30

143

187 30 143

57

181

30

141

181 30 141

59

175

28

137

175 28 137

61

170

26

132

170 26 132

63

165

24

128

165 24 128

65

162

20

127

162 20 127

67

160

16

126

160 16 126

69

156

11

123

156 11 123

71

151

5

118

151 5 118

73

147

0

114

147 0 114

75

Relative Humidity

R Value G Value B Value Color Legend Value (%)

110

35

35

110 35 35

0

130

17

17

130 17 17

2.5

150

0

0

150 0 0

5

175

0

0

175 0 0

7.5

200

0

0

200 0 0

10

225

0

0

225 0 0

12.5

250

0

0

250 0 0

15

250

25

0

250 25 0

17.5

250

50

0

250 50 0

20

250

75

0

250 75 0

22.5

250

100

0

250 100 0

25

250

115

0

250 115 0

27.5

250

130

0

250 130 0

30

250

145

0

250 145 0

32.5

250

160

0

250 160 0

35

250

175

0

250 175 0

37.5

250

190

0

250 190 0

40

250

210

0

250 210 0

42.5

250

230

0

250 230 0

45

141

241

0

141 241 0

47.5

32

252

0

32 252 0

50

16

251

125

16 251 125

52.5

0

250

250

0 250 250

55

12

230

250

12 230 250

57.5

25

210

250

25 210 250

60

25

180

250

25 180 250

62.5

25

150

250

25 150 250

65

25

125

250

25 125 250

67.5

25

100

250

25 100 250

70

24

84

249

24 84 249

72.5

24

68

248

24 68 248

75

64

68

248

64 68 248

77.5

104

68

248

104 68 248

80

136

68

248

136 68 248

82.5

168

68

248

168 68 248

85

188

68

248

188 68 248

87.5

208

68

248

208 68 248

90

198

53

228

198 53 228

92.5

188

38

208

188 38 208

95

178

23

188

178 23 188

97.5

Snow

R Value G Value B Value Color Legend Value (in)

180

195

210

180 195 210

T

150

185

210

150 185 210

0.1

120

170

220

120 170 220

0.25

90

140

230

90 140 230

0.5

50

85

250

50 85 250

1.0

20

30

255

20 30 255

1.5

0

255

0

0 255 0

2.0

4

225

4

4 225 4

3.0

8

195

8

8 195 8

4.0

12

165

12

12 165 12

5.0

16

130

16

16 130 16

6.0

155

205

50

155 205 50

7.0

255

255

0

255 255 0

8.0

250

215

0

250 215 0

9.0

245

165

0

245 165 0

10.0

240

100

0

240 100 0

11.0

150

0

0

150 0 0

12.0

200

0

0

200 0 0

13.0

250

10

0

250 10 0

15.0

205

20

115

205 20 115

18.0

145

30

185

145 30 185

21.0

185

95

205

185 95 205

24.0

240

130

240

240 130 240

27.0

255

0

255

255 0 255

30.0

205

0

205

205 0 205

36.0+

Snow Alerts

R Value G Value B Value Color Legend Value (in)

180

195

210

180 195 210

T

150

185

210

150 185 210

0.1

120

170

220

120 170 220

0.25

90

140

230

90 140 230

0.5

50

85

250

50 85 250

1.0

20

30

255

20 30 255

1.5

0

255

0

0 255 0

2.0

4

225

4

4 225 4

3.0

8

195

8

8 195 8

4.0

12

165

12

12 165 12

5.0

16

130

16

16 130 16

6.0

155

205

50

155 205 50

7.0

255

255

0

255 255 0

8.0

250

215

0

250 215 0

9.0

245

165

0

245 165 0

10.0

240

100

0

240 100 0

11.0

150

0

0

150 0 0

12.0

200

0

0

200 0 0

13.0

250

10

0

250 10 0

15.0

205

20

115

205 20 115

18.0

145

30

185

145 30 185

21.0

185

95

205

185 95 205

24.0

240

130

240

240 130 240

27.0

255

0

255

255 0 255

30.0

205

0

205

205 0 205

36.0+

The image below details the different hatching levels used to describe snow probabilities.

precip hatch

Soil Moisture

R Value G Value B Value Color Legend Value (%)

110

35

35

110 35 35

0.0

200

0

0

200 0 0

2.5

250

50

0

250 50 0

5.0

250

100

0

250 100 0

7.5

250

130

0

250 130 0

10.0

250

160

0

250 160 0

12.5

250

190

0

250 190 0

15.0

250

230

0

250 230 0

17.5

32

252

0

32 252 0

20.0

0

250

250

0 250 250

22.5

25

210

250

25 210 250

20.0

25

150

250

25 150 250

27.5

25

100

250

25 100 250

30.0

24

68

248

24 68 248

32.5

104

68

248

104 68 248

35.0

168

68

248

168 68 248

37.5

208

68

248

208 68 248

40.0

188

38

208

188 38 208

42.5+

Temperature

R Value G Value B Value Color Legend Value (F)

255

255

255

255 255 255

-40

251

245

251

251 245 251

-37.5

248

236

248

248 236 248

-35

248

224

248

248 224 248

-32.5

248

212

248

248 212 248

-30

248

194

248

248 194 248

-27.5

248

176

248

248 176 248

-25

248

150

248

248 150 248

-22.5

248

124

248

248 124 248

-20

248

96

248

248 96 248

-17.5

248

68

248

248 68 248

-15

198

53

208

198 53 208

-12.5

148

38

168

148 38 168

-10

168

38

188

168 38 188

-7.5

188

38

208

188 38 208

-5

198

53

228

198 53 228

-2.5

208

68

248

208 68 248

0

188

68

248

188 68 248

2.5

168

68

248

168 68 248

5

136

68

248

136 68 248

7.5

104

68

248

104 68 248

10

64

68

248

64 68 248

12.5

24

68

248

24 68 248

15

24

84

249

24 84 249

17.5

25

100

250

25 100 250

20

25

125

250

25 125 250

22.5

25

150

250

25 150 250

25

25

180

250

25 180 250

27.5

25

210

250

25 210 250

30

12

230

250

12 230 250

32.5

0

250

250

0 250 250

35

16

251

125

16 251 125

37.5

32

252

0

32 252 0

40

141

241

0

141 241 0

42.5

250

230

0

250 230 0

45

250

210

0

250 210 0

47.5

250

190

0

250 190 0

50

250

175

0

250 175 0

52.5

250

160

0

250 160 0

55

250

145

0

250 145 0

57.5

250

130

0

250 130 0

60

250

115

0

250 115 0

62.5

250

100

0

250 100 0

65

250

75

0

250 75 0

67.5

250

50

0

250 50 0

70

250

25

0

250 25 0

72.5

250

0

0

250 0 0

75

225

0

0

225 0 0

77.5

200

0

0

200 0 0

80

175

0

0

175 0 0

82.5

150

0

0

150 0 0

85

130

17

17

130 17 17

87.5

110

35

35

110 35 35

90

115

52

52

115 52 52

92.5

120

70

70

120 70 70

95

125

87

87

125 87 87

97.5

130

105

105

130 105 105

100

135

122

122

135 122 122

102.5

140

140

140

140 140 140

105

115

115

115

115 115 115

107.5

90

90

90

90 90 90

110

70

70

70

70 70 70

112.5

50

50

50

50 50 50

115

Visibility

R Value G Value B Value Color Legend Value (mi)

110

35

35

110 35 35

< 1/4

200

0

0

200 0 0

1/4

250

50

0

250 50 0

1/2

250

130

0

250 130 0

3/4

250

190

0

250 190 0

1

32

252

0

32 252 0

2

25

210

250

25 210 250

5

25

100

250

25 100 250

10

Visibility Alerts

R Value G Value B Value Color Legend Value

0

255

0

0 255 0

Good

255

255

0

255 255 0

OK

255

0

0

255 0 0

Reduced

255

0

255

255 0 255

Poor

Wind Speeds

R Value G Value B Value Color Legend Value (mph)

0

250

250

0 250 250

0

12

230

250

12 230 250

2.5

25

210

250

25 210 250

5

25

180

250

25 180 250

7.5

25

150

250

25 150 250

10

24

109

249

24 109 249

12.5

24

68

248

24 68 248

15

12

121

124

12 121 124

17.5

0

175

0

0 175 0

20

16

213

0

16 213 0

22.5

32

252

0

32 252 0

25

141

241

0

141 241 0

27.5

250

230

0

250 230 0

30

250

180

0

250 180 0

32.5

250

130

0

250 130 0

35

252

65

0

252 65 0

37.5

255

0

0

255 0 0

40

251

34

124

251 34 124

45

248

68

248

248 68 248

50+

Wind Speed Alerts

R Value G Value B Value Color Legend Value (mph)

0

255

0

0 255 0

< 12

255

255

0

255 255 0

12-18

255

0

0

255 0 0

18-24

255

0

255

255 0 255

> 24

Changelog

This section describes document changes occurring in the two most recent versions.