ForHosting KIT · Strumenti per sviluppatori

Indice pluviometrico annuale

Il calcolatore dell’indice pluviometrico annuale trasforma dodici totali mensili di pioggia in una misura chiara di quanto l’anno osservato sia stato più umido o più secco rispetto a una media annua di lungo periodo.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Somma i valori mensili e restituisce un indice in cui 100 rappresenta la media. Il risultato comprende inoltre lo scostamento percentuale, una classificazione leggibile e la formula applicata, risultando utile per sintesi climatiche, rapporti di stazione, registri agricoli e flussi di dati riproducibili.

Significato dell’indice pluviometrico annuale

Il calcolo usa la piovosità media annua di lungo periodo come riferimento ed esprime la precipitazione dell’anno scelto come percentuale di tale valore. Un indice di 100 significa che la somma dei dodici mesi coincide esattamente con la media storica. Un valore di 115 indica il 15 per cento di pioggia in più, mentre 72 indica il 28 per cento in meno. Questa forma relativa offre un contesto che il solo totale annuo non può dare: 900 millimetri possono essere eccezionalmente abbondanti in una stazione e molto scarsi in un’altra. Tutti i dati mensili e la media annua devono usare la stessa unità di altezza, per esempio millimetri o pollici. L’unità si elimina nel rapporto, quindi l’indice è adimensionale. Il risultato conserva totale annuo e riferimento, rendendo il confronto trasparente, verificabile e facile da citare.

Preparazione e lettura dei dati

Inserisca esattamente dodici totali mensili non negativi, da gennaio a dicembre, e una media annua storica positiva riferita allo stesso luogo e metodo di osservazione. È preferibile una serie climatologica stabile. Non mescoli millimetri e pollici, misure di stazione e stime regionali, né mesi incompleti e totali completi. Lo zero è valido se non è caduta pioggia, ma non dovrebbe sostituire un’osservazione mancante. L’uscita considera vicino alla media l’intervallo da 95 a 105; sotto 80 è molto più secco, da 80 a meno di 95 più secco, sopra 105 fino a 120 più umido e sopra 120 molto più umido. Queste fasce sono descrittive e non rappresentano dichiarazioni ufficiali di siccità o alluvione, che richiedono altre variabili, scale temporali e soglie locali.

Impiego responsabile in rapporti e automazioni

Usi l’indice quando serve un confronto annuale sintetico, comprensibile senza esaminare dodici numeri separati. In un rapporto di stazione conservi insieme totale annuo, media di riferimento, indice, scostamento, classe e formula, così che il risultato sia riproducibile. In un flusso automatico verifichi prima che tutti i record appartengano allo stesso anno e alla stessa stazione. Il calcolo deterministico produce lo stesso JSON per input identici, favorendo test, cache, pannelli e audit. L’indice descrive la quantità annua rispetto al riferimento, ma non dice quando è piovuto. Due anni con lo stesso totale possono avere distribuzioni mensili opposte. Per studiare stagionalità, concentrazione, erosione, durata della siccità, alluvioni o disponibilità idrica agricola, analizzi anche la serie mensile e indicatori specialistici. La versione nel browser è adatta ai controlli singoli; ogni richiesta API costa $0.002.

Riassumere l’anno di una stazione

Confronti un anno completo di totali mensili con la media annua storica stabilita per la stazione.

Contestualizzare un rapporto agricolo

Indichi se l’anno registrato è stato in generale più umido o secco del riferimento locale, mantenendo i dati originali.

Automatizzare pannelli climatici

Generi indice, scostamento e classificazione stabili da registrazioni mensili già validate.

Che cosa significa un indice di 100?

Il totale annuo osservato è esattamente uguale alla piovosità media annua storica indicata.

Posso usare i pollici invece dei millimetri?

Sì. Può usare qualsiasi unità di altezza, purché tutti i totali e la media annua adottino la stessa.

Perché devo fornire una media storica separata?

Un riferimento climatologico indipendente rende significativo il confronto. La media degli stessi dodici valori produrrebbe un rapporto fisso, non un’anomalia di umidità.

Un totale mensile può essere zero?

Sì, se il mese è stato davvero senza pioggia. Non usi zero per sostituire un’osservazione mancante.

La classificazione definisce siccità o alluvione?

No. Descrive soltanto il confronto con la media; una valutazione formale richiede altri indicatori, periodi e limiti locali.

Quanto costa un calcolo tramite API?

Ogni richiesta API costa $0.002. In questa pagina può anche eseguire gratuitamente il calcolo nel browser.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/earth/pluviometric-index

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/earth/pluviometric-index \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthly_rainfall":[82,76,91,104,118,132,145,127,109,96,88,92],"mean_annual_rainfall":1200}'
{
  "monthly_rainfall": [
    82,
    76,
    91,
    104,
    118,
    132,
    145,
    127,
    109,
    96,
    88,
    92
  ],
  "mean_annual_rainfall": 1200
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "earth.pluviometric_index",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

max_items12
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →