Weather

Settings

Key	Value
CONFIG	weather
ENV	N/A
URL	N/A
VALUE	[]WeatherLocation
DEFAULT	[]

Using with config.yaml file

weather:
  - name: london
    lat: 51.5285262
    lon: -0.2663999
    api: API_KEY
    unit: metric
    lang: en
    default: false

Caution

This feature can only be configured using a config.yaml file.

Note

To use the weather feature, you’ll need an API key from OpenWeatherMap.

Tip

OpenWeatherMap limits API usage to 60 calls per hour. Since the kiosk refreshes weather data every 10 minutes, you can monitor up to 6 locations with a single API key.

Setting Up Weather Locations

You can configure multiple locations in the config.yaml file, and choose which one to display using the URL query weather=NAME.

Weather Location Configuration Options:

Tip

If you would prefer to use the location name from OpenWeatherMap’s API, add “-api” to the end of the name. e.g. name: london-api

Value	Description
name	The location’s display name (used in the URL query).
lat	Latitude of the location.
lon	Longitude of the location.
api	OpenWeatherMap API key.
unit	Units of measurement (standard, metric, or imperial).
lang	Language code for weather descriptions (see the full list here).
default	Set this location as the default (when no location is specified)

Example Configuration

Here’s an example of how to add London, London using OpenWeatherMap’s name and New York to the config.yaml file. These locations would be selectable via the URL, like this: http://{URL}?weather=london or http://{URL}?weather=new-york.

weather:
  - name: london
    lat: 51.5285262
    lon: -0.2663999
    api: API_KEY
    unit: metric
    lang: en
    default: true

  - name: london-api
    lat: 51.5285262
    lon: -0.2663999
    api: API_KEY
    unit: metric
    lang: en

  - name: new-york
    lat: 40.6973709
    lon: -74.1444838
    api: API_KEY
    unit: imperial
    lang: en