Weather

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.

Settings

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

Using with config.yaml file

weather:
  locations:
    - name: london
      lat: 51.5285262
      lon: -0.2663999
      api: API_KEY
      unit: metric
      round_temperature: false
      lang: en
      forecast: false
      show:
        temperature_range: false
        humidity: false
        wind: false
        wind_direction: false
        visibility: false
      default: false

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). | | round_temperature | Round temperature to the nearest whole number. | | lang | Language code for weather descriptions (see the full list here). | | forecast | Display the forecast for the next three days | | show.temperature_range | Display temperature range for the next 24 hours. | | show.humidity | Display humidity for location. | | show.wind | Display wind for location. | | show.wind_direction | Also display wind direction as degrees for location. | | show.visibility | Display visibility for location. | | default | Set this location as the default (when no location is specified) |

URL queries

A select few weather options can be overridden via URL query parameters:

• weather_show_forecast
• weather_show_temperature_range
• weather_show_humidity
• weather_show_wind
• weather_show_wind_direction
• weather_show_visibility
• weather_round_temperature

Example

https://{KIOSK_URL}?weather_show_forecast=true&weather_show_humidity=true

Location rotation

You can rotate between configured weather locations by setting weather to rotate in the URL e.g. https://{KIOSK_URL}?weather=rotate.

Use rotation_interval to control how often locations rotate.

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:
  rotation_interval: 60 # in seconds (10 is the minimum).
  locations:
    - 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
      round_temperature: true
      lang: en