ForHosting KIT · Viagens e geografia

Risco de geada e congelamento

Uma mínima prevista de 2 °C (35,6 °F) não traz risco, 30 °F é geada leve e 25 °F é congelamento forte: uma mínima noturna, um rótulo claro para cobrir plantas ou ligar aquecedores. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Mínima prevista: 2

Você obtém

Mínima prevista (°C): 2 c
Mínima prevista (°F): 35,6
Risco: none
Nível de risco: None

Jardineiros, operadores de estufas e páginas municipais de alerta de geada precisam de uma resposta única e reproduzível quando a mínima noturna é publicada: não há risco de congelamento, apenas geada leve para plantas sensíveis, ou um congelamento severo que mata anuais e danifica culturas semirresistentes? Esta verificação de risco de geada e congelamento recebe a temperatura mínima prevista —opcionalmente em Celsius ou Fahrenheit— e a classifica segundo limiares comuns de jardinagem e no estilo do National Weather Service. Temperaturas acima do ponto de congelamento mapeiam para none; mínimas em 0 °C (32 °F) ou abaixo, mas ainda acima de 28 °F, para light frost; 28 °F (−2.2 °C) e mais frio, para hard freeze.

O que as categorias de risco de geada e congelamento significam no jardim

A linguagem de geada e congelamento em produtos meteorológicos não é o mesmo que uma anedota de termômetro. Orientações públicas e serviços de extensão costumam distinguir noites que apenas tocam o congelamento de noites frias o bastante para congelar o tecido vegetal em profundidade e matar anuais sensíveis em área ampla. Esta capacidade resume essa orientação em três categorias estáveis para produto e educação.

None significa que a mínima noturna prevista permanece estritamente acima de 0 °C (32 °F), de modo que, com o conjunto simplificado de regras, não se espera que o ar livre congele água na superfície. Light frost cobre mínimas desde logo acima da linha de hard freeze até o congelamento inclusive: isto é, maior que 28 °F até 32 °F, ou em Celsius maior que −20⁄9 °C até 0 °C.

Nessa faixa, plantas de canteiro sensíveis, tropicais de interior deixadas fora e muitas mudas de hortaliça podem ser danificadas mesmo quando ornamentais lenhosas sobrevivem. Hard freeze é a faixa em 28 °F ou abaixo (−20⁄9 °C ≈ −2.2222 °C), o limiar que muitas colunas de jardinagem e avisos de congelamento tratam como amplamente destrutivo para plantas sensíveis e muitas semirresistentes.

O classificador não modela geada por radiação em baixadas de drenagem de ar frio, vento, umidade nem zonas de rusticidade: é um mapa determinístico de um número —a mínima prevista— para um rótulo de risco, para que painéis e checagens de aula permaneçam comparáveis noite após noite.

Onde verificar o risco de geada faz mais diferença

Sites de e-commerce de viveiros, bots SMS de hortas comunitárias, projetos escolares de fenologia e checklists municipais de preparação para o inverno precisam da mesma classificação da mínima noturna sem embutir árvores if-else ad hoc em cada pilha de linguagens. Apps de feira agrícola podem agrupar células da grade noturna em categorias antes de decidir quais fileiras precisam de coberturas ou aquecedores. Validação falha não consome saldo.

Casos de uso

Alertas de coberturas e aquecedores de jardim

Mapeie a mínima prevista de cada noite em none, light frost ou hard freeze para que apps peçam coberturas, movam vasos ou liguem aquecedores.

Demonstrações em sala e extensão

Permita que alunos convertam mínimas em Celsius e Fahrenheit nas mesmas categorias de geada usadas em orientações de jardinagem e na terminologia de congelamento.

Páginas de geada de conteúdo e municípios

Alimente widgets SEO e checklists de preparação invernal da cidade com um código de risco determinístico a partir de uma única mínima noturna publicada.

Perguntas frequentes

Qual temperatura é um hard freeze no jardim?

Esta ferramenta trata hard freeze como mínima prevista em 28 °F ou abaixo (−20⁄9 °C ≈ −2.22 °C). Acima disso até o congelamento é light frost; acima de 32 °F é none.

Posso informar a mínima em Fahrenheit?

Pode. Escolha Celsius ou Fahrenheit; se não indicar nada, vale Celsius. O resultado sempre traz a mínima nas duas escalas, então 2 °C aparece também como 35,6 °F.

Uma mínima de exatamente 0 °C conta como geada?

Conta. Uma mínima de exatamente 0 °C, ou 32 °F, é classificada como geada leve. Só aparece sem risco quando a mínima prevista fica estritamente acima do ponto de congelamento, para que uma noite no limite não passe despercebida.

O que fazer quando o resultado é geada leve?

Proteja as plantas sensíveis: flores de canteiro, plantas tropicais deixadas do lado de fora e muitas mudas de hortaliças podem ser danificadas mesmo quando arbustos lenhosos resistem. O comum é cobrir os canteiros ou abrigar os vasos.

A verificação considera baixadas, vento ou zonas de rusticidade?

Não. Ela transforma um único número, a mínima prevista, em um rótulo. Ar frio acumulado em baixadas, vento, umidade e zonas de rusticidade não entram no cálculo, então ajuste o resultado se o seu terreno costuma ser mais frio.

Ferramentas relacionadas

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

POSThttps://api.kit.forhosting.com/weather/frost-freeze-risk-check

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/weather/frost-freeze-risk-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"forecast_low":2}'

const res = await fetch("https://api.kit.forhosting.com/weather/frost-freeze-risk-check", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "forecast_low": 2
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/weather/frost-freeze-risk-check",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "forecast_low": 2
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/weather/frost-freeze-risk-check", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"forecast_low":2}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"forecast_low":2}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/weather/frost-freeze-risk-check", 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

{
  "forecast_low": 2
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "weather.frost_freeze_risk_check",
  "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

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

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.

Notas técnicas

Mínimas ausentes falham com invalid_input para que a automação nunca invente uma categoria.

Contrato de entrada, unidades, campos de resposta e erros

Valores não finitos como NaN ou Infinity também falham. Fixe nos testes os campos convertidos a quatro decimais e a string exata de risk para que os clientes não dependam só do texto livre de summary. Envie por POST um corpo JSON com forecast_low como número finito obrigatório: a mínima noturna ou do período que você está classificando. Se o campo estiver ausente, for null ou uma string vazia, a tarefa falha com invalid_input e a mensagem nomeia forecast_low; essas falhas não são cobradas. O unit opcional aceita c, celsius, f ou fahrenheit (padrão c) para que produtos de previsão em Fahrenheit dos EUA e previsões métricas compartilhem um endpoint. Aliases de forecast_low incluem low, temperature, temp, low_temp, forecast_low_temp e overnight_low; unit também aceita units, temp_unit e scale. Em sucesso, a resposta ecoa forecast_low e unit, sempre fornece forecast_low_c e forecast_low_f arredondados a quatro casas decimais para exibições de unidade dupla, retorna risk como none, light_frost ou hard_freeze, e risk_label como frase curta em inglês para chips de interface. threshold_freeze_c e threshold_hard_freeze_c expõem as linhas de corte numéricas usadas, summary explica a categoria em uma frase e formula reafirma a regra de três vias para auditoria ao lado da resposta. Exemplo: forecast_low de 2 com unit c produz none; 30 com unit f produz light frost; 25 com unit f produz hard freeze.

Onde uma API de risco de geada e congelamento se paga

Equipes de conteúdo que ranqueiam por risco de geada ou limiar de hard freeze podem incorporar o caminho gratuito do navegador enquanto a automação envia o mesmo forecast_low do exemplo do artigo e armazena o código de risco estruturado. Como a implementação é parse pura tier A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo e sem busca meteorológica de saída — quem chama já tem a mínima prevista do provedor preferido. Documente que geada por radiação sob céu limpo e calmo ainda pode danificar plantas quando a temperatura de abrigo está ligeiramente acima do congelamento, trate este endpoint como classificador de limiar e não como modelo de microclima, e você obtém rótulos de risco de jardim reproduzíveis para educação, mídia e workers na borda sem rederivar a cada estação as linhas de corte em Fahrenheit e Celsius.

Perguntas técnicas

Como verifico o risco de geada ou congelamento a partir de uma mínima prevista?

Envie forecast_low (e unit c ou f opcional). A API retorna risk none, light_frost ou hard_freeze com limiares 0 °C / 32 °F e 28 °F (−2.2 °C), além de conversões para Celsius e Fahrenheit.

E se forecast_low estiver ausente?

A tarefa falha com invalid_input. Um valor de temperatura é obrigatório; mínimas vazias ou ausentes não são cobradas e não inventam categoria de risco.

Posso enviar mínimas noturnas em Fahrenheit?

Sim. Defina unit como f ou fahrenheit. O unit padrão é c (Celsius). forecast_low_c e forecast_low_f são retornados para exibição.

Quanto custa a verificação de risco de geada e congelamento?

A ferramenta no navegador é gratuita. Solicitações API usam saldo pré-pago do KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.

Ver a documentação completa do KIT →

Executar grátis