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