ForHosting KIT · Voyages et géographie

Risque de gel et de gelée

Un minimum prévu de 2 °C (35,6 °F) ne présente aucun risque, 30 °F correspond à une gelée légère et 25 °F à un gel dur : un minimum nocturne, une étiquette claire pour couvrir les plantes ou allumer le chauffage. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Minimale prévue: 2

Vous obtenez

Minimale prévue (°C): 2 c
Minimale prévue (°F): 35,6
Risque: none
Niveau de risque: None

Jardiniers, exploitants de serres et pages municipales d’alerte au gel ont besoin d’une réponse unique et reproductible lorsque le minimum nocturne est publié : y a-t-il aucun risque de gel, seulement une gelée légère pour les plantes fragiles, ou un gel dur qui tue les annuelles et abîme les cultures semi-rustiques ? Cette vérification du risque de gel et de gelée prend la température minimale prévue — en Celsius ou Fahrenheit au choix — et la classe selon des seuils courants de jardinage et du style du National Weather Service. Les températures au-dessus du point de congélation correspondent à none ; les minima à 0 °C (32 °F) ou en dessous mais encore au-dessus de 28 °F, à light frost ; 28 °F (−2.2 °C) et plus froid, à hard freeze.

Ce que signifient les catégories de risque de gel et de gelée au jardin

Le vocabulaire de gel et de gelée dans les produits météo n’est pas une anecdote de thermomètre. Les guides publics et les services de vulgarisation distinguent souvent les nuits qui frôlent seulement la congélation des nuits assez froides pour geler en profondeur les tissus végétaux et tuer les annuelles fragiles sur une large zone. Cette capacité résume cette orientation en trois catégories stables pour le produit et l’enseignement.

None signifie que le minimum nocturne prévu reste strictement au-dessus de 0 °C (32 °F), de sorte qu’avec l’ensemble de règles simplifié, l’air libre n’est pas censé geler l’eau en surface. Light frost couvre les minima depuis juste au-dessus de la ligne de gel dur jusqu’à la congélation incluse : c’est-à-dire plus de 28 °F jusqu’à 32 °F, ou en Celsius plus de −20⁄9 °C jusqu’à 0 °C.

Dans cette bande, les plantes de massif fragiles, les plantes d’intérieur tropicales laissées dehors et de nombreux semis potagers peuvent être endommagés même si les ornementales ligneuses survivent. Hard freeze est la bande à 28 °F ou en dessous (−20⁄9 °C ≈ −2.2222 °C), le seuil que de nombreuses chroniques de jardin et alertes au gel traitent comme largement destructeur pour les plantes fragiles et bien des semi-rustiques.

Le classifieur ne modélise pas le gel de rayonnement dans les creux de drainage d’air froid, le vent, l’humidité ni les zones de rusticité : c’est une carte déterministe d’un nombre — le minimum prévu — vers une étiquette de risque pour que tableaux de bord et contrôles de cours restent comparables nuit après nuit.

Où vérifier le risque de gel est le plus utile

Sites e-commerce de pépinières, bots SMS de jardins partagés, projets scolaires de phénologie et listes municipales de préparation à l’hiver ont besoin de la même classification du minimum nocturne sans embarquer des arbres if-else ad hoc dans chaque pile de langages. Les applications de marchés agricoles peuvent regrouper les cellules de la grille nocturne en catégories avant de décider quelles rangées ont besoin de voiles ou de chauffages. Une validation échouée ne consomme pas le solde.

Cas d’usage

Alertes voiles et chauffages de jardin

Classez le minimum prévu de chaque nuit en none, light frost ou hard freeze pour que les applications demandent des voiles, déplacent les pots ou démarrent les chauffages.

Démonstrations en classe et vulgarisation

Permettez aux élèves de convertir des minima Celsius et Fahrenheit dans les mêmes catégories de gelée utilisées dans les guides de jardinage et la terminologie du gel.

Pages gel de contenu et municipales

Alimentez des widgets SEO et des listes de préparation hivernale de la ville avec un code de risque déterministe à partir d’un seul minimum nocturne publié.

Questions fréquentes

Quelle température correspond à un gel dur au jardin ?

Cet outil traite hard freeze comme un minimum prévu à 28 °F ou en dessous (−20⁄9 °C ≈ −2.22 °C). Au-dessus jusqu’à la congélation : light frost ; au-dessus de 32 °F : none.

Puis-je saisir le minimum en Fahrenheit ?

Oui. Choisissez Celsius ou Fahrenheit ; sans précision, c’est Celsius. Le résultat donne toujours le minimum dans les deux échelles, si bien que 2 °C apparaît aussi comme 35,6 °F.

Un minimum d’exactement 0 °C compte-t-il comme gelée ?

Oui. Un minimum d’exactement 0 °C, soit 32 °F, est classé en gelée légère. Le résultat n’indique aucun risque que si le minimum prévu reste strictement au-dessus du point de congélation, pour qu’une nuit limite ne passe pas inaperçue.

Que faire en cas de gelée légère ?

Protégez les plantes sensibles : plantes à massif, plantes tropicales restées dehors et beaucoup de jeunes plants de légumes peuvent souffrir même quand les arbustes ligneux résistent. On couvre alors les rangs ou on abrite les pots.

Le calcul tient-il compte des cuvettes, du vent ou des zones de rusticité ?

Non. Il transforme un seul chiffre, le minimum prévu, en une étiquette. L’air froid qui stagne dans les cuvettes, le vent, l’humidité et les zones de rusticité ne sont pas modélisés : ajustez le résultat si votre terrain est plus froid.

Outils associés

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

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

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/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)

Exemple de requête

{
  "forecast_low": 2
}

Exemple de réponse

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

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

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.

Notes techniques

Un minimum manquant échoue avec invalid_input pour que l’automatisation n’invente jamais une catégorie.

Contrat d’entrée, unités, champs de réponse et erreurs

Les valeurs non finies comme NaN ou Infinity échouent aussi. Verrouillez dans les tests les champs convertis à quatre décimales et la chaîne exacte de risk pour que les clients ne dépendent pas du seul libellé libre de summary. Envoyez en POST un corps JSON avec forecast_low comme nombre fini obligatoire : le minimum nocturne ou de période que vous classifiez. Si le champ est absent, null ou une chaîne vide, la tâche échoue avec invalid_input et le message nomme forecast_low ; ces échecs ne sont pas facturés. L’unit optionnel accepte c, celsius, f ou fahrenheit (défaut c) pour que les prévisions américaines en Fahrenheit et les prévisions métriques partagent un même endpoint. Les alias de forecast_low incluent low, temperature, temp, low_temp, forecast_low_temp et overnight_low ; unit accepte aussi units, temp_unit et scale. En cas de succès, la réponse renvoie forecast_low et unit, fournit toujours forecast_low_c et forecast_low_f arrondis à quatre décimales pour les affichages double unité, renvoie risk comme none, light_frost ou hard_freeze, et risk_label comme courte phrase en anglais pour les pastilles d’interface. threshold_freeze_c et threshold_hard_freeze_c exposent les seuils numériques utilisés, summary explique la catégorie en une phrase et formula reformule la règle à trois voies pour l’audit à côté de la réponse. Exemple : forecast_low de 2 avec unit c donne none ; 30 avec unit f donne light frost ; 25 avec unit f donne hard freeze.

Où une API de risque de gel et de gelée prouve son utilité

Les équipes de contenu qui se positionnent sur le risque de gelée ou le seuil de gel dur peuvent intégrer le chemin gratuit du navigateur tandis que l’automatisation envoie le même forecast_low que l’exemple de l’article et stocke le code de risque structuré. Comme l’implémentation est parse pure de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni requête météo sortante : l’appelant a déjà le minimum prévu de son fournisseur préféré. Documentez qu’un gel de rayonnement sous ciel clair et calme peut encore abîmer les plantes lorsque la température d’abri est légèrement au-dessus de la congélation, traitez ce endpoint comme un classifieur de seuils et non un modèle de microclimat, et vous obtenez des étiquettes de risque jardin reproductibles pour l’éducation, les médias et les workers en périphérie sans redériver chaque saison les seuils Fahrenheit et Celsius.

Questions techniques

Comment vérifier le risque de gel ou de gelée à partir d’un minimum prévu ?

Envoyez forecast_low (et unit c ou f en option). L’API renvoie risk none, light_frost ou hard_freeze avec les seuils 0 °C / 32 °F et 28 °F (−2.2 °C), plus les conversions Celsius et Fahrenheit.

Que se passe-t-il si forecast_low est manquant ?

La tâche échoue avec invalid_input. Une valeur de température est requise ; les minima vides ou absents ne sont pas facturés et n’inventent pas de catégorie de risque.

Puis-je envoyer des minima nocturnes en Fahrenheit ?

Oui. Définissez unit sur f ou fahrenheit. L’unit par défaut est c (Celsius). forecast_low_c et forecast_low_f sont renvoyés pour l’affichage.

Quel est le coût de la vérification du risque de gel et de gelée ?

L’outil navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; une entrée invalide n’est pas facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement