Defining the icon set parameter in the Weather API

The Weather API enables you to return a icon name for each row of weather data. This icon field provides a high level summary of the weather that for that time period and is designed to present a simply view of the weather, such as providing the basis for icon names.

You may specify different sets of icons. This is done through the iconSet parameter in the API requests.

We have built the iconSet parameter to be extended over time to offer different icon sets. The APIs currently support two iconSet values = ‘icons1’ and ‘icons2’. If no iconSet is specified, icons1 is selected

Be supplying the icon as an individual id, this enables you to create an output with the icons that you choose and display either by CSS, image or other rules.

In all icon sets, icons are chosen based on a priority of weather conditions. For example snow fall is higher importance than cloudiness and so snow icon will be chosen. The tables below are listed in descending order of priority.

Where an icon alternates between a day or nighttime, the sunrise and sunset parameters are used to decide between and nighttime.

Icon set icons

iconSet=icons1 (default)

Icon idWeather Conditions
snowAmount of snow is greater than zero
rain Amount of rainfall is greater than zero
fogVisibility is low (lower than one kilometer or mile)
windWind speed is high (greater than 30 kph or mph)
cloudyCloud cover is greater than 90% cover
partly-cloudy-day Cloud cover is greater than 20% cover during day time.
partly-cloudy-night Cloud cover is greater than 20% cover during night time.
clear-day Cloud cover is less than 20% cover during day time
clear-night Cloud cover is less than 20% cover during day time

iconSet=icons2

Icon idWeather Conditions
snowAmount of snow is greater than zero
snow-showers-dayPeriods of snow during the day
snow-showers-nightPeriods of snow during the night
thunder-rainThunderstorms throughout the day or night
thunder-showers-dayPossible thunderstorms throughout the day
thunder-showers-night Possible thunderstorms throughout the night
rain Amount of rainfall is greater than zero
showers-dayRain showers during the day
showers-night Rain showers during the night
fogVisibility is low (lower than one kilometer or mile)
windWind speed is high (greater than 30 kph or mph)
cloudyCloud cover is greater than 90% cover
partly-cloudy-day Cloud cover is greater than 20% cover during day time.
partly-cloudy-night Cloud cover is greater than 20% cover during night time.
clear-day Cloud cover is less than 20% cover during day time
clear-night Cloud cover is less than 20% cover during day time

Sample icons

We provide sample icons in various image formats. These icons can be used by your application or web page freely and have been named to fit the above icon set IDs.

The icons previews plus PNG and SVG source can be found on our GitHub repository: https://github.com/visualcrossing/WeatherIcons

4 Replies to “Defining the icon set parameter in the Weather API”

  1. I don’t get icons for forecasts, only for current conditions. I’m trying to switch away from DarkSky, but I use the ‘Icon’ property there a lot.

    Here’s the query:
    “https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/weatherdata/forecast?IconSet=icons1&aggregateHours=24&combinationMethod=aggregate&shortColumnNames=true&contentType=json&unitGroup=metric&locationMode=single&locations=49.1791,-122.3161&forecastDays=7&key=”

    Suggestions?

    1. Thank you for your note. The ‘iconSet’ API parameter is case sensitive – the first ‘i’ should be lower case and it looks like your may include an upper case I. For example:

      https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/weatherdata/forecast?iconSet=icons1&aggregateHours=24&combinationMethod=aggregate&shortColumnNames=true&contentType=json&unitGroup=metric&locationMode=single&locations=49.1791,-122.3161&forecastDays=7&key=

      Please let us know if that doesn’t help.

      Regards
      Visual Crossing Support

    1. Thank you for pointing this out. We have made the correction to the article. We have added 2500 credits to your account as bug finder reward!

      Regards
      Visual Crossing Support

Comments are closed.