Icone meteo

Panoramica

Tutte le risposte delle previsioni includono un campo icon in ogni punto dati che rappresenta una condizione meteo. Questo valore stringa contiene tutto il necessario per visualizzare un’icona meteo o un’etichetta di condizione appropriata.

Il campo icon è una stringa come "01d" o "07n", dove le prime due cifre sono il codice condizione e il suffisso indica giorno (d) o notte (n).

Codici delle icone

Indicatore giorno/notte

L’ultimo carattere della stringa icon indica giorno (d) o notte (n). Questo corrisponde al fatto che il punto dati cada nelle ore diurne alla località richiesta, determinato dagli orari di alba e tramonto. Il campo booleano is_day viene fornito insieme a icon per comodità.

Usa il suffisso giorno/notte per selezionare l’immagine corretta. Per esempio, "00d" (Sereno, giorno) dovrebbe mostrare un sole, mentre "00n" (Sereno, notte) dovrebbe mostrare una luna. La maggior parte delle condizioni (pioggia, neve, nebbia, ecc.) non necessita di una variante giorno/notte.

Dove compaiono questi campi

Sia icon che is_day sono presenti in:

• currently – l’oggetto delle condizioni attuali
• hourly.data[] – ogni punto della previsione oraria
• daily.data[] – ogni voce della previsione giornaliera (rappresenta la condizione diurna; il suffisso è sempre d)

Esempio

{
  "currently": {
    "time": 1709132400,
    "summary": "Partly Cloudy",
    "icon": "01d",
    "is_day": true,
    "temperature": 8.2
  },
  "hourly": {
    "data": [
      {
        "time": 1709132400,
        "icon": "01d",
        "is_day": true,
        "temperature": 8.2
      },
      {
        "time": 1709175600,
        "icon": "00n",
        "is_day": false,
        "temperature": 3.1
      }
    ]
  }
}

Note sull’utilizzo

• I codici delle icone sono stabili e non cambieranno significato. Nuovi codici possono essere aggiunti alla fine dell’intervallo.
• I codici 00 e 01 (Sereno e Parzialmente nuvoloso) sono le uniche condizioni in cui è tipicamente necessaria una distinzione visiva tra giorno e notte. Tutte le altre condizioni possono usare un’unica icona indipendentemente dal suffisso giorno/notte.