Calcolatore di circonferenza
Calcoli la lunghezza intorno a un cerchio con la misura che ha, raggio o diametro: un raggio di 5 dà 31,415927, e il risultato indica quale dei due è stato usato. Utile per cinghie, ruote e bordure da giardino. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Raggio
- 5
- Circonferenza
- 31,415927
- Dato
- radius
È una risposta piccola e deterministica a una domanda che ricorre ogni giorno in ingegneria, produzione, didattica e design, consegnata in una sola richiesta invece che in una cella di foglio di calcolo o in una calcolatrice. Lo stesso codice che risponde qui gira gratuitamente nel Suo browser su questa pagina.
Da una sola misura alla lunghezza completa del contorno
Ogni cerchio obbedisce alla stessa relazione: la distanza lungo il suo contorno è π volte la distanza che lo attraversa. Se conosce il diametro — la retta che passa per il centro da un bordo all'altro — la circonferenza è semplicemente π·d. Se conosce il raggio — la distanza dal centro al bordo — la circonferenza è 2·π·r.
Fornisce esattamente uno dei due campi e la risposta le indica sia la circonferenza sia l'input utilizzato, sotto la chiave <em>given</em>. Questo conta nella pratica perché le misure arrivano nella forma prodotta dallo strumento a disposizione: un calibro restituisce un diametro, un disegno segna un raggio, una scheda tecnica l'uno o l'altro.
Precisione, arrotondamento e validazione su cui contare
Il calcolo usa il valore di π in doppia precisione integrato nel runtime (3.141592653589793) e arrotonda il risultato half-up a un numero fisso di cifre decimali — sei per impostazione predefinita, regolabile da zero a dodici con il campo <em>decimals</em>. L'arrotondamento half-up a un numero fisso di decimali è una scelta deliberata: rende l'output stabile e identico su qualsiasi macchina, così un risultato verificato in un test oggi corrisponde byte per byte anche l'anno prossimo su hardware diverso. La validazione è altrettanto rigorosa.
Anche il campo <em>decimals</em> deve essere un intero entro il suo intervallo.
Dove si colloca il calcolo della circonferenza nel lavoro reale
La circonferenza è la grandezza nascosta dietro molte stime quotidiane. Chi produce e deve tagliare una cinghia o una fascia per un tamburo ha bisogno della lunghezza attorno al tamburo, non della sua larghezza. Un ciclista che imposta la dimensione della ruota in un ciclocomputer inserisce una circonferenza derivata dal raggio della ruota.
Un insegnante che prepara esercizi vuole un generatore affidabile di risposte corrette, e un giardiniere che ordina bordure per un'aiuola circolare ha bisogno del perimetro prima del preventivo. Nel software, il valore alimenta spesso un calcolo più ampio: lunghezza del materiale, distanza percorsa per giro o spaziatura delle tacche su un quadrante. Non calcola di proposito l'area, il diametro dalla circonferenza o altre proprietà del cerchio — gli strumenti mirati sono più facili da verificare e da testare.
Se le serve il diametro da una qualsiasi misura del cerchio, esiste una capability separata per la ricerca inversa; se le servono tutte le proprietà del cerchio insieme, il calcolatore generale del cerchio le copre. Questo risponde all'unica domanda «quanto è lungo il giro completo?» e a nient'altro.
Casi d'uso
Tagliare materiale per un oggetto rotondo
Ottenga la lunghezza esatta di striscia, cinghia o cavo necessaria per avvolgere un tamburo, un tubo o una ruota dal diametro misurato, prima di ordinare il materiale.
Alimentare un calcolo di distanza per giro
Calcoli la circonferenza della ruota dal suo raggio per calibrare odometri, encoder rotativi e ciclocomputer.
Generare risposte di geometria verificate
Produca valori di circonferenza deterministici per esercizi, test o verifiche CAD, con arrotondamento identico byte per byte su ogni macchina.
Domande frequenti
Quanto costa?
È inoltre gratuito da eseguire nel Suo browser su questa pagina.
Quali input accetta?
Esattamente uno tra raggio e diametro, come numero positivo e finito. Inviando entrambi o nessuno ottiene un errore di input non valido.
Posso controllare la precisione del risultato?
Sì. Il campo decimals imposta il numero di cifre decimali, da 0 a 12, con arrotondamento half-up. Il valore predefinito è 6.
Cosa succede se il raggio è zero o negativo?
La richiesta viene rifiutata con un errore di input non valido e non viene addebitata. La misura deve essere un numero positivo e finito.
Il risultato mantiene la mia unità di misura?
Sì. La circonferenza viene restituita nella stessa unità del raggio o del diametro fornito; non viene applicata alcuna conversione di unità.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/math/circle-length \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"radius":5}'const res = await fetch("https://api.kit.forhosting.com/math/circle-length", {
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-length",
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-length", 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-length", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"radius": 5
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "math.circle_length",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
L'API di lunghezza del cerchio calcola la circonferenza — la distanza lungo il suo bordo — a partire da un'unica misura che già possiede: il raggio oppure il diametro. Invia un numero positivo e riceve la circonferenza secondo le formule esatte C = 2·π·r oppure C = π·d, con arrotondamento half-up al numero di cifre decimali che sceglie.
Da una sola misura alla lunghezza completa del contorno
L'endpoint del calcolatore di circonferenza del cerchio applica esattamente una di queste due formule in base al campo che invia, così non deve mai convertire da solo tra raggio e diametro né ricordare quale fattore va dove. L'endpoint si rifiuta di indovinare: se invia entrambi i campi, o nessuno, risponde con un errore di input non valido invece di sceglierne uno silenziosamente, perché due numeri in una sola richiesta di solito indicano un bug nel chiamante che va fatto emergere subito, non mascherato con una media.
Precisione, arrotondamento e validazione su cui contare
La misura deve essere un numero positivo e finito; zero, valori negativi, input non numerici e infiniti vengono rifiutati con un errore <em>invalid_input</em>, che non viene mai addebitato. Poiché l'endpoint è puramente deterministico — nessuna chiamata di rete, nessuna casualità, nessun orologio — lo stesso input produce sempre lo stesso output. È questa proprietà che permette alla versione gratuita nel browser su questa pagina di eseguire il modulo identico e di promettere esattamente ciò che restituisce l'API a pagamento, ed è ciò che rende l'endpoint sicuro da integrare in cicli di retry e pipeline con cache.
Dove si colloca il calcolo della circonferenza nel lavoro reale
L'endpoint è progettato esattamente per questi punti di chiamata: una misura in ingresso, un numero in uscita, al prezzo di $0.002 per richiesta e gratuito per l'uso interattivo nel browser.
Domande tecniche
Quale formula viene usata?
C = 2·π·r dal raggio, oppure C = π·d dal diametro, con π = 3.141592653589793.