API Clima

Clima giornaliero#

Parametri

Questo non è lo storico orario con davanti un GROUP BY. I campi giornalieri sono derivati una volta sola, in fase di ingestione, su un confine di giornata scelto per la fisica e non per comodità, e i campi derivati — temperatura percepita, durata dell'insolazione, umidità media — sono calcolati dalla serie oraria completa e non dagli estremi giornalieri.

Aggregati mensili#

Somme per i cumulati, medie ed estremi per il resto. Stesso prezzo della serie giornaliera, perché legge la stessa colonna.

Li chieda quando è davvero una cifra mensile ciò che rappresenta, anziché scaricare trenta volte i dati e ridurli da sé — a essere lento è il trasferimento, non il calcolo.

Il clima di un luogo, in una sola chiamata#

Parametri

Tutto ciò che una pagina sul clima afferma di un luogo, già ridotto: dodici normali mensili, una riga per ogni anno solare completo, i record storici con le date in cui sono caduti, la tendenza di riscaldamento ai minimi quadrati con la sua significatività, e il codice Köppen-Geiger. Per qualsiasi coordinata emersa della Terra.

daily=true non è lo stesso di normals?daily=true

Ed è proprio lì la differenza. L'endpoint delle normali media su una finestra OMM di trent'anni; questo media sulla finestra che lei ha chiesto — l'intero archivio per impostazione predefinita.

È l'unico modo per dire «9,4 °C sopra la norma per un 30 luglio» con ottantasette anni dietro l'affermazione anziché trenta. Ogni giorno porta il suo numero di campioni, così allargare a una normale centrata su quindici giorni si scrive Σ(mean·samples) / Σ(samples) — esatto, e senza una seconda richiesta.

Due convenzioni da conoscere prima di confrontare con un'altra fonte

Un anno solare entra nella serie annuale e nella tendenza solo se l'archivio ne contiene almeno 360 giorni, per cui l'anno in corso è escluso. Mezzo anno si legge come un crollo delle precipitazioni e trascina con sé una retta di tendenza.

trends vale null sotto i dieci anni completi. Al di sotto, una pendenza è rumore meteorologico travestito da segnale climatico, e preferiamo non pubblicare nulla piuttosto che una cifra sbagliata enunciata con sicurezza. Per la stessa ragione ogni tendenza porta il proprio p_value e il flag significant — li legga prima di citare la pendenza.

Normali OMM#

Parametri

Una normale non è la media del periodo che le è capitato di chiedere. È una media trentennale su una finestra fissata dall'Organizzazione Meteorologica Mondiale, affinché due persone che citano una normale citino la stessa cosa.

Se ciò che vuole è «la normale sull'intero registro» anziché su una finestra OMM, usi invece /v1/climate/summary — richiede solo lo scope climate e le dà ottantasette anni anziché trenta.

Confrontare due normali#

Questa è la domanda che la maggior parte delle persone pone davvero quando chiede una normale — non «che cosa è normale qui» ma «di quanto si è spostata la norma».

Rispondervi in un'unica richiesta garantisce che le due metà non possano provenire da corse diverse, che è esattamente il difetto del calcolarlo da sé a partire da due chiamate: l'archivio avanza nel frattempo, e la differenza che lei pubblica contiene allora un cambio di versione oltre a un cambiamento climatico.

Copertura, campi e celle#

cells/resolve risponde alla domanda che andrebbe posta a ogni prodotto su griglia prima di fidarsene: quale cella sto leggendo davvero, e quanto dista dal punto che ho chiesto? A 28 km quella distanza può raggiungere i 20 km, e conoscerla è la differenza tra citare una cifra e citarla in modo responsabile.

fields offre lo stesso contratto di /v1/historical/variables: elenca ciò che la corsa contiene e non ciò che il prodotto potrebbe contenere un giorno, così un client costruito su di esso non si rompe quando l'archivio cresce.