Scala colori per intervalli
Lo strumento per scale cromatiche a intervalli assegna un valore numerico a una delle suddivisioni di pari ampiezza e restituisce il colore corrispondente tra due estremi esadecimali.
Esegui gratis nel browser
Indichi il valore, minimo e massimo inclusivi, numero di intervalli e colori iniziale e finale. Lo strumento convalida ogni dato, gestisce esplicitamente il limite superiore e produce sempre lo stesso risultato. Può usarlo per dashboard, mappe, fasce di punteggio, legende, relazioni e qualsiasi processo che richieda una classificazione ripetibile anziché una sfumatura continua.
Trasformi una scala continua in categorie affidabili
Una sfumatura continua può suggerire una precisione superiore a quella reale della misurazione. Gli intervalli rendono esplicita la scelta: ogni valore nella stessa fascia riceve esattamente lo stesso colore. Inserisca il valore numerico, gli estremi inferiore e superiore inclusivi e il numero di intervalli desiderato. Lo strumento divide la scala in fasce di uguale ampiezza, le numera a partire da uno e restituisce sia l’indice con base zero sia i limiti numerici. Ogni intervallo include il limite inferiore ed esclude quello superiore, tranne l’ultimo che comprende il massimo dichiarato. Questa regola impedisce a sistemi diversi di classificare in modo differente un valore posto esattamente sul confine. L’indicatore restituito specifica anche se il limite superiore è inclusivo. È utile quando grafici, esportazioni, servizi e viste web devono classificare i valori nello stesso modo. La funzione non esamina un insieme di dati e non calcola quantili statistici: minimo e massimo forniti definiscono la scala, quindi l’esito non dipende da osservazioni nascoste o dal loro ordine.
Costruisca la scala con interpolazione RGB deterministica
Il primo intervallo usa il colore iniziale e l’ultimo quello finale. I colori intermedi si ottengono interpolando separatamente i canali rosso, verde e blu e arrotondando ciascun canale all’intero più vicino. La posizione dipende dall’indice dell’intervallo, non dal valore grezzo: due valori nella stessa fascia ricevono quindi lo stesso colore esadecimale. Gli estremi accettano sei cifre esadecimali con o senza cancelletto; l’uscita viene normalizzata in minuscolo con cancelletto. L’interpolazione RGB è volutamente semplice e riproducibile sia nell’API sia nel browser. Non è un modello percettivo; per palette con requisiti di accessibilità, scelga estremi i cui colori intermedi restino distinguibili e sufficientemente contrastati. Il risultato comprende colore, indice, numero leggibile, totale degli intervalli e limiti numerici. Con questi dati può colorare un elemento e generare una descrizione, una legenda, una convalida o una registrazione di audit coerente senza ricreare altrove il calcolo dei confini.
Convalidi gli intervalli prima della visualizzazione
La limitazione silenziosa sembra comoda finché un difetto a monte non colora come valido un valore impossibile. Lo strumento rifiuta invece numeri non finiti, scale invertite o senza ampiezza, valori fuori dai limiti inclusivi, colori malformati e quantità diverse da interi tra 2 e 256. Gli errori diventano utilizzabili e la dashboard non nasconde misurazioni errate. Definisca i limiti nel sistema responsabile della metrica e li riutilizzi per ogni valore. Se la distribuzione è molto asimmetrica e servono veri quantili con popolazioni uguali, calcoli prima le relative soglie; questa capacità crea intervalli di uguale ampiezza fra estremi espliciti. Per una legenda stabile, applichi le stesse regole nella creazione delle etichette e nella colorazione. Il massimo riceve un trattamento speciale affinché la divisione in virgola mobile non lo collochi oltre l’ultimo indice. Gli altri confini esatti entrano naturalmente nell’intervallo successivo secondo la convenzione documentata. Browser e API a pagamento condividono lo stesso algoritmo puro, consentendole di provare il risultato prima di automatizzarlo al costo di $0.002 per richiesta.
Casi d'uso
Colorare una dashboard prestazionale
Assegni colori coerenti a latenza, ricavi, utilizzo o qualità in schede e grafici.
Creare una classificazione coropletica
Distribuisca le misurazioni regionali in intervalli fissi e mantenga i riempimenti della mappa coerenti con la legenda.
Uniformare le fasce di rischio
Applichi scala, numero di intervalli e palette condivisi a punteggi ripetibili in relazioni ed esportazioni.
Domande frequenti
Lo strumento calcola quantili statistici da un insieme di dati?
No. Crea intervalli di pari ampiezza tra minimo e massimo espliciti e non riceve né analizza un insieme di dati.
Che cosa accade quando il valore coincide con il massimo?
Il massimo è valido e viene assegnato all’ultimo intervallo, il cui limite superiore è inclusivo.
Quali formati di colore sono accettati?
Usi un colore RGB esadecimale a sei cifre, con o senza cancelletto. L’uscita è minuscola e include il cancelletto.
Come vengono calcolati i colori intermedi?
I canali rosso, verde e blu sono interpolati separatamente secondo la posizione dell’intervallo e arrotondati a interi.
È possibile limitare i valori esterni alla scala?
No. Vengono rifiutati affinché misurazioni non valide non appaiano silenziosamente come colori estremi validi.
Quanto costa?
L’API costa $0.002 per richiesta. Lo stesso calcolo deterministico può essere eseguito gratuitamente nel browser.
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/color/scale-buckets \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"value":72,"min":0,"max":100,"buckets":5,"start_color":"#ffffcc","end_color":"#800026"}'const res = await fetch("https://api.kit.forhosting.com/color/scale-buckets", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"value": 72,
"min": 0,
"max": 100,
"buckets": 5,
"start_color": "#ffffcc",
"end_color": "#800026"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/color/scale-buckets",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"value": 72,
"min": 0,
"max": 100,
"buckets": 5,
"start_color": "#ffffcc",
"end_color": "#800026"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/color/scale-buckets", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"value":72,"min":0,"max":100,"buckets":5,"start_color":"#ffffcc","end_color":"#800026"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"value":72,"min":0,"max":100,"buckets":5,"start_color":"#ffffcc","end_color":"#800026"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/color/scale-buckets", 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
{
"value": 72,
"min": 0,
"max": 100,
"buckets": 5,
"start_color": "#ffffcc",
"end_color": "#800026"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "color.scale_buckets",
"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. |