Weather
weather galaxy watch studio gws provides weather components that use openweathermap’s free apis before you can start using these weather components in your watch design, you must create an account with openweather and copy the api key to gws see get a weather api key for more information if you want to use weather components, you should be aware of the following the openweathermap apis used by gws may be different from the apis used by other weather apps on your mobile device or watch therefore, weather information displayed by those apps may differ from the weather information displayed on your watch face if you want to use weather apis in your watch design other than those provided by openweather, you cannot use gws weather components in gws cannot be used with tag expressions iap health components such as steps % step counts steps goal speed burned calorie kcal moved distance heart rate bpm water intake caffeine intake floor tip if you want to display both health and weather data on the same watch face, you could set an image as a button that opens either the default weather app or the s-health app on the watch for example, if you use the health components, then set a button to open the default weather app or, if you use the weather components, then set a button to open the s-health app weather components should not be rotated while a rotated weather component displays in the preview and run windows in gws, it does not display on an actual watch negative or 0 zero readings may display on the watch if weather data is not available locations provided on the map when selecting a city are where openweather weather stations are located and weather data is pulled from the closest weather station therefore, if you are displaying the name of the current city in your watch face, a location or area may be displayed rather than a city name if you are thinking about purchasing a paid plan from openweather, you must verify with openweather that this plan is compatible with gws see get a weather api key for more information weather type component the weather type component is used to display weather conditions, descriptively or graphically, of a selected city or the current city the city where the watch is currently physically located the weather type component can display five types of information main – a single word that describes the general weather condition available in english only icon – an image that depicts the general weather condition description – a brief but descriptive expression of the weather the description is available in multiple languages when the language is set to default, the language used is the same as the phone’s language the phone to which the watch is paired if the phone’s language is not supported, english is used number – an alphanumeric value that is used to represent general weather conditions during the day or at night id – a numerical value that is used to uniquely identify each weather description note if weather data is not displayed in the preview or run windows and your city is set to current city, try the following set the current location in your preferences click edit > preferences > apis to set your current location if your current location is already set, temporarily set the city to another location and then switch back to current city if neither of these steps fix the problem, verify that your weather api key is activated click edit > preferences > apis and that your computer is connected to a network when the weather data displays 0 zero , it typically means that data for the location has not been received from openweather temperature component the temperature component is used to display the current temperature of a selected city or the current city the city where the watch is currently physically located the temperature can be displayed in celsius, fahrenheit, or kelvin and you can opt to display or not to display the unit of measurement you can set the precision the number of decimal places or digits after the decimal point and left-pads the number of digits to display before the decimal point, which may be padded with leading zeroes you can also enable the set as button feature that allows the user to cycle through the temperature unit measurements by tapping the temperature see use galaxy watch designer to change the weather for more information about this feature humidity component the humidity component is used to display the current humidity of a selected city/location or the current city the city where the watch is currently physically located the humidity can be displayed with or without the percentage sign you can also set the left-pads the number of digits to display before the decimal point, which may be padded with leading zeroes city name weather component the city name component displays the selected city/location or the current city the city where the watch is currently physically located from which the weather data is taken note if you are using more than one weather component to display weather data for one location, be sure that the location is the same for all of the weather components last update time weather component the last update time component displays the month, day, and time or just the time when the weather data was last refreshed you can also enter a different date and time pattern using a valid icu format see formatting dates and times for a list of valid symbols that can be used set as button weather components can be set as buttons that is, you can configure the weather component to update the weather data, change the temperature unit of measurement temperature component only , or open an app if the user taps or double-taps the component’s area on the watch face see use galaxy watch designer to change the weather and how to create a tap reveal button to show hidden data for more information about this feature forecast data display weather forecasts, from three hours onward up to four days and 21 hours forecast time is selected in 3-hour increments by default, the day and hour values are set to zero 0 , which displays the current weather data the time offset for forecast data is from the current time that is, if you display 1-day forecast data, the weather data is displayed for exactly 24 hours from the current time for example, if it is noon, you are viewing the forecast weather data for noon tomorrow if it is 3p, you are viewing the forecast weather data for 3p tomorrow run window in order to dynamically change the data displayed in the run window using the weather run controllers, the component’s city located under properties > data must be set to current city if you have selected a specific city, that city’s data is displayed in the run window and cannot be changed custom weather icons you can customize the weather icons displayed by a weather type component by setting bitmap fonts gws uses the data provided by openweather and maps them to display types openweather provides 18 numbers and 54 codes that define the current weather type see the icon list and weather condition codes on https //openweathermap org/weather-conditions for the most current definitions openweather file names of each icon are mapped to the number display type used in gws for example, the openweather file 01d png maps to the gws number 01d and represents clear sky during the day there are 10 weather descriptions that apply to both day time and night time weather openweather weather condition codes are mapped to the main, description, and id display types used in gws for example, the openweather id 800 maps to the gws id 800 and represents a clear sky gws weather type component display types and values main icon description number id other notes thunderstorm thunderstorm with light rain 11d 200 thunderstorm thunderstorm with rain 11d 201 thunderstorm thunderstorm with heavy rain 11d 202 thunderstorm light thunderstorm 11d 210 thunderstorm thunderstorm 11d 211 day time 11n night time thunderstorm heavy thunderstorm 11d 212 thunderstorm ragged thunderstorm 11d 221 thunderstorm thunderstorm with light drizzle 11d 230 thunderstorm thunderstorm with drizzle 11d 231 thunderstorm thunderstorm with heavy drizzle 11d 232 drizzle light intensity drizzle 09d 300 drizzle drizzle 09d 301 drizzle heavy intensity drizzle 09d 302 drizzle light intensity drizzle rain 09d 310 drizzle drizzle rain 09d 311 drizzle heavy intensity drizzle rain 09d 312 drizzle shower rain and drizzle 09d 313 drizzle heavy shower rain and drizzle 09d 314 drizzle shower drizzle 09d 321 rain light rain 10d 500 day time 10n night time rain moderate rain 10d 501 rain heavy intensity rain 10d 502 rain very heavy rain 10d 503 rain extreme rain 10d 504 rain freezing rain 10d 511 rain light intensity shower rain 10d 520 day time 10n night time rain shower rain 10d 521 rain heavy intensity shower rain 10d 522 rain ragged shower rain 10d 531 snow light snow 13d 600 snow snow 13d 601 day time 13n night time snow heavy snow 13d 602 snow sleet 13d 611 snow shower sleet 13d 612 snow light rain and snow 13d 615 snow rain and snow 13d 616 snow light shower snow 13d 620 snow shower snow 13d 621 snow heavy shower snow 13d 622 mist mist 50d 701 day time 50n night time smoke smoke 50d 711 haze haze 50d 721 dust sand, dust whirls 50d 731 fog fog 50d 741 sand sand 50d 751 dust dust 50d 761 ash volcanic ash 50d 762 squall squalls 50d 771 tornado tornado 50d 781 clear clear sky 01d 800 day time 01n night time clouds few clouds 02d 801 day time 02n night time clouds scattered clouds 03d 802 day time 03n night time clouds broken clouds 04d 803 day time 04n night time clouds overcast clouds 04d 804 day time 04n night time note you cannot customize the values returned by the openweathermap api however, you can map custom icons to the api values when that value is returned by the api, the custom icon mapped to that value is displayed on the watch face to customize the icon associated with the display types, do the following add a weather type component to your watch face select text > weather type if a warning window displays, read and acknowledge that the listed features and components cannot be used when this weather component is used click ok position the weather component in the watch face by dragging and dropping it to the desired location with the weather component selected, in the properties window and data section, change the display type that you want to customize note you cannot customize the icon display type if a warning window displays, read and acknowledge the message click ok note that the selected display type displays in the preview and run windows in the properties window and appearance section, select bitmap font click the bitmap font setting button and select the custom tab click the add text string button, enter one of the values of the display type you selected for example, enter 01d for a number or 800 for an id , and click ok note the value entered is case-sensitive for example, if you are customizing the main display type and enter “snow,” it will not match the openweathermap api value “snow ” this means that no image is displayed in the watch face when the openweathermap api returns the value “snow ” repeat step 8 until you have entered all values note if you do not enter a value that is returned by the api and the api returns that value, nothing will be displayed on the watch face for example, if you are customizing the main display type and only map images to thunderstorm, rain, snow, clear, and clouds, nothing will display on the watch face if the api returns a value of drizzle, mist, smoke, haze, dust, fog, sand, ash, squall, or tornado if you enter a value that is not used by the api, the image associated with the value will never display in your watch face for each value, click the + symbol next to it and select the image file that you want associated with it the image file must be the exact size and color you want to display on the watch face you cannot resize the image in gws note while you can import png, jpg, bmp, or gif files, gws will save the image as a png in the project if you do not select an image file to associate with a value, nothing is displayed in the watch face when the api returns that value click ok in the run window, set the weather type field to one of your customized values to view how the custom icon will appear in the watch face