Introduction

Welcome to the Iteris ClearAg Field Weather API. This API pairs the vast knowledge and experience of Iteris’ in-house meteorological team with highly advanced weather models and sensor data. The outcome for the end-user is a comprehensive database of valuable field-specific weather data, essential to making informed agricultural decisions.

Please note that before users can access the ClearAg Field Weather API, an active account and license key is required. These credentials will be provided for each service request. To obtain your API key, contact your Iteris account representative.

API Services

Through the ClearAg Field Weather API, users have access to location-specific weather data, provided globally and for climatological, historical, current, and forecast timeframes spanning from 1980 through nine days into the future. (Note that the Field Weather API does not currently provide the same amount of hourly historical data as daily. Please contact your sales representative for more information.)

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.

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

1. Current Conditions - v1.1

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

1.1. URL Description

http://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}

1.2. 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. 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, but will count as additional requests in the future.

1.3. 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.3

precipitation_descriptor

Precipitation descriptor data. Precipitation descriptor includes information about precipitation type, probability, and intensity when applicable.3

visibility_obstruction_descriptor

Visibility obstruction descriptor data. Visibility obstruction is the obscuration of one’s line of sight by some meteorological phenomenon.3

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.3

wind_direction_descriptor

Wind direction descriptor data.3

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.2

valid_time_start

Specifies the start time (Epoch time) of the period during which the current condition data were collected or created.2

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.

2 Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

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

1.4. Example Request

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

1.5. 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":"http://.../cover_cloudy.png",
                    "text":"Overcast"
                },
                "precipitation_descriptor":{
                    "code":60300,
                    "icon":"http://.../precip_rain.png",
                    "text":"Light Rain"
                },
                "visibility_obstruction_descriptor":{
                    "code":30000,
                    "icon":"http://.../visibility_hazeday.png",
                    "text":"Haze"
                },
                "weather_descriptor":{
                    "code":60300,
                    "icon":"http://.../precip_rain.png",
                    "text":"Light Rain"
                },
                "wind_direction_descriptor":{
                    "code":51500,
                    "icon":"http://.../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
            }
        }
    }
}

2. Hourly Forecast - v1.1

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

2.1. URL Description

http://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}

2.2. 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. 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, but will count as additional requests in the future.

2.3. 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).

cloud_cover_descriptor

Cloud cover descriptor data.3

precipitation_descriptor

Precipitation descriptor data. Precipitation descriptor includes information about precipitation type, probability, and intensity when applicable.3

visibility_obstruction_descriptor

Visibility obstruction descriptor data. Visibility obstruction is the obscuration of one’s line of sight by some meteorological phenomenon.3

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.3

wind_direction_descriptor

Wind direction descriptor data.3

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.2

valid_time_start

Valid start time (Epoch time) for the hourly period.2

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.

2 Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

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

2.4. Example Request

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

2.5. 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
            },
            "descriptors":{
                "cloud_cover_descriptor":{
                    "code":20300,
                    "icon":"http://.../cover_partlyclearday.png",
                    "text":"Partly Sunny"
                },
                "precipitation_descriptor":{
                    "code":10500,
                    "icon":"http://.../error_none.png",
                    "text":"None"
                },
                "visibility_obstruction_descriptor":{
                    "code":30000,
                    "icon":"http://.../visibility_hazeday.png",
                    "text":"Haze"
                },
                "weather_descriptor":{
                    "code":30000,
                    "icon":"http://.../visibility_hazeday.png",
                    "text":"Haze"
                },
                "wind_direction_descriptor":{
                    "code":51900,
                    "icon":"http://.../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
            }
        }
    }
}

3. 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.

3.1. URL Description

http://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}

3.2. 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. 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, but will count as additional requests in the future.

3.3. 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.3

precipitation_descriptor

Precipitation descriptor data. Precipitation descriptor includes information about precipitation type, probability, and intensity when applicable.3

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.3

wind_direction_descriptor

Wind direction descriptor data.3

wind_trend_descriptor

Wind trend descriptor data.3

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.

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

3.4. Example Request

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

3.5. 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":"http://.../cover_partlycloudyday.png",
                        "text":"Increasing Clouds"
                    },
                    "precipitation_descriptor":{
                        "code":10500,
                        "icon":"http://.../error_none.png",
                        "text":"None"
                    },
                    "weather_descriptor":{
                        "code":21107,
                        "icon":"http://.../cover_partlycloudyday.png",
                        "text":"Increasing Clouds"
                    },
                    "wind_direction_descriptor":{
                        "code":51600,
                        "icon":"http://.../direction_sw.png",
                        "text":"Southwest"
                    },
                    "wind_trend_descriptor":{
                        "code":10500,
                        "icon":"http://.../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":"http://.../cover_mostlycloudynight.png",
                        "text":"Mostly Cloudy"
                    },
                    "precipitation_descriptor":{
                        "code":61219,
                        "icon":"http://.../precip_snow.png",
                        "text":"Good Chance of Light Snow"
                    },
                    "weather_descriptor":{
                        "code":61219,
                        "icon":"http://.../precip_snow.png",
                        "text":"Good Chance of Light Snow"
                    },
                    "wind_direction_descriptor":{
                        "code":51500,
                        "icon":"http://.../direction_ssw.png",
                        "text":"South-Southwest"
                    },
                    "wind_trend_descriptor":{
                        "code":52009,
                        "icon":"http://.../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":"http://.../cover_partlycloudyday.png",
                        "text":"Increasing Clouds"
                    },
                    "precipitation_descriptor":{
                        "code":61113,
                        "icon":"http://.../precip_flurries.png",
                        "text":"Slight Chance of Flurries"
                    },
                    "weather_descriptor":{
                        "code":61113,
                        "icon":"http://.../precip_flurries.png",
                        "text":"Slight Chance of Flurries"
                    },
                    "wind_direction_descriptor":{
                        "code":51600,
                        "icon":"http://.../direction_sw.png",
                        "text":"Southwest"
                    },
                    "wind_trend_descriptor":{
                        "code":10500,
                        "icon":"http://.../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
                }
            }
        },...
    }
}

4. 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.

4.1. URL Description

http://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}

4.2. 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. 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, but will count as additional requests in the future.

4.3. 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.

4.4. Example Request

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

4.5. Example Response

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

5. 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.

5.1. URL Description

http://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}

5.2. 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. 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, but will count as additional requests in the future.

5.3. 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.3

precipitation_descriptor

Precipitation descriptor data. Precipitation descriptor includes information about precipitation type, probability, and intensity when applicable.3

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.3

wind_direction_descriptor

Wind direction descriptor data.3

wind_trend_descriptor

Wind trend descriptor data.3

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 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.

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

5.4. Example Request

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

5.5. 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":"http://.../cover_partlycloudyday.png",
                    "text":"Variable Clouds"
                },
                "precipitation_descriptor":{
                    "code":61113,
                    "icon":"http://.../precip_flurries.png",
                    "text":"Slight Chance of Flurries"
                },
                "weather_descriptor":{
                    "code":61113,
                    "icon":"http://.../precip_flurries.png",
                    "text":"Slight Chance of Flurries"
                },
                "wind_direction_descriptor":{
                    "code":51309,
                    "icon":"http://.../direction_sse.png",
                    "text":"Becoming South-Southeast"
                },
                "wind_trend_descriptor":{
                    "code":10500,
                    "icon":"http://.../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_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_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
            }
        },...
    }
}

6. Hourly Historical - v1.1

Through the Hourly Historical service, up to 240 hours of historical weather data are provided for a specified location.

6.1. URL Description

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

6.2. 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

timestamp

yes

Start time of the data returned.2

end

timestamp

yes

End time of the data returned.2

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. 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, but will count as additional requests in the future.

2 Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

6.3. 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.

cloud_cover_descriptor

Cloud cover descriptor data.3

precipitation_descriptor

Precipitation descriptor data. Precipitation descriptor includes information about precipitation type, probability, and intensity when applicable.3

visibility_obstruction_descriptor

Visibility obstruction descriptor data. Visibility obstruction is the obscuration of one’s line of sight by some meteorological phenomenon.3

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.3

wind_direction_descriptor

Wind direction descriptor data.3

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_period

Ice accumulation data (e.g., sleet or ice pellets).

liquid_acc_period

Liquid accumulation data (e.g., rain, drizzle, freezing rain, or freezing drizzle).

long_wave_radiation

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

precip_acc_period_adjusted

Liquid-equivalent precipitation accumulation, fundamentally derived from the raw precipitation product, but then adjusted to more closely match available ground truth observations. Due to the delays in receiving these ground truth data, accumulation adjustment typically lags real-time by a day or more.

precip_acc_period_raw

Liquid-equivalent precipitation accumulation, estimated from multiple sources of data that may include any or all of the following: weather radar, satellite, computer model, and surface observation data.

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_period

Snow accumulation data.

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

Valid end time (Epoch time) for the hourly period.2

valid_time_start

Valid start time (Epoch time) for the hourly period.2

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.

wind_direction

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_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.

2 Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

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

6.4. Example Request

http://ag.us.clearapis.com/v1.1/historical/hourly?app_id=123&app_key=321
&start=1392267600&end=1392271200&location=47.922759,-97.089954

6.5. Example Response

{
    "47.922759,-97.089954":{
        "hourly_historical:1392267600":{
            "air_temp":{
                "unit":"F",
                "value":13.0
            },
            "cloud_cover":{
                "unit":"%",
                "value":94.0
            },
            "descriptors":{
                "cloud_cover_descriptor":{
                    "code":20500,
                    "icon":"http://.../cover_cloudy.png",
                    "text":"Cloudy"
                },
                "precipitation_descriptor":{
                    "code":10500,
                    "icon":"http://.../error_none.png",
                    "text":"None"
                },
                "visibility_obstruction_descriptor":{
                    "code":10500,
                    "icon":"http://.../error_none.png",
                    "text":"None"
                },
                "weather_descriptor":{
                    "code":50400,
                    "icon":"http://.../windstrength_windy.png",
                    "text":"Breezy"
                },
                "wind_direction_descriptor":{
                    "code":51200,
                    "icon":"http://.../direction_se.png",
                    "text":"Southeast"
                }
            },
            "dew_point":{
                "unit":"F",
                "value":5.0
            },
            "ice_acc_period":{
                "unit":"in",
                "value":0.0
            },
            "liquid_acc_period":{
                "unit":"in",
                "value":0.0
            },
            "long_wave_radiation":{
                "unit":"W/m^2",
                "value":253.0
            },
            "precip_acc_period_adjusted":{
                "unit":"in",
                "value":0.06
            },
            "precip_acc_period_raw":{
                "unit":"in",
                "value":0.05
            },
            "relative_humidity":{
                "unit":"%",
                "value":71.0
            },
            "short_wave_radiation":{
                "unit":"W/m^2",
                "value":0.0
            },
            "snow_acc_period":{
                "unit":"in",
                "value":0.5
            },
            "u_wind_speed":{
                "unit":"mph",
                "value":-13.0
            },
            "v_wind_speed":{
                "unit":"mph",
                "value":19.0
            },
            "valid_time_end":1392271200,
            "valid_time_start":1392267600,
            "visibility":{
                "unit":"mi",
                "value":10.0
            },
            "wind_direction":{
                "unit":"degrees",
                "value":146.0
            },
            "wind_gust":{
                "unit":"n/a",
                "value":"n/a"
            },
            "wind_speed":{
                "unit":"mph",
                "value":23.0
            },
            "wind_speed_2m":{
                "unit":"mph",
                "value":17.0
            }
        }
    }
}

7. Hourly Historical Hail - v1.1

The Hourly Historical Hail service provides up to 240 hours of historical hail, radar reflectivity, and precipitation data for a specified location.

7.1. URL Description

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

7.2. 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

timestamp

yes

Start time of the data returned.2

end

timestamp

yes

End time of the data returned.2

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. 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, but will count as additional requests in the future.

2 Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

7.3. Response Object (JSON)

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

Field Description

hail_descriptor

Hail descriptor data, including a text string, icon URL, and numerical code representing the likelihood that hail fell.3

max_radar_refl

Maximum 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.

precip_acc_period_adjusted

Liquid-equivalent precipitation accumulation, fundamentally derived from the raw precipitation product, but then adjusted to more closely match available ground truth observations. Due to the delays in receiving these ground truth data, accumulation adjustment typically lags real-time by a day or more.

precip_acc_period_raw

Liquid-equivalent precipitation accumulation, estimated from multiple sources of data that may include any or all of the following: weather radar, satellite, computer model, and surface observation data.

valid_time_end

Valid end time (Epoch time) for the hourly period.2

valid_time_start

Valid start time (Epoch time) for the hourly period.2

2 Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

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

7.4. Example Request

http://ag.us.clearapis.com/v1.1/historical/hourly/hail?app_id=123&app_key=321
&start=1405990800&end=1405994400&location=47.922759,-97.089954

7.5. Example Response

{
    "47.922759,-97.089954":{
        "hourly_historical_hail:1405990800":{
            "descriptors":{
                "hail_descriptor":{
                    "code":80000,
                    "icon":"http://.../error_datanotavailable.png",
                    "text":"Minimal or No Hail"
                }
            },
            "max_radar_refl":{
                "unit":"dBZ",
                "value":51.0
            },
            "precip_acc_period_adjusted":{
                "unit":"in",
                "value":2.21
            },
            "precip_acc_period_raw":{
                "unit":"in",
                "value":1.16
            },
            "valid_time_end":1405994400,
            "valid_time_start":1405990800
        }
    }
}

8. Hourly Spray Conditions - v1.0

The Hourly Spray Conditions endpoint retrieves and displays up to 240 hours of historical and forecast data, useful for evaluating suitability for spraying.

8.1. URL Description

http://ag.us.clearapis.com/v1.0/hourly/spray_conditions?
app_id={string}&app_key={string}&location={lat, lon coordinates}
&start={timestamp}&end={timestamp}&unitcode={string}&lang={string}

8.2. 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. Users are allowed a maximum of five coordinates,1 formatted as “&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)].”

start

timestamp

yes

Query start time.2 Maximum is 240 hours into the future.

end

timestamp

yes

Query end time.2 Maximum is 240 hours into the future.

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.

1 Additional coordinates are not counted against a client’s account, but will count as additional requests in the future.

2 Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

8.3. Response Object (JSON)

Field Description

air_temp

Air temperature at two meters above ground level.

canopy_wetness_classification

A text value representation of the overall canopy wetness. Possible values include "Dry", "Marginal", and "Wet".

canopy_wetness_id

An enumerated representation of the overall canopy wetness. Possible values include "1" ("Dry"), "2" ("Marginal"), and "3" ("Wet").

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.

inversion_risk

Likelihood of a thermal inversion based on near-surface lapse rates. Possible values include "low", "medium", and "high".

lapse_rate_0to2m

Change in temperature from the surface to two meters above ground level. Negative if temperature decreases with increasing altitude; positive if temperature increases with increasing altitude. Note that lapse rate units are K/m regardless of unitcode setting.

lapse_rate_2to80m

Change in temperature from two to 80 meters above ground level. Negative if temperature decreases with increasing altitude; positive if temperature increases with increasing altitude. Note that lapse rate units are K/m regardless of unitcode setting.

precip_prob

Probability of precipitation. Probabilities of no more than 40-50% are recommended for determining rain-free hours. Generally expected to be “n/a” for historical timeframes.

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.

valid_time_end

End time of the period, expessed as a Unix timestamp.2

valid_time_start

Start time of the period, expressed as a Unix timestamp.2

wind_direction

Wind direction, 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 two meters above ground level. “n/a” if less than 5.0 mph stronger than wind speed.

wind_speed

Wind speed at two meters above ground level.

2 Please refer to section [1.4 Epoch/Unix Timestamp] of the Appendix for Iteris' definition of Epoch/Unix timestamp.

8.4. Example Request

http://ag.us.clearapis.com/v1.0/hourly/spray_conditions?
location=47,-97&start=1502985600&end=1502989200

8.5. Example Response

{
    "47,-97":{
        "1502985600":{
            "air_temp":{
                "unit":"F",
                "value":68.0
            },
            "canopy_wetness_classification":{
                "unit":"n/a",
                "value":"Wet"
            },
            "canopy_wetness_id":{
                "unit":"n/a",
                "value":3
            },
            "delta_t":{
                "unit":"F",
                "value":4.0
            },
            "inversion_risk":{
                "unit":"n/a",
                "value":"low"
            },
            "lapse_rate_0to2m":{
                "unit":"K/m",
                "value":-2.84
            },
            "lapse_rate_2to80m":{
                "unit":"K/m",
                "value":-0.0199
            },
            "precip_prob":{
                "unit":"%",
                "value":0.0
            },
            "relative_humidity":{
                "unit":"%",
                "value":84.0
            },
            "valid_time_end":1502989200,
            "valid_time_start":1502985600,
            "wind_direction":{
                "unit":"degrees",
                "value":360.0
            },
            "wind_gust":{
                "unit":"mph",
                "value":22.0
            },
            "wind_speed":{
                "unit":"mph",
                "value":14.0
            }
        }
    }
}

9. Daily Historical - v1.2

The Daily Historical service provides up to 366 days of historical weather data for a specified location. Data are valid from midnight to 11:59 p.m. in the time zone of the location queried.

9.1. URL Description

http://ag.us.clearapis.com/v1.2/historical/daily?app_id={string}&app_key={string}
&start={timestamp}&end={timestamp}&location={lat, lon coordinates}
&unitcode={string}&lang={string}&icon_resolution={string}
&icon_style={string}&icon_version={string}

9.2. 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

timestamp

yes

Start time of the data returned.2

end

timestamp

yes

End time of the data returned.2

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. 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, but will count as additional requests in the future.

2 Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

9.3. Response Object (JSON)

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

Field Description

air_temp_avg

Average air temperature.

air_temp_max

Maximum air temperature.

air_temp_min

Minimum air temperature.

cloud_cover_avg

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

cloud_cover_max

Maximum cloud cover data.

cloud_cover_min

Minimum cloud cover data.

cloud_cover_avg_descriptor

Descriptor data for average daily cloud cover.3

cloud_cover_max_descriptor

Descriptor data for maximum daily cloud cover.3

cloud_cover_min_descriptor

Descriptor data for minimum daily cloud cover.3

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

24-hour ice accumulation data (e.g., sleet or ice pellets).

liquid_acc_period

24-hour liquid accumulation data (e.g., rain, drizzle, freezing rain, or freezing drizzle).

long_wave_radiation_avg

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

long_wave_radiation_max

Maximum downwelling longwave radiation flux data.

long_wave_radiation_min

Minimum downwelling longwave radiation flux data.

pet_period

24-hr 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_adjusted

Liquid-equivalent precipitation accumulation, fundamentally derived from the raw precipitation product, but then adjusted to more closely match available ground truth observations. Due to the delays in receiving these ground truth data, accumulation adjustment typically lags real-time by a day or more.

precip_acc_period_raw

Liquid-equivalent precipitation accumulation, estimated from multiple sources of data that may include any or all of the following: weather radar, satellite, computer model, and surface observation data.

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.

short_wave_radiation_max

Maximum downwelling shortwave radiation flux data.

short_wave_radiation_min

Minimum downwelling shortwave radiation flux data.

snow_acc_period

24-hour snow accumulation data, 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.

visibility_avg

Average 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.

visibility_max

Maximum visibility data.

visibility_min

Minimum visibility data.

wind_gust_max

Maximum wind gust at 10 meters above ground level.

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.

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

9.4. Example Request

http://ag.us.clearapis.com/v1.2/historical/daily?app_id=123&app_key=321
&start=1401580800&end=1401667200&location=47.922759,-97.089954

9.5. Example Response

{
    "47.922759,-97.089954":{
        "2014-05-31":{
            "air_temp_avg":{
                "unit":"F",
                "value":69.0
            },
            "air_temp_max":{
                "unit":"F",
                "value":78.0
            },
            "air_temp_min":{
                "unit":"F",
                "value":59.0
            },
            "cloud_cover_avg":{
                "unit":"%",
                "value":89.8
            },
            "cloud_cover_max":{
                "unit":"%",
                "value":100.0
            },
            "cloud_cover_min":{
                "unit":"%",
                "value":57.6
            },
            "descriptors":{
                "cloud_cover_avg_descriptor":{
                    "code":20400,
                    "icon":"http://.../cover_mostlycloudyday.png",
                    "text":"Mostly Cloudy"
                },
                "cloud_cover_max_descriptor":{
                    "code":20500,
                    "icon":"http://.../cover_cloudy.png",
                    "text":"Cloudy"
                },
                "cloud_cover_min_descriptor":{
                    "code":20300,
                    "icon":"http://.../cover_partlyclearday.png",
                    "text":"Partly Sunny"
                }
            },
            "dew_point_avg":{
                "unit":"F",
                "value":59.0
            },
            "dew_point_max":{
                "unit":"F",
                "value":63.0
            },
            "dew_point_min":{
                "unit":"F",
                "value":10.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":393.0
            },
            "long_wave_radiation_max":{
                "unit":"W/m^2",
                "value":420.0
            },
            "long_wave_radiation_min":{
                "unit":"W/m^2",
                "value":366.0
            },
            "pet_period":{
                "unit":"in",
                "value":0.11
            },
            "precip_acc_period_adjusted":{
                "unit":"in",
                "value":0.0
            },
            "precip_acc_period_raw":{
                "unit":"in",
                "value":0.0
            },
            "relative_humidity_avg":{
                "unit":"%",
                "value":74.0
            },
            "relative_humidity_max":{
                "unit":"%",
                "value":99.0
            },
            "relative_humidity_min":{
                "unit":"%",
                "value":13.0
            },
            "short_wave_radiation_avg":{
                "unit":"W/m^2",
                "value":154.0
            },
            "short_wave_radiation_max":{
                "unit":"W/m^2",
                "value":546.0
            },
            "short_wave_radiation_min":{
                "unit":"W/m^2",
                "value":0.0
            },
            "snow_acc_period":{
                "unit":"in",
                "value":0.0
            },
            "sunshine_duration":{
                "unit":"hours",
                "value":7
            },
            "visibility_avg":{
                "unit":"mi",
                "value":10.0
            },
            "visibility_max":{
                "unit":"mi",
                "value":10.0
            },
            "visibility_min":{
                "unit":"mi",
                "value":1.0
            },
            "wind_gust_max":{
                "unit":"mph",
                "value":20.0
            },
            "wind_speed_2m_avg":{
                "unit":"mph",
                "value":8.0
            },
            "wind_speed_2m_max":{
                "unit":"mph",
                "value":13.0
            },
            "wind_speed_2m_min":{
                "unit":"mph",
                "value":3.0
            },
            "wind_speed_avg":{
                "unit":"mph",
                "value":10.0
            },
            "wind_speed_max":{
                "unit":"mph",
                "value":17.0
            },
            "wind_speed_min":{
                "unit":"mph",
                "value":4.0
            }
        }
    }
}

10. Daily Historical Air Temperature - v1.2

The Daily Historical Air Temperature service provides up to 366 days of historical air temperature data for a specified location. Data are valid from midnight to 11:59 p.m. in the time zone of the location queried.

10.1. URL Description

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

10.2. 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

timestamp

yes

Start time of the data being returned.2

end

timestamp

yes

End time of the data being returned.2

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. 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, but will count as additional requests in the future.

2 Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

10.3. 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.

10.4. Example Request

http://ag.us.clearapis.com/v1.2/historical/daily/air_temp?app_id=123&app_key=321
&location=47,-97&start=1388534400&end=1393718400

10.5. Example Response

{
    "47,-97":{
        "2014-01-01":{
            "air_temp_max":{
                "unit":"F",
                "value":-7.0
            },
            "air_temp_min":{
                "unit":"F",
                "value":-20.0
            }
        },...
    }
}

11. Daily Historical Ag Weather - v1.0

The Daily Historical Ag Weather endpoint provides up to 366 days of historical weather data geared toward agricultural applications. Data are valid from midnight to 11:59 p.m. in the time zone of the location queried.

11.1. URL Description

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

11.2. 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

timestamp

yes

Start time of the data returned.2

end

timestamp

yes

End time of the data returned.2

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. 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, but will count as additional requests in the future.

2 Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

11.3. 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_max

Maximum cloud cover data.

cloud_cover_min

Minimum cloud cover data.

cloud_cover_avg_descriptor

Descriptor data for average daily cloud cover.3

cloud_cover_max_descriptor

Descriptor data for maximum daily cloud cover.3

cloud_cover_min_descriptor

Descriptor data for minimum daily cloud cover.3

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

24-hour ice accumulation data (e.g., sleet or ice pellets).

liquid_acc_period

24-hour liquid accumulation data (e.g., rain, drizzle, freezing rain, or freezing drizzle).

long_wave_radiation_avg

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

long_wave_radiation_max

Maximum downwelling longwave radiation flux data.

long_wave_radiation_min

Minimum downwelling longwave radiation flux data.

pet_period

24-hr 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_adjusted

Liquid-equivalent precipitation accumulation, fundamentally derived from the raw precipitation product, but then adjusted to more closely match available ground truth observations. Due to the delays in receiving these ground truth data, accumulation adjustment typically lags real-time by a day or more.

precip_acc_period_raw

Liquid-equivalent precipitation accumulation, estimated from multiple sources of data that may include any or all of the following: weather radar, satellite, computer model, and surface observation data.

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.

short_wave_radiation_max

Maximum downwelling shortwave radiation flux data.

short_wave_radiation_min

Minimum downwelling shortwave radiation flux data.

snow_acc_period

24-hour snow accumulation data, 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.

visibility_avg

Average 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.

visibility_max

Maximum visibility data.

visibility_min

Minimum visibility data.

wind_gust_max

Maximum wind gust at 10 meters above ground level.

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.

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

11.4. Example Request

http://ag.us.clearapis.com/v1.0/historical/daily/ag_weather?app_id=123&app_key=321
&start=1401580800&end=1401667200&location=47.922759,-97.089954

11.5. Example Response

{
    "47.922759,-97.089954":{
        "2014-06-01":{
            "air_temp_5cm_avg":{
                "unit":"F",
                "value":69.0
            },
            "air_temp_5cm_max":{
                "unit":"F",
                "value":79.0
            },
            "air_temp_5cm_min":{
                "unit":"F",
                "value":60.0
            },
            "air_temp_avg":{
                "unit":"F",
                "value":68.0
            },
            "air_temp_max":{
                "unit":"F",
                "value":77.0
            },
            "air_temp_min":{
                "unit":"F",
                "value":59.0
            },
            "cloud_cover_avg":{
                "unit":"%",
                "value":89.8
            },
            "cloud_cover_max":{
                "unit":"%",
                "value":100.0
            },
            "cloud_cover_min":{
                "unit":"%",
                "value":57.5
            },
            "descriptors":{
                "cloud_cover_avg_descriptor":{
                    "code":20900,
                    "icon":"http://.../cover_mostlycloudyday.png",
                    "text":"Broken Overcast"
                },
                "cloud_cover_max_descriptor":{
                    "code":21000,
                    "icon":"http://.../cover_cloudy.png",
                    "text":"Overcast"
                },
                "cloud_cover_min_descriptor":{
                    "code":20800,
                    "icon":"http://.../cover_partlycloudyday.png",
                    "text":"Scattered Clouds"
                }
            },
            "dew_point_avg":{
                "unit":"F",
                "value":61.0
            },
            "dew_point_max":{
                "unit":"F",
                "value":65.0
            },
            "dew_point_min":{
                "unit":"F",
                "value":58.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":394.0
            },
            "long_wave_radiation_max":{
                "unit":"W/m^2",
                "value":420.0
            },
            "long_wave_radiation_min":{
                "unit":"W/m^2",
                "value":366.0
            },
            "pet_period":{
                "unit":"in",
                "value":0.13
            },
            "precip_acc_period_adjusted":{
                "unit":"in",
                "value":0.0
            },
            "precip_acc_period_raw":{
                "unit":"in",
                "value":0.01
            },
            "relative_humidity_avg":{
                "unit":"%",
                "value":80.0
            },
            "relative_humidity_max":{
                "unit":"%",
                "value":98.0
            },
            "relative_humidity_min":{
                "unit":"%",
                "value":60.0
            },
            "short_wave_radiation_avg":{
                "unit":"W/m^2",
                "value":160.0
            },
            "short_wave_radiation_max":{
                "unit":"W/m^2",
                "value":546.0
            },
            "short_wave_radiation_min":{
                "unit":"W/m^2",
                "value":0.0
            },
            "snow_acc_period":{
                "unit":"in",
                "value":0.0
            },
            "sunshine_duration":{
                "unit":"hours",
                "value":13
            },
            "visibility_avg":{
                "unit":"mi",
                "value":10.0
            },
            "visibility_max":{
                "unit":"mi",
                "value":10.0
            },
            "visibility_min":{
                "unit":"mi",
                "value":1.0
            },
            "wind_gust_max":{
                "unit":"mph",
                "value":20.0
            },
            "wind_speed_2m_avg":{
                "unit":"mph",
                "value":6.0
            },
            "wind_speed_2m_max":{
                "unit":"mph",
                "value":11.0
            },
            "wind_speed_2m_min":{
                "unit":"mph",
                "value":3.0
            },
            "wind_speed_avg":{
                "unit":"mph",
                "value":8.0
            },
            "wind_speed_max":{
                "unit":"mph",
                "value":14.0
            },
            "wind_speed_min":{
                "unit":"mph",
                "value":4.0
            }
        }
    }
}

12. Daily Historical Hail - v1.2

The Daily Historical Hail service provides up to 366 days of historical hail, radar reflectivity, and precipitation data for a specified location. Data are valid from midnight to 11:59 p.m. in the time zone of the location queried.

12.1. URL Description

http://ag.us.clearapis.com/v1.2/historical/daily/hail?app_id={string}&app_key={string}
&start={timestamp}&end={timestamp}&location={lat, lon coordinates}
&unitcode={string}&lang={string}&icon_resolution={string}
&icon_style={string}&icon_version={string}

12.2. 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

timestamp

yes

Start time of the data returned.2

end

timestamp

yes

End time of the data returned.2

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. 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, but will count as additional requests in the future.

2 Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

12.3. Response Object (JSON)

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

Field Description

hail_descriptor

Hail descriptor data, including a text string, icon URL, and numerical code representing the likelihood that hail fell.3

max_radar_refl

Maximum 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.

precip_acc_period_adjusted

Liquid-equivalent precipitation accumulation, fundamentally derived from the raw precipitation product, but then adjusted to more closely match available ground truth observations. Due to the delays in receiving these ground truth data, accumulation adjustment typically lags real-time by a day or more.

precip_acc_period_raw

Liquid-equivalent precipitation accumulation, estimated from multiple sources of data that may include any or all of the following: weather radar, satellite, computer model, and surface observation data.

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

12.4. Example Request

http://ag.us.clearapis.com/v1.2/historical/daily/hail?app_id=123&app_key=321
&start=1405900800&end=1405987200&location=47.922759,-97.089954

12.5. Example Response

{
    "47.922759,-97.089954":{
        "2014-07-21":{
            "descriptors":{
                "hail_descriptor":{
                    "code":80000,
                    "icon":"http://.../error_datanotavailable.png",
                    "text":"Minimal or No Hail"
                }
            },
            "max_radar_refl":{
                "unit":"dBZ",
                "value":51.0
            },
            "precip_acc_period_adjusted":{
                "unit":"in",
                "value":3.5
            },
            "precip_acc_period_raw":{
                "unit":"in",
                "value":1.83
            }
        }
    }
}

13. Daily Historical Climatology - v1.3

The Daily Historical Climatology endpoint provides daily weather climatology of the past 30 complete years. Data are valid from midnight to 11:59 p.m. in the time zone of the location queried.

13.1. URL Description

http://ag.us.clearapis.com/v1.3/historical/daily/climatology?app_id={string}
&app_key={string}&location={lat, lon coordinates}&start_date={string}
&end_date={string}&unitcode={string}

13.2. 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. Users are allowed a maximum of five coordinates,1 formatted as “&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)].”

start_date

string

yes

String representing the start date of data to be returned, which must be formatted as MM-DD or YYYY-MM-DD. If a year is not specified, only dates valid for the current year will be returned. If an additional date resulting from a leap year is desired, specify a year in which a leap year occurs. If a date range spanning beyond a single contiguous year is desired, a year must be specified.

end_date

string

yes

String representing the end date of data to be returned, which must be formatted as MM-DD or YYYY-MM-DD. Year must be specified if start_date contains a year.

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, but will count as additional requests in the future.

13.3. Response Object (JSON)

The response may vary based on the unit code selected.

Field Description

air_temp_avg

Average of daily average air temperature values.

air_temp_stddev

Standard deviation of daily average air temperature values.

dew_point_avg

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

dew_point_stddev

Standard deviation of daily average dew point temperature values.

long_wave_radiation_avg

Average of daily average downwelling longwave radiation flux values. Longwave radiation is the energy emitted from non-solar radiation sources.

long_wave_radiation_stddev

Standard deviation of daily average longwave radiation flux values.

air_temp_max_avg

Average of daily maximum air temperature values.

air_temp_max_stddev

Standard deviation of daily maximum air temperature values.

air_temp_min_avg

Average of daily minimum air temperature values.

air_temp_min_stddev

Standard deviation of daily minimum air temperature values.

pet_avg

Average of daily reference evapotranspiration values. 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_avg

Average of daily accumulated liquid-equivalent precipitation values.

short_wave_radiation_avg

Average of daily average downwelling shortwave radiation flux values. Shortwave radiation is the high-energy solar radiation that reaches Earth’s surface.

short_wave_radiation_stddev

Standard deviation of daily average shortwave radiation flux values.

station_pressure_avg

Average of daily average surface barometric pressure values.

station_pressure_stddev

Standard deviation of daily average surface barometric pressure values.

wind_speed_avg

Average of daily average 10-meter wind speed values.

wind_speed_stddev

Standard deviation of daily average 10-meter wind speed values.

13.4. Example Request

http://ag.us.clearapis.com/v1.3/historical/daily/climatology?app_id=123&app_key=321
&location=46.77,-100.75&start_date=07-01&end_date=07-02

13.5. Example Response

{
    "46.77,-100.75":{
        "07-01":{
            "air_temp_avg":{
                "unit":"F",
                "value":70.0
            },
            "air_temp_stddev":{
                "unit":"F",
                "value":6.0
            },
            "dew_point_avg":{
                "unit":"F",
                "value":56.0
            },
            "dew_point_stddev":{
                "unit":"F",
                "value":6.0
            },
            "long_wave_radiation_avg":{
                "unit":"W/m^2",
                "value":359.0
            },
            "long_wave_radiation_stddev":{
                "unit":"W/m^2",
                "value":21.0
            },
            "air_temp_max_avg":{
                "unit":"F",
                "value":39.0
            },
            "air_temp_max_stddev":{
                "unit":"F",
                "value":13.0
            },
            "air_temp_min_avg":{
                "unit":"F",
                "value":24.0
            },
            "air_temp_min_stddev":{
                "unit":"F",
                "value":12.0
            },
            "pet_avg":{
                "unit":"in",
                "value":0.22
            },
            "precip_acc_avg":{
                "unit":"in",
                "value":0.12
            },
            "short_wave_radiation_avg":{
                "unit":"W/m^2",
                "value":288.0
            },
            "short_wave_radiation_sddev":{
                "unit":"W/m^2",
                "value":49.0
            },
            "station_pressure_avg":{
                "unit":"mb",
                "value":953.0
            },
            "station_pressure_stddev":{
                "unit":"mb",
                "value":5.0
            },
            "wind_speed_avg":{
                "unit":"mph",
                "value":9.0
            },
            "wind_speed_stddev":{
                "unit":"mph",
                "value":3.0
            }
        }
    }
}

14. Daily Historical 5-Year Climatology - v1.0

The Daily Historical 5-Year Climatology endpoint provides daily weather climatology of the past five complete years. Data are valid from midnight to 11:59 p.m. in the time zone of the location queried.

14.1. URL Description

http://ag.us.clearapis.com/v1.0/historical/daily/climatology/five_year?
app_id={string}&app_key={string}&location={lat, lon coordinates}
&start_date={string}&end_date={string}&unitcode={string}

14.2. 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. Users are allowed a maximum of five coordinates,1 formatted as “&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)].”

start_date

string

yes

String representing the start date of data to be returned, which must be formatted as MM-DD or YYYY-MM-DD. If a year is not specified, only dates valid for the current year will be returned. If an additional date resulting from a leap year is desired, specify a year in which a leap year occurs. If a date range spanning beyond a single contiguous year is desired, a year must be specified.

end_date

string

yes

String representing the end date of data to be returned, which must be formatted as MM-DD or YYYY-MM-DD. Year must be specified if start_date contains a year.

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, but will count as additional requests in the future.

14.3. Response Object (JSON)

The response may vary based on the unit code selected.

Field Description

air_temp_avg

Average of daily average air temperature values.

air_temp_stddev

Standard deviation of daily average air temperature values.

dew_point_avg

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

dew_point_stddev

Standard deviation of daily average dew point temperature values.

long_wave_radiation_avg

Average of daily average downwelling longwave radiation flux values. Longwave radiation is the energy emitted from non-solar radiation sources.

long_wave_radiation_stddev

Standard deviation of daily average longwave radiation flux values.

air_temp_max_avg

Average of daily maximum air temperature values.

air_temp_max_stddev

Standard deviation of daily maximum air temperature values.

air_temp_min_avg

Average of daily minimum air temperature values.

air_temp_min_stddev

Standard deviation of daily minimum air temperature values.

pet_avg

Average of daily reference evapotranspiration values. 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_avg

Average of daily accumulated liquid-equivalent precipitation values.

short_wave_radiation_avg

Average of daily average downwelling shortwave radiation flux values. Shortwave radiation is the high-energy solar radiation that reaches Earth’s surface.

short_wave_radiation_stddev

Standard deviation of daily average shortwave radiation flux values.

station_pressure_avg

Average of daily average surface barometric pressure values.

station_pressure_stddev

Standard deviation of daily average surface barometric pressure values.

wind_speed_avg

Average of daily average 10-meter wind speed values.

wind_speed_stddev

Standard deviation of daily average 10-meter wind speed values.

14.4. Example Request

http://ag.us.clearapis.com/v1.0/historical/daily/climatology/five_year?
app_id=123&app_key=321&location=47,-97&start_date=01-01&end_date=01-01

14.5. Example Response

{
    "47,-97":{
        "01-01":{
            "air_temp_avg":{
                "unit":"F",
                "value":8.0
            },
            "air_temp_max_avg":{
                "unit":"F",
                "value":16.0
            },
            "air_temp_max_stddev":{
                "unit":"F",
                "value":14.0
            },
            "air_temp_min_avg":{
                "unit":"F",
                "value":-1.0
            },
            "air_temp_min_stddev":{
                "unit":"F",
                "value":12.0
            },
            "air_temp_stddev":{
                "unit":"F",
                "value":13.0
            },
            "dew_point_avg":{
                "unit":"F",
                "value":2.0
            },
            "dew_point_stddev":{
                "unit":"F",
                "value":13.0
            },
            "long_wave_radiation_avg":{
                "unit":"W/m^2",
                "value":217.0
            },
            "long_wave_radiation_stddev":{
                "unit":"W/m^2",
                "value":32.0
            },
            "pet_avg":{
                "unit":"in",
                "value":0.01
            },
            "precip_acc_avg":{
                "unit":"in",
                "value":0.02
            },
            "short_wave_radiation_avg":{
                "unit":"W/m^2",
                "value":60.0
            },
            "short_wave_radiation_stddev":{
                "unit":"W/m^2",
                "value":10.0
            },
            "station_pressure_avg":{
                "unit":"mb",
                "value":986.0
            },
            "station_pressure_stddev":{
                "unit":"mb",
                "value":8.0
            },
            "wind_speed_avg":{
                "unit":"mph",
                "value":7.0
            },
            "wind_speed_stddev":{
                "unit":"mph",
                "value":4.0
            }
        }
    }
}

15. Daily Historical 10-Year Climatology - v1.0

The Daily Historical 10-Year Climatology endpoint provides daily weather climatology of the past 10 complete years. Data are valid from midnight to 11:59 p.m. in the time zone of the location queried.

15.1. URL Description

http://ag.us.clearapis.com/v1.0/historical/daily/climatology/ten_year?
app_id={string}&app_key={string}&location={lat, lon coordinates}
&start_date={string}&end_date={string}&unitcode={string}

15.2. 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. Users are allowed a maximum of five coordinates,1 formatted as “&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)].”

start_date

string

yes

String representing the start date of data to be returned, which must be formatted as MM-DD or YYYY-MM-DD. If a year is not specified, only dates valid for the current year will be returned. If an additional date resulting from a leap year is desired, specify a year in which a leap year occurs. If a date range spanning beyond a single contiguous year is desired, a year must be specified.

end_date

string

yes

String representing the end date of data to be returned, which must be formatted as MM-DD or YYYY-MM-DD. Year must be specified if start_date contains a year.

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, but will count as additional requests in the future.

15.3. Response Object (JSON)

The response may vary based on the unit code selected.

Field Description

air_temp_avg

Average of daily average air temperature values.

air_temp_stddev

Standard deviation of daily average air temperature values.

dew_point_avg

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

dew_point_stddev

Standard deviation of daily average dew point temperature values.

long_wave_radiation_avg

Average of daily average downwelling longwave radiation flux values. Longwave radiation is the energy emitted from non-solar radiation sources.

long_wave_radiation_stddev

Standard deviation of daily average longwave radiation flux values.

air_temp_max_avg

Average of daily maximum air temperature values.

air_temp_max_stddev

Standard deviation of daily maximum air temperature values.

air_temp_min_avg

Average of daily minimum air temperature values.

air_temp_min_stddev

Standard deviation of daily minimum air temperature values.

pet_avg

Average of daily reference evapotranspiration values. 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_avg

Average of daily accumulated liquid-equivalent precipitation values.

short_wave_radiation_avg

Average of daily average downwelling shortwave radiation flux values. Shortwave radiation is the high-energy solar radiation that reaches Earth’s surface.

short_wave_radiation_stddev

Standard deviation of daily average shortwave radiation flux values.

station_pressure_avg

Average of daily average surface barometric pressure values.

station_pressure_stddev

Standard deviation of daily average surface barometric pressure values.

wind_speed_avg

Average of daily average 10-meter wind speed values.

wind_speed_stddev

Standard deviation of daily average 10-meter wind speed values.

15.4. Example Request

http://ag.us.clearapis.com/v1.0/historical/daily/climatology/ten_year?
app_id=123&app_key=321&location=47,-97&start_date=01-01&end_date=01-01

15.5. Example Response

{
    "47,-97":{
        "01-01":{
            "air_temp_avg":{
                "unit":"F",
                "value":8.0
            },
            "air_temp_max_avg":{
                "unit":"F",
                "value":16.0
            },
            "air_temp_max_stddev":{
                "unit":"F",
                "value":13.0
            },
            "air_temp_min_avg":{
                "unit":"F",
                "value":0.0
            },
            "air_temp_min_stddev":{
                "unit":"F",
                "value":14.0
            },
            "air_temp_stddev":{
                "unit":"F",
                "value":13.0
            },
            "dew_point_avg":{
                "unit":"F",
                "value":3.0
            },
            "dew_point_stddev":{
                "unit":"F",
                "value":14.0
            },
            "long_wave_radiation_avg":{
                "unit":"W/m^2",
                "value":217.0
            },
            "long_wave_radiation_stddev":{
                "unit":"W/m^2",
                "value":33.0
            },
            "pet_avg":{
                "unit":"in",
                "value":0.01
            },
            "precip_acc_avg":{
                "unit":"in",
                "value":0.03
            },
            "short_wave_radiation_avg":{
                "unit":"W/m^2",
                "value":61.0
            },
            "short_wave_radiation_stddev":{
                "unit":"W/m^2",
                "value":12.0
            },
            "station_pressure_avg":{
                "unit":"mb",
                "value":986.0
            },
            "station_pressure_stddev":{
                "unit":"mb",
                "value":10.0
            },
            "wind_speed_avg":{
                "unit":"mph",
                "value":8.0
            },
            "wind_speed_stddev":{
                "unit":"mph",
                "value":5.0
            }
        }
    }
}

16. Frost Risk - v1.0

The Frost Risk endpoint provides daily frost risk climatology of the past 30 complete years. Data are valid from midnight to 11:59 p.m. in the time zone of the location queried.

16.1. URL Description

http://ag.us.clearapis.com/v1.0/historical/daily/climatology/frost_risk?
app_id={string}&app_key={string}&location={lat, lon coordinates}
&start_date={string}&end_date={string}&unitcode={string}

16.2. 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. Users are allowed a maximum of five coordinates,1 formatted as “&location=[(<lat_1>,<lon_1>),(<lat_2>,<lon_2>)].”

start_date

string

yes

String representing the start date of data to be returned, which must be formatted as MM-DD or YYYY-MM-DD. If a year is not specified, only dates valid for the current year will be returned. If an additional date resulting from a leap year is desired, specify a year in which a leap year occurs. If a date range spanning beyond a single contiguous year is desired, a year must be specified.

end_date

string

yes

String representing the end date of data to be returned, which must be formatted as MM-DD or YYYY-MM-DD. Year must be specified if start_date contains a year.

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, but will count as additional requests in the future.

16.3. Response Object (JSON)

Field Description

frost_probability_cumulative

Cumulative percent probability of frost. Calculated by stepping forward or backward in time from the day of the year having the climatologically warmest minimum daily air temperature and taking a ratio of the cumulative number of years a given date experienced a minimum temperature less than or equal to freezing, to the total number of years of the climatology (30).

16.4. Example Request

http://ag.us.clearapis.com/v1.0/historical/daily/climatology/frost_risk?app_id=123
&app_key=321&location=47,-97&start_date=05-01&end_date=05-01

16.5. Example Response

{
    "47,-97":{
        "05-01":{
            "frost_probability_cumulative":{
                "unit":"%",
                "value":66.0
            }
        }
    }
}

17. Precipitation Summary - v1.0

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

17.1. URL Description

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

17.2. 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. 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, but will count as additional requests in the future.

17.3. 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 60 minutes.

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.

17.4. Example Request

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

17.5. 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":1430865300,
                "valid_time_start":1430861400,
                "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
                }
            },...
        ]
    }
}

18. Daily Historical Precipitation - v1.1

The Daily Historical Precipitation endpoint provides up to 366 days of daily historical precipitation totals for a specified location. Data are valid from midnight to 11:59 p.m. in the time zone of the location queried.

18.1. URL Description

http://ag.us.clearapis.com/v1.1/historical/daily/precip?app_id={string}
&app_key={string}&start={timestamp}&end={timestamp}
&location={lat, lon coordinates}&unitcode={string}

18.2. 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

timestamp

yes

Start time of the data returned.2

end

timestamp

yes

End time of the data returned.2

location

lat, lon coordinates

yes

User-provided latitude and longitude coordinates in decimal degrees. 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, but will count as additional requests in the future.

2 Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris’ definition of Epoch/Unix timestamp.

18.3. Response Object (JSON)

Field Description

precip_acc_period

24-hour liquid-equivalent precipitation total.

2 Please refer to the Epoch/Unix Timestamp section of the Appendix for Iteris' definition of Epoch/Unix timestamp.

18.4. Example Request

http://ag.us.clearapis.com/v1.1/historical/daily/precip?app_id=123&app_key=321
&start=1401580800&end=1401667200&location=47.922759,-97.089954

18.5. Example Response

{
    "47.922759,-97.089954":{
        "2014-06-01":{
            "precip_acc_period":{
                "unit":"in",
                "value":0.0
            }
        },...
    }
}

19. 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.

19.1. URL Description

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

19.2. 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. 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, but will count as additional requests in the future.

19.3. 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.

19.4. Example Request

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

19.5. 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
            }
        ]
    }
}

20. 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.

20.1. URL Description

http://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}

20.2. 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. 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, but will count as additional requests in the future.

20.3. 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.

20.4. Example Request

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

20.5. Example Response

{
    "47,-97":{
        "descriptors:[
            {
                "precipitation_type_descriptor":{
                    "code":60500,
                    "icon":"http://.../precip_rain.png",
                    "text":"Rain"
                },
                "radar_refl_confidence_descriptor":{
                    "code":10900,
                    "icon":"http://.../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
            },...
        ]
    }
}

Appendix

Appendix A: Supplementary API Information

A.1. 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.

A.2. 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.

A.3. Parameter Units

Below is a listing of weather parameter units that appear in the API endpoints, including a description of each and a listing of the associated parameter types.

System of units Parameter unit What it stands for Associated parameters

US-std

F

Degrees Fahrenheit

temperature, dew point temperature

SI-std

C

Degrees Celsius

temperature, dew point temperature

US-std & SI-std

%

Percent

cloud cover, forecast confidence, relative humidity

US-std

In

Inch

precipitation accumulation, potential evapotranspiration

SI-std

mm

Millimeter

precipitation accumulation, potential evapotranspiration

US-std

mb

Millibar

atmospheric pressure

SI-std

Pa

Pascal

atmospheric pressure

US-std

mi

Mile

visibility

SI-std

km

Kilometer

visibility

US-std & SI-std

degree

Degree

wind direction

US-std

mph

Miles per Hour

wind speed, wind gust

SI-std

kph

Kilometers per Hour

wind speed, wind gust

US-std & SI-std

W/m^2

Watts per Square Meter

longwave radiation, shortwave radiation

US-std & SI-std

dBZ

Decibel

radar reflectivity

A.4. 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 start timestamp corresponding to 2016-05-01 00:00 UTC and end timestamp corresponding to 2016-05-02 00:00 UTC in the Daily Historical endpoint can be viewed as 2016-05-01 00:00 local time and 2016-05-02 00:00 local time, respectively, and the endpoint returns data valid for this time period.

Appendix B: 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").

B.1. 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

B.2. 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

B.3. 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

B.4. 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

Numerous Clouds

53

Developing

B.5. 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

B.6. 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

B.7. 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

B.8. 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

B.9. 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