Mesures du cercle
Un rayon, trois réponses : un cercle de rayon 5 a un diamètre de 10, une circonférence de 31,415927 et une aire de 78,539816. Utile pour chiffrer des plateaux, des pelouses ou des panneaux ronds sans trois formules séparées. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Rayon
- 5
- Aire
- 78,539816
- Circonférence
- 31,415927
- Diamètre
- 10
aire, circonférence et diamètre
D'un rayon à trois mesures
Tout cercle est entièrement décrit par un seul nombre, son rayon, et toute autre mesure du cercle en est un multiple fixe. Le diamètre est simplement le rayon doublé. La circonférence — la distance que vous parcourriez pour faire le tour du cercle — est deux fois pi multiplié par le rayon.
L'aire — la surface que le cercle délimite — est pi multiplié par le rayon au carré. Ce point de terminaison applique ces trois formules au rayon que vous envoyez et renvoie les trois résultats ensemble dans un seul objet, de sorte que l'appelant n'a jamais à se souvenir quelle formule élève le rayon au carré et laquelle le double.
Comme les trois valeurs proviennent de la même entrée dans le même passage, elles sont toujours cohérentes entre elles : le diamètre est exactement le double de votre rayon, et la circonférence et l'aire en découlent exactement, sans arrondi intermédiaire entre les formules. Vous pouvez également contrôler le nombre de décimales de chaque résultat, de zéro à douze, grâce au paramètre optionnel decimals.
Validation, arrondi et déterminisme
Le point de terminaison est délibérément strict sur son entrée. Le rayon doit être un nombre, il doit être fini et il doit être supérieur à zéro. La même rigueur s'applique au paramètre optionnel decimals, qui doit être un entier entre zéro et douze.
L'arrondi utilise la règle de la moitié vers le haut au nombre de décimales demandé, plutôt que le formatage flottant par défaut de la plateforme, ce qui compte plus qu'il n'y paraît : des résultats bruts en virgule flottante comme 0.1 + 0.2 diffèrent dans leurs derniers chiffres selon la façon dont ils sont affichés, et une sortie non stabilisée rendrait les comparaisons automatisées fragiles.
Avec l'arrondi déterministe de la moitié vers le haut, le même rayon produit toujours une sortie identique octet par octet, sur n'importe quelle machine et à tout moment, ce qui rend le résultat sûr à stocker, comparer et mettre en cache.
Où il s'intègre dans le travail réel
Les cercles apparaissent dans bien plus d'endroits que les devoirs de géométrie. Un atelier qui découpe des plateaux de table circulaires a besoin de l'aire pour estimer le matériau et de la circonférence pour commander le chant. Un paysagiste qui chiffre une pelouse circulaire a besoin de l'aire pour le gazon et du périmètre pour la clôture.
Un ingénieur qui dimensionne un tuyau ou un arbre convertit constamment entre rayon, diamètre et aire de la section. En logiciel, le point de terminaison fonctionne très bien comme une petite étape déterministe au sein d'une chaîne plus large : un outil de devis qui tarife des pièces rondes, un configurateur qui valide les dimensions avant d'accepter une commande, ou une application pédagogique qui montre aux élèves comment les trois formules évoluent ensemble quand le rayon change.
Cas d’usage
Chiffrer le matériau de pièces circulaires
Obtenez l'aire d'un plateau, d'un panneau ou d'un disque circulaire à partir de son rayon pour estimer le matériau, et la circonférence pour tarifer le chant ou la garniture dans le même appel.
Valider les dimensions dans un configurateur
Vérifiez le rayon saisi par l'utilisateur avant d'accepter une commande, en rejetant les valeurs nulles, négatives ou non numériques avec une erreur claire plutôt qu'un calcul erroné en aval.
Enseigner les trois formules du cercle
Montrez aux élèves comment le diamètre, la circonférence et l'aire évoluent ensemble quand le rayon change, avec des résultats arrondis de façon identique sur toutes les machines.
Questions fréquentes
Combien cela coûte-t-il ?
C'est aussi gratuit dans votre navigateur sur cette page.
Quelle entrée faut-il ?
Uniquement le rayon du cercle, sous forme de nombre positif et fini. En option, un paramètre decimals (de 0 à 12) qui contrôle l'arrondi des résultats.
Que renvoie-t-il exactement ?
Un objet avec trois champs : area, circumference et diameter, chacun arrondi par moitié vers le haut au nombre de décimales demandé.
Quelle valeur de pi est utilisée ?
La valeur de pi en double précision fournie par l'environnement d'exécution (Math.PI), de sorte que les résultats correspondent aux calculs scientifiques et d'ingénierie habituels.
Quelque chose est-il conservé après l'appel ?
Non. Le calcul est effectué en mémoire et seules les trois mesures sont renvoyées.
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
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/math/circle-measurements \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"radius":5}'const res = await fetch("https://api.kit.forhosting.com/math/circle-measurements", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"radius": 5
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/math/circle-measurements",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"radius": 5
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/math/circle-measurements", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"radius":5}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"radius":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/math/circle-measurements", 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
{
"radius": 5
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "math.circle_measurements",
"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.
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
L'API de mesures du cercle prend un seul nombre — le rayon d'un cercle — et renvoie les trois mesures que toute tâche de géométrie finit par demander : l'aire délimitée par le cercle, la circonférence qui l'entoure et le diamètre qui le traverse. Un seul appel remplace trois recherches de formules, chaque résultat est arrondi au nombre de décimales que vous configurez, et le calcul est une arithmétique exacte sur des nombres en double précision, de sorte que la réponse obtenue dans le navigateur est la même que celle que votre chaîne automatisée reçoit de l'API.
Validation, arrondi et déterminisme
Un rayon nul ou négatif ne décrit pas un cercle, et une valeur non numérique ne décrit rien du tout : les deux sont donc rejetés avec une erreur invalid_input claire qui indique exactement quelle règle a été enfreinte — et les requêtes rejetées ne sont jamais facturées.
Où il s'intègre dans le travail réel
Il s'exécute à la périphérie du réseau sans rien conserver après l'appel, le même code tourne gratuitement dans le navigateur sur cette page, et l'API coûte $0.002 par requête : vous pouvez donc prototyper à la main et ne payer que lorsque vous automatisez l'appel.
Questions techniques
Que se passe-t-il si le rayon est nul, négatif ou n'est pas un nombre ?
La requête est rejetée avec une erreur invalid_input qui explique la règle enfreinte. Les requêtes rejetées ne sont pas facturées.