Menu

Weather Provider

The Weather Provider gets data and several additional information about the weather from different weather services.

Configuration

  • Service Provider
    Use one of the following weather service providers:

    Norwegian Meteorological Institute

    See MET Norway

    tyckr Weather Service

    tyckr provided weather service

    meteoblue

    See meteoblue

    Not all providers support all data queries, see the data queries table below.

  • Location
    The GPS coordinates of the location to get the weather for.
    Coordinates must be in Decimal degrees (DD) format of latitude, longitude, e.g. 41.40338, 2.17403. Decimal separator is a dot.
    Due to data privacy reasons, the GPS coordinates are rounded to obfuscate the exact location. See the accuracy field in the table below for details.

    Service

    Accuracy

    Remarks

    MET Norway

    1.11 km (2 GPS digits)

    The GPS coordinates are rounded to 2 digits after the decimal point, which results in a location accuracy of about 1.11 km.

    tyckr Service

    11.13 km (1 GPS digit)

    The GPS coordinates are rounded to 1 digit after the decimal point, which results in a location accuracy of about 11.13 km.

    meteoblue

    Full

    The GPS coordinates are used as provided, which results in a full accuracy of about 10 m.
    If accuracy should be reduced, you can set the Accuracy Privacy Reduction option in the Location Provider configuration, if used.
    Important
    		 The (reduced) location coordinates are transmitted to the according weather service provider and may be logged or stored by them.

  • Settings

    • Update Interval
      The service refresh interval time like 1h or 8h.
      Default is 2h.
      Use longer intervals like '4h' to reduce the number of requests to preserve battery life.

    • meteoblue API Key
      The API Key for the meteoblue service. The API key is called Client ID in the meteoblue documentation.
      You can obtain a free API key by registering at meteoblue.

  • Localization

    • Units
      Units of temperature, wind speed and visibility data:

      Unit Temperature Wind Speed Visibility

      US

      Fahrenheit

      mph

      miles

      UK

      Celsius

      mph

      miles

      Metric

      Celsius

      km/h

      km

      Base

      Kelvin

      m/s

      meters

    • Language Code
      ISO639 Language code for localized text and messages, like en for English, fr for French etc.

Query

  • Status
    Returns the weather data status:

    Text Numeric Description

    N/A

    0

    No weather data received yet, no data available

    Excellent

    1

    Weather data is valid

    Poor

    4

    Error in parsing the weather data, but data is available

    Fail

    5

    Error getting weather data

  • Data queries

    Query Description MET Norway tyckr Service meteoblue

    Location Coordinates

    GPS coordinates in DD format

    Supported

    Supported

    Supported

    Address

    Resolved location name

    Not supported

    Supported

    Supported

    Icon

    The weather icon name or number which can be used as input for the Icon Facelet

    Supported

    Supported

    Supported

    Condition

    The actual weather condition as text

    Supported

    Supported

    Supported

    Temperature

    The actual temperature

    Supported

    Supported

    Supported

    Temperature Feels Like

    Actual temperature which accounts for the human perception of weather.

    Not Supported

    Supported

    Supported

    Minimum Temperature

    Daily minimum temperature

    Supported

    Supported

    Supported

    Maximum Temperature

    Daily maximum temperature

    Supported

    Supported

    Supported

    Pressure

    Atmospheric pressure at sea level in hPa

    Supported

    Supported

    Supported

    Humidity

    Relative humidity as percentage

    Supported

    Supported

    Supported

    Visibility

    Distance at which distant objects are visible

    Not Supported

    Supported

    Supported

    Cloudiness

    Cloud cover as percentage

    Supported

    Supported

    Supported

    UV Index

    UV index from 0 - 10

    Supported

    Supported

    Supported

    Wind Speed

    Average wind speed

    Supported

    Supported

    Supported

    Wind Direction

    Wind direction in degrees, 0 - 359

    Supported

    Supported

    Supported

    Precipitation Probability

    Probability of precipitation as percentage

    Supported

    Supported

    Supported

    Sunrise

    Sunrise time at the location.
    Param 1 sets the time format of the text representation. See Time Format for details.
    If empty, the default ISO format "yyyy-MM-dd’T’HH:mm:ss.SSS" is used.
    Timezone of the weather location is used.

    Not Supported

    Supported

    Supported

    Sunset

    Sunset time at the location.
    Param 1 sets the time format of the text representation. See Time Format for details.
    If empty, the default ISO format "yyyy-MM-dd’T’HH:mm:ss.SSS" is used.
    Timezone of the weather location is used.

    Not Supported

    Supported

    Supported

    Is Daytime

    Is it daytime at the location?

    Not Supported

    Supported

    Supported

    Alert Message

    Weather alert message, if available

    Not supported

    Supported

    Not Supported

    Alert Severity

    Weather alert severity, if available

    Not supported

    Supported

    Not Supported

  • Data Set Time
    The time of the data set or the forecast time.

    Text Numeric

    Time in the format specified by Param 2

    Milliseconds since 1970-01-01 00:00:00 UTC + Timezone

    • Param 2
      The time format of the text representation. See Time Format for details.
      If empty, the default ISO format yyyy-MM-dd’T’HH:mm:ss.SSSxxx is used.

  • Update Time
    The Time of the last update.

    Text Numeric

    Time in the format specified by Param 2

    Milliseconds since 1970-01-01 00:00:00 UTC + Timezone

    • Param 2
      The time format of the text representation. See Time Format for details.
      If empty, the default ISO format yyyy-MM-dd’T’HH:mm:ss.SSSxxx is used.