weather

Table of contents
  1. tl;dr
  2. Config JSON Fragment
  3. Proprietà (Config Section)
  4. Notifiche
  5. Screenshots
  6. Requisiti Privati
  7. locationID

tl;dr

Visualizza il meteo per il giorno corrente.

Config JSON Fragment 

{
    "module": "weather",
    "position": "top_right",
    "config": {
        "weatherProvider": "openweathermap",
        "units": "metric",
        "degreeLabel": true,
        "updateInterval": 600000,
        "lang": "en",
        "initialLoadDelay": 1000,
        "onlyTemp": false,
        "showHumidity": true,
        "showIndoorTemperature": true,
        "showIndoorHumidity": true,
        "showSun": true,
        "colored": true,
        "showPrecipitationAmount": true,
        "maxNumberOfDays": 5,
        "locationID": "",
        "apiKey": "YOUR_OPENWEATHERMAP_APIKEY"
    }
}

Proprietà (Config Section)

Proprietà Tipo Valori Valore Default Inderogabilità Descrizione
weatherProvider String "openweathermap"
"darksky"
"weathergov"
"ukmetoffice"
"weatherbit"		 "openweathermap" OPTIONAL API.
units String config.units: Acquisizione del valore specificato nel file config.js.
"default": Kelvin.
"metric": Celsius.
"imperial": Fahrenheit.		 config.units OPTIONAL Unità di misura per i gradi.
degreeLabel Boolean true: Attiva la visualizzazione dell’unità di misura (etichetta) per i gradi in uso.
false: Disattiva la visualizzazione dell’unità di misura (etichetta) per i gradi in uso.		 false OPTIONAL Attiva la visualizzazione dell’unità di misura (etichetta) per i gradi in uso.
updateInterval Number 1000 <= milliseconds <= 86400000 600000 OPTIONAL Frequenza di aggiornamento / richiesta contenuti aggiornati.
lang String config.language: Acquisizione del valore specificato nel file config.js.
"en"
"nl"
"ru" ect….		 config.language OPTIONAL Lingua per la visualizzazione del nome dei giorni della settimana.
initialLoadDelay Number 1000 <= milliseconds <= 5000 0 OPTIONAL Delay di sicurezza prima di avviare il caricamento di questo modulo durante la fase di boot del MagicMirror.
onlyTemp Boolean true: Attiva la visualizzazione limitata alla solo temperatura.
false: Disattiva la visualizzazione limitata alla solo temperatura.		 false OPTIONAL Attiva la visualizzazione limitata alla solo temperatura.
showHumidity Boolean true: Attiva la visualizzazione dell’umidità.
false: Disattiva la visualizzazione dell’umidità.		 false OPTIONAL Attiva la visualizzazione dell’umidità.
showIndoorTemperature Boolean true: Attiva la visualizzazione della temperatura interna (locale di collocamento MagicMirror).
false: Disattiva la visualizzazione della temperatura interna (locale di collocamento MagicMirror).		 false OPTIONAL Attiva la visualizzazione della temperatura interna (locale di collocamento MagicMirror).
showIndoorHumidity Boolean true: Attiva la visualizzazione dell’umidità interna (locale di collocamento MagicMirror).
false: Disattiva la visualizzazione dell’umidità interna (locale di collocamento MagicMirror).		 false OPTIONAL Attiva la visualizzazione dell’umidità interna (locale di collocamento MagicMirror).
showSun Boolean true: Attiva la visualizzazione dei cicli del Sole (Alba, Tramonto).
false: Disattiva la visualizzazione dei cicli del Sole (Alba, Tramonto).		 true OPTIONAL Attiva la visualizzazione dei cicli del Sole (Alba, Tramonto).
colored Boolean true: Attiva la visualizzazione delle temperatura MIN & MAX in tonalità colorata.
false: Disattiva la visualizzazione delle temperatura MIN & MAX in tonalità colorata.		 false OPTIONAL Attiva la visualizzazione delle temperatura MIN & MAX in tonalità colorata.
showPrecipitationAmount Boolean true: Attiva la visualizzazione della quantità di precipitazioni (neve, pioggia).
false: Disattiva la visualizzazione della quantità di precipitazioni (neve, pioggia).		 false OPTIONAL Attiva la visualizzazione della quantità di precipitazioni (neve, pioggia).
maxNumberOfDays Number 1 <= days <= 16 5 OPTIONAL Rappresenta il numero di giorni futuri di cui richiedere le informazioni meteo.
locationID String Visita https://openweathermap.org/ per ottenere l’ID zona (segui istruzioni sotto). --- REQUIRED ID rappresentante univocamente la zona da analizzare per le informazioni meteo.
apiKey String Visita https://openweathermap.org/ per ottenere la tua API KEY (ad uso GRATUITO privata). --- REQUIRED La tua API KEY per l’utilizzo della OPENWEATHERMAP API.

Notifiche

Le notifiche sono uno strumento utilizzato dai moduli per comunicare con:

  • L’OS del MagicMirror
  • Altri moduli
  • Attori umani
Notifica Direzione Trigger Payload (inline js) Descrizione
INDOOR_TEMPERATURE IN Visualizza la temperatura locale della zona di collocazione del MagicMirror. INDOOR_TEMPERATURE_VALUE Notifica in funzione solo se il valore di showIndoorTemperature è true.
INDOOR_HUMIDITY IN Visualizza l’umidità locale della zona di collocazione del MagicMirror. INDOOR_HUMIDITY_VALUE Notifica in funzione solo se il valore di showIndoorHumidity è true.

Screenshots

Schermata del modulo funzionante:

working_module

Requisiti Privati

Ottieni la tua API KEY per le API di OPENWEATHERMAP: https://openweathermap.org/.

E’ necessaria una API KEY per l’utilizzo del modulo, in quanto quest’ultimo utilizza le API di OPENWEATHERMAP. L’utilizzo delle API effettuato in modo automatico da questo modulo è conforme agli standard di utilizzo delle suddette API, ed è totalmente gratuito (nei limiti di utilizzo privato effettuato in modo automatico da questo modulo).

locationID

La proprietà locationID identifica univocamente una località nell’intero mondo. Questo codice semplifica l’atto di specificazione della zona da analizzare, in quanto quest’ultima viene, appunto, identificata univocamente.

Per ottenere il valore di locationID:

  • Visita prima di tutto: https://openweathermap.org/.
  • Utilizza
    search_bar_getlocationID
    per cercare la tua zona di interesse.
  • Una volta effettuata la ricerca
    search_bar_used_getlocationID
    potrai notare che l’URL della pagina correntemente visualizzata contiene proprio il valore di locationID:
    url_gotlocationID