OpenWeatherMap

Current weather, forecasts by the hour, day and night, and week, and warnings (One Call API 4.0).

In a dashboard file: a connection with "driver": "openweathermap", its settings in config, and what a data source of it reads in that data source’s params (Connections and data sources).

Example

A dashboard with a connection of this driver, named weather, and a tile that reads it. Any number of tiles can read the same connection. In the editor, the values of params are picked from what the connection lists; ids in the example are made up.

{
    "schemaVersion": 4,
    "connections": {
        "weather": {
            "driver": "openweathermap",
            "config": { "apiKey": "your API key", "lat": 50.85, "lon": 4.35 }
        }
    },
    "screens": [
        {
            "name": "Home",
            "tiles": [
                {
                    "type": "value",
                    "label": "Outside",
                    "layout": { "x": 1, "y": 1, "width": 2, "height": 2 },
                    "dataSource": {
                        "connection": "weather",
                        "params": { "read": "current", "value": "temperature" }
                    },
                    "options": { "numberFormat": "0.0", "unit": "°C" }
                }
            ]
        }
    ]
}

Settings (config)

Field	Type	Default	What
apiKey	text	required	API key. An OpenWeatherMap key with the One Call API 4.0 subscription. A credential.
lat	number, -90 to 90	required	Latitude. Of the place, in decimal degrees, such as 50.85.
lon	number, -180 to 180	required	Longitude. Of the place, in decimal degrees, such as 4.35.
units	one of metric, imperial		Units. Metric (°C, km/h, mm) when left out, or imperial (°F, mph, in).
lang	text		Language. Of descriptions and warnings, such as nl; the device’s when left out.
currentEvery	number, above 0		Current conditions every. Minutes; 15 when left out.
forecastEvery	number, above 0		Forecasts every. Minutes; 30 when left out.

What a data source reads (params)

Field	Type	Default	What
read	text	required	Read. The current conditions, or the forecast for the forecast tile.
value	text		Value. Which of the current conditions; all of them, as a record, when left out.