Calcolatore della classificazione climatica Köppen
Il calcolatore della classificazione climatica Köppen converte dodici temperature medie mensili e dodici totali mensili di precipitazione in un noto codice Köppen-Geiger, come Af, Cfb, BWh o ET.
Esegui gratis nel browser
Applica prima la verifica dell’aridità, poi valuta i limiti termici e la stagionalità delle piogge per i climi tropicali, temperati, continentali o polari. Selezioni l’emisfero corretto affinché le verifiche estive e invernali usino i semestri appropriati. Il risultato include il nome della classe e utili indicatori annuali e mensili, così Lei può controllare il percorso decisionale anziché ricevere soltanto un codice privo di spiegazione.
Prepari le normali climatiche mensili in ordine di calendario
Inserisca esattamente dodici temperature medie mensili in gradi Celsius e dodici totali mensili di precipitazione in millimetri. Entrambi gli elenchi devono andare da gennaio a dicembre. Le normali climatiche calcolate su più decenni sono gli input più significativi, perché Köppen-Geiger descrive il clima, non il tempo di un anno insolito. Le precipitazioni non possono essere negative, mentre la temperatura può scendere sotto zero. Imposti l’emisfero nord o sud per assegnare aprile-settembre e ottobre-marzo ai corretti semestri estivo e invernale. Questa distinzione incide sulle lettere di estate secca e inverno secco e sulla distribuzione delle precipitazioni usata nella soglia di aridità. Il calcolatore rifiuta elenchi con mesi mancanti o in eccesso, invece di tentare di indovinare quale mese manchi. Rifiuta anche valori non numerici o non finiti. Prima di inviare dati copiati da un foglio di calcolo, verifichi che i totali di precipitazione siano in millimetri e che le temperature siano medie mensili, non massime giornaliere. Unità coerenti e ordine corretto sono indispensabili per ogni soglia successiva.
Comprenda la sequenza delle soglie
La classificazione segue un albero decisionale. I climi aridi B vengono verificati per primi, poiché l’aridità dipende sia dalla temperatura media annua sia dalla concentrazione delle piogge in estate, in inverno o in nessuno dei due semestri. Una precipitazione annua inferiore a metà della soglia di aridità indica deserto BW; tra metà e soglia completa indica clima semiarido BS. La temperatura media annua assegna quindi il suffisso caldo h o freddo k. Se il sito non è arido, tutti i mesi pari o superiori a diciotto gradi Celsius determinano un clima tropicale A. Le piogge tropicali distinguono foresta f, monsone m o stagione secca w oppure s. I climi polari E non hanno mesi sopra dieci gradi: una massima mensile sotto zero indica calotta glaciale EF, altrimenti tundra ET. Gli altri siti rientrano nel temperato C se il mese più freddo supera zero, oppure nel continentale D se raggiunge zero o meno. Siccità estiva, siccità invernale e umidità costante stabiliscono la seconda lettera; il mese più caldo e il numero di mesi sopra dieci gradi stabiliscono l’ultima.
Interpreti e confronti il risultato con attenzione
Usi il codice restituito come sintesi riproducibile della serie mensile fornita. Il nome del clima rende leggibile il codice, mentre temperatura media annua, precipitazione annua, soglia di aridità calcolata e medie del mese più freddo e più caldo mostrano perché sono stati scelti i rami principali. Un risultato vicino a una soglia richiede cautela: una piccola differenza dovuta al periodo della normale, alla quota della stazione, alla gestione dei dati mancanti o all’interpolazione spaziale può spostare un luogo in una classe confinante. Alcune mappe pubblicate usano inoltre meno tre gradi come confine fra C e D; questo calcolatore adotta il confine ampiamente usato di zero gradi e dichiara la scelta. Non deduce la località, non corregge misure, non compensa la quota e non valuta proiezioni climatiche future. Per i confronti, scelga dati con lo stesso periodo normale, risoluzione, unità e metodo per i valori mancanti. Il calcolo è deterministico: elenchi ed emisfero identici restituiscono sempre lo stesso risultato. L’uso nel browser è gratuito, mentre ogni richiesta automatizzata tramite API costa $0.002.
Casi d'uso
Classificare una stazione meteorologica
Converta normali climatiche pubblicate in un codice Köppen-Geiger documentato, corredato dalle soglie decisive.
Verificare una classe cartografica
Confronti i valori mensili di una stazione o griglia con la classe mostrata su una mappa ed esamini le differenze di confine.
Uniformare una procedura di ricerca
Applichi un unico insieme deterministico di regole a molti luoghi preparati, conservando campi di output coerenti.
Domande frequenti
Quale limite termico separa i climi C e D?
Il calcolatore usa zero gradi Celsius per il mese più freddo: sopra zero è C; a zero o sotto è D quando sono soddisfatti gli altri requisiti.
Perché devo scegliere un emisfero?
Le regole di estate secca e inverno secco confrontano semestri opposti. L’emisfero determina quali mesi del calendario appartengono all’estate.
Posso usare i dati di un solo anno?
Il calcolo funziona, ma è preferibile una normale climatica pluridecennale, perché il sistema descrive il clima di lungo periodo e non il tempo di un anno.
Perché il clima arido viene verificato prima di quello tropicale o temperato?
Questo è l’ordine decisionale di Köppen-Geiger. Un luogo che soddisfa la soglia di aridità appartiene al gruppo B, anche se le temperature potrebbero rientrare in un altro gruppo.
Cosa accade se un elenco non contiene dodici valori?
La richiesta fallisce con un errore di input non valido che identifica l’elenco che deve contenere esattamente dodici valori mensili.
Quanto costa una classificazione tramite API?
Ogni richiesta tramite API costa $0.002. Lo stesso calcolo deterministico è disponibile gratuitamente anche nel browser.
Per sviluppatori — accesso via API
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.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/earth/koppen-classification \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"temperatures_c":[26.5,26.8,27.1,27.3,27.1,26.6,26.2,26.3,26.5,26.7,26.6,26.4],"precipitation_mm":[220,210,240,260,250,190,170,160,180,210,230,240]}'const res = await fetch("https://api.kit.forhosting.com/earth/koppen-classification", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"temperatures_c": [
26.5,
26.8,
27.1,
27.3,
27.1,
26.6,
26.2,
26.3,
26.5,
26.7,
26.6,
26.4
],
"precipitation_mm": [
220,
210,
240,
260,
250,
190,
170,
160,
180,
210,
230,
240
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/earth/koppen-classification",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"temperatures_c": [
26.5,
26.8,
27.1,
27.3,
27.1,
26.6,
26.2,
26.3,
26.5,
26.7,
26.6,
26.4
],
"precipitation_mm": [
220,
210,
240,
260,
250,
190,
170,
160,
180,
210,
230,
240
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/earth/koppen-classification", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"temperatures_c":[26.5,26.8,27.1,27.3,27.1,26.6,26.2,26.3,26.5,26.7,26.6,26.4],"precipitation_mm":[220,210,240,260,250,190,170,160,180,210,230,240]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"temperatures_c":[26.5,26.8,27.1,27.3,27.1,26.6,26.2,26.3,26.5,26.7,26.6,26.4],"precipitation_mm":[220,210,240,260,250,190,170,160,180,210,230,240]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/earth/koppen-classification", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"temperatures_c": [
26.5,
26.8,
27.1,
27.3,
27.1,
26.6,
26.2,
26.3,
26.5,
26.7,
26.6,
26.4
],
"precipitation_mm": [
220,
210,
240,
260,
250,
190,
170,
160,
180,
210,
230,
240
]
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "earth.koppen_classification",
"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.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_items | 12 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |