Índice pluviométrico anual
A calculadora de índice pluviométrico anual transforma doze totais mensais de chuva em uma medida clara de quanto o ano observado foi mais úmido ou mais seco que uma média anual de longo prazo.
Executar grátis
Ela soma os valores mensais e informa um índice em que 100 representa a média. O resultado também traz o desvio percentual, uma classificação direta e a fórmula aplicada, sendo útil para resumos climáticos, relatórios de estações, registros agrícolas e fluxos de dados reproduzíveis.
O significado do índice pluviométrico anual
A calculadora usa a precipitação média anual de longo prazo como referência e expressa a chuva do ano selecionado como uma porcentagem dessa referência. Um índice de 100 significa que a soma dos doze meses coincide exatamente com a média histórica. Um valor de 115 representa 15 por cento mais chuva, enquanto 72 representa 28 por cento menos. Essa medida relativa oferece um contexto que o total anual sozinho não mostra: 900 milímetros podem ser excepcionalmente úmidos em uma estação e muito secos em outra. Todos os totais mensais e a média anual devem usar a mesma unidade de profundidade, como milímetros ou polegadas. A unidade se cancela na razão, portanto o índice não tem unidade. O resultado mantém o total anual e a referência, deixando a comparação transparente, verificável e adequada para relatórios.
Como preparar e interpretar os dados
Informe exatamente doze totais mensais não negativos, de janeiro a dezembro, e uma média anual histórica positiva para o mesmo local e método de observação. De preferência, use um período climatológico estável. Não misture milímetros com polegadas, medições de estação com estimativas regionais nem meses incompletos com totais completos. Zero é válido quando realmente não houve chuva, mas não deve substituir uma observação ausente. A saída considera 95 a 105 próximo da média; abaixo de 80 é muito mais seco, de 80 a menos de 95 é mais seco, acima de 105 até 120 é mais úmido e acima de 120 é muito mais úmido. Essas faixas são recursos descritivos, não declarações oficiais de seca ou inundação, que normalmente dependem de outras variáveis, escalas de tempo e limites definidos localmente.
Uso responsável em relatórios e automações
Use o índice quando precisar de uma comparação anual compacta e fácil de entender sem examinar doze números separados. Em relatórios de estação, mantenha juntos o total anual, a média de referência, o índice, o desvio, a classificação e a fórmula, permitindo que outras pessoas reproduzam a conclusão. Em automações, confirme antes que todos os registros pertencem ao mesmo ano e à mesma estação. Como o cálculo é determinístico, entradas idênticas produzem o mesmo JSON, facilitando testes, cache, painéis e auditorias. O índice descreve o volume anual em relação à referência, mas não mostra quando a chuva ocorreu. Dois anos podem ter o mesmo total e distribuições mensais muito diferentes. Para analisar sazonalidade, concentração, erosão, duração de secas, enchentes ou disponibilidade de água agrícola, consulte também a série mensal e indicadores especializados. A versão no navegador atende verificações individuais; cada chamada de API custa US$ 0,002.
Casos de uso
Resumir o ano de uma estação
Compare um ano completo de totais mensais com a média anual histórica definida para a estação.
Contextualizar um relatório agrícola
Indique se o ano registrado foi geralmente mais úmido ou seco que a referência local, preservando os totais usados.
Automatizar painéis climáticos
Gere índice, desvio e classificação estáveis a partir de registros mensais previamente validados.
Perguntas frequentes
O que significa um índice de 100?
Significa que a chuva anual observada é exatamente igual à média anual histórica informada.
Posso usar polegadas em vez de milímetros?
Sim. Use qualquer unidade de profundidade, desde que os totais mensais e a média anual estejam na mesma unidade.
Por que preciso informar outra média histórica?
Uma referência climatológica independente torna a comparação significativa. Usar a média dos mesmos doze valores criaria uma relação fixa, não uma anomalia de umidade.
Um total mensal pode ser zero?
Sim, quando o mês realmente não teve chuva. Não use zero apenas para substituir uma observação ausente.
A classificação define seca ou inundação?
Não. Ela apenas compara o ano com a média; avaliações formais exigem outros indicadores, períodos e limites locais.
Quanto custa um cálculo pela API?
Cada solicitação pela API custa US$ 0,002. Você também pode fazer o cálculo gratuitamente no navegador nesta página.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
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)Exemplo de requisição
{
"monthly_rainfall": [
82,
76,
91,
104,
118,
132,
145,
127,
109,
96,
88,
92
],
"mean_annual_rainfall": 1200
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "earth.pluviometric_index",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_items | 12 |
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |