DISTRIBUTION OF TIZEN-BASED WATCH APPS HAS BEEN DISCONTINUED
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.
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.
Manage Your Cookies
We use cookies to improve your experience on our website and to show you relevant
advertising. Manage you settings for our cookies below.
Essential Cookies
These cookies are essential as they enable you to move around the website. This
category cannot be disabled.
Company
Domain
Samsung Electronics
.samsungdeveloperconference.com
Analytical/Performance Cookies
These cookies collect information about how you use our website. for example which
pages you visit most often. All information these cookies collect is used to improve
how the website works.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Functionality Cookies
These cookies allow our website to remember choices you make (such as your user name, language or the region your are in) and
tailor the website to provide enhanced features and content for you.
Company
Domain
LinkedIn
.ads.linkedin.com, .linkedin.com
Advertising Cookies
These cookies gather information about your browser habits. They remember that
you've visited our website and share this information with other organizations such
as advertisers.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Preferences Submitted
You have successfully updated your cookie preferences.