Indice pluviométrique annuel
Le calculateur d’indice pluviométrique annuel transforme douze cumuls mensuels de pluie en une mesure claire du caractère plus humide ou plus sec de l’année observée par rapport à une moyenne annuelle de long terme.
Lancer gratuitement
Il additionne les valeurs mensuelles et fournit un indice où 100 représente la moyenne. Le résultat comprend aussi l’écart en pourcentage, une qualification lisible et la formule appliquée, ce qui convient aux bilans climatiques, rapports de stations, dossiers agricoles et traitements de données reproductibles.
Comprendre l’indice pluviométrique annuel
Ce calcul prend la pluviométrie annuelle moyenne de long terme comme référence et exprime le cumul de l’année choisie en pourcentage de cette valeur. Un indice de 100 signifie que la somme des douze mois correspond exactement à la moyenne historique. Un résultat de 115 indique 15 pour cent de pluie en plus, tandis que 72 indique 28 pour cent en moins. Cette présentation relative apporte un contexte absent du seul cumul annuel : 900 millimètres peuvent être très humides dans une station et très secs dans une autre. Les douze valeurs mensuelles et la moyenne annuelle doivent employer la même unité de hauteur, par exemple des millimètres ou des pouces. L’unité disparaît dans le rapport et l’indice est donc sans unité. Le résultat conserve le cumul annuel et la référence afin que la comparaison reste transparente, vérifiable et facile à reprendre dans un rapport.
Préparer et interpréter les données
Saisissez exactement douze cumuls mensuels non négatifs, de janvier à décembre, puis une moyenne annuelle historique positive correspondant au même lieu et à la même méthode de mesure. Privilégiez une période climatologique stable. Ne mélangez pas millimètres et pouces, mesures ponctuelles et estimations régionales, ni mois incomplets et cumuls complets. Zéro est valable pour un mois réellement sans pluie, mais ne doit pas remplacer une observation manquante. La sortie qualifie de proche de la moyenne la plage de 95 à 105 ; moins de 80 est beaucoup plus sec, 80 à moins de 95 plus sec, plus de 105 à 120 plus humide, et plus de 120 beaucoup plus humide. Ces classes résument la comparaison et ne constituent pas des seuils officiels de sécheresse ou d’inondation, lesquels nécessitent d’autres variables, durées et critères locaux.
Exploiter le résultat avec discernement
Utilisez cet indice pour présenter une comparaison annuelle compacte sans imposer la lecture de douze valeurs séparées. Dans un rapport de station, conservez ensemble le cumul annuel, la moyenne de référence, l’indice, l’écart, la classe et la formule afin que le constat puisse être reproduit. Dans un traitement automatisé, vérifiez que tous les relevés concernent la même année et la même station. Le calcul déterministe renvoie le même JSON pour des entrées identiques, ce qui facilite tests, cache, tableaux de bord et audits. L’indice résume le volume annuel par rapport à la référence, mais ne révèle pas la répartition des pluies. Deux années au même cumul peuvent présenter des régimes mensuels opposés. Pour étudier saisonnalité, concentration, érosion, durée des sécheresses, crues ou disponibilité en eau agricole, examinez aussi la série mensuelle et des indicateurs spécialisés. Le navigateur convient aux contrôles ponctuels ; chaque requête API coûte $0.002.
Cas d’usage
Résumer l’année d’une station
Comparez douze cumuls mensuels complets à la moyenne annuelle historique établie pour la station.
Éclairer un rapport agricole
Indiquez si l’année a été globalement plus humide ou plus sèche que la référence locale, tout en gardant les cumuls.
Automatiser un tableau climatique
Produisez un indice, un écart et une classe stables à partir de relevés mensuels validés.
Questions fréquentes
Que signifie un indice de 100 ?
Le cumul annuel observé est exactement égal à la pluviométrie annuelle moyenne de long terme fournie.
Puis-je utiliser des pouces plutôt que des millimètres ?
Oui. Toute unité de hauteur convient si les douze cumuls et la moyenne annuelle utilisent la même.
Pourquoi fournir une moyenne historique distincte ?
Une référence climatologique indépendante rend la comparaison pertinente. La moyenne des douze mêmes valeurs donnerait un rapport fixe, pas une anomalie d’humidité.
Un cumul mensuel peut-il être nul ?
Oui, pour un mois réellement sans pluie. Ne remplacez pas une observation manquante par zéro.
La classe définit-elle une sécheresse ou une inondation ?
Non. Elle décrit un écart à la moyenne ; une évaluation officielle requiert d’autres indicateurs, périodes et seuils locaux.
Quel est le coût d’un calcul par API ?
Chaque requête API coûte $0.002. Vous pouvez aussi effectuer gratuitement le calcul dans votre navigateur.
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre stack
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}'const res = await fetch("https://api.kit.forhosting.com/earth/pluviometric-index", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"monthly_rainfall": [
82,
76,
91,
104,
118,
132,
145,
127,
109,
96,
88,
92
],
"mean_annual_rainfall": 1200
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/earth/pluviometric-index",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"monthly_rainfall": [
82,
76,
91,
104,
118,
132,
145,
127,
109,
96,
88,
92
],
"mean_annual_rainfall": 1200
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/earth/pluviometric-index", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"monthly_rainfall":[82,76,91,104,118,132,145,127,109,96,88,92],"mean_annual_rainfall":1200}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"monthly_rainfall":[82,76,91,104,118,132,145,127,109,96,88,92],"mean_annual_rainfall":1200}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/earth/pluviometric-index", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"monthly_rainfall": [
82,
76,
91,
104,
118,
132,
145,
127,
109,
96,
88,
92
],
"mean_annual_rainfall": 1200
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "earth.pluviometric_index",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Limites
max_items | 12 |
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |