Convertitore di numeri maya in punti e barre
Il convertitore di numeri maya trasforma un intero decimale non negativo in una chiara rappresentazione in base venti, formata da punti, barre e dal simbolo della conchiglia per lo zero.
Esegui gratis nel browser
Il risultato elenca ogni riga posizionale dalla potenza di venti più significativa fino alle unità, risultando adatto alla didattica, alla verifica di esercizi scritti a mano o alla creazione di un numero personalizzato. Ogni riga comprende potenza, valore della cifra e componenti simbolici. La conversione è deterministica e privata nel browser; ogni richiesta automatizzata all’API costa $0.002.
Legga un numero maya come un valore in base venti
I numeri maya adottano una notazione posizionale, come i comuni numeri decimali, ma ogni posizione vale venti volte quella sottostante. La riga inferiore, o meno significativa, rappresenta le unità; la successiva indica gruppi di venti; quella dopo ancora gruppi di quattrocento, e così via. Il convertitore restituisce le righe nell’ordine impiegato da molti formati di dati: prima la più significativa e per ultima quella delle unità. L’elenco può quindi essere elaborato agevolmente da sinistra a destra, conservando il rapporto verticale del numero scritto. In una riga, un punto vale uno e una barra vale cinque. I valori da uno a diciannove combinano fino a tre barre e quattro punti. Lo zero usa una conchiglia, affinché una posizione vuota rimanga visibile. Il campo power specifica la potenza di venti occupata dalla riga, value fornisce la cifra da zero a diciannove e symbols contiene gli elementi necessari per disegnarla o descriverla senza doverne dedurre la scomposizione.
Scelga e convalidi il valore decimale
Fornisca un solo campo denominato number contenente un intero JSON maggiore o uguale a zero. Lo zero è valido e produce una riga con una conchiglia, non un risultato vuoto. I valori negativi vengono rifiutati perché questa rappresentazione è definita soltanto per interi non negativi. Anche frazioni, testo numerico come "429", valori mancanti, infiniti e numeri oltre l’intervallo sicuro degli interi JavaScript sono respinti anziché essere arrotondati o reinterpretati silenziosamente. Questa severità è importante quando la conversione deve essere valutata, archiviata o usata per generare un’illustrazione: un valore che sembra soltanto numerico non deve diventare per errore un altro numero. In caso di successo, il risultato ripete il numero originale, identifica la base venti e restituisce le righe dalla potenza maggiore alla minore. Ogni posizione resta presente, compreso uno zero interno, perché eliminare una conchiglia fra due righe non nulle cambierebbe il valore. Lei può quindi convalidare meccanicamente la struttura o copiare i simboli seguendo regole prevedibili.
Disegni, verifichi e riutilizzi le righe restituite
Per visualizzare il risultato nel tradizionale stile verticale, collochi in alto la prima riga restituita e prosegua verso il basso nell’ordine dell’elenco. In ogni riga diversa da zero, disegni i punti sopra le barre. L’elenco symbols presenta prima un token combinato di punti, quando necessario, e poi un token di barra per ogni gruppo di cinque; la conchiglia è l’unico simbolo dello zero. Il campo value è utile per etichette accessibili o debug, mentre power consente di mostrare i valori posizionali accanto a un diagramma didattico. Per verificare la conversione, moltiplichi il valore di ogni riga per venti elevato alla relativa potenza e sommi i prodotti: il totale deve coincidere con number. L’algoritmo usa solo divisione intera e resti, senza rete, casualità, orologio, regole locali o stato modificabile; lo stesso input genera sempre lo stesso JSON. È quindi affidabile per schede scolastiche, installazioni museali, build di siti statici e strumenti grafici. Il browser è pratico per singole conversioni, mentre l’API costa $0.002 per richiesta automatizzata.
Casi d'uso
Prepari un esempio per la lezione
Trasformi il valore decimale di un esercizio in righe posizionali che gli studenti possano disegnare e verificare.
Crei un’opera con numeri storici
Usi punti, barre e conchiglie ordinati come dati deterministici per una composizione visiva.
Controlli una conversione manuale
Confronti le cifre in base venti scritte a mano con i valori e le potenze restituiti.
Domande frequenti
Quali input sono accettati?
Il campo number deve contenere un intero JSON non negativo compreso nell’intervallo sicuro degli interi.
Come viene rappresentato lo zero?
Lo zero restituisce una riga delle unità con valore nullo, il cui elenco symbols contiene una conchiglia.
Quale riga compare per prima?
Le righe vanno dalla massima potenza di venti alla potenza zero, quindi la più significativa compare per prima.
Viene usato l’adattamento del calendario del Lungo computo?
No. La conversione impiega la base venti pura e non applica valori posizionali specifici del calendario.
Quanto costa una conversione tramite API?
Ogni richiesta API costa $0.002; lo strumento nel browser esegue localmente la stessa conversione deterministica.
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/mayan-numeral \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"number":429}'const res = await fetch("https://api.kit.forhosting.com/math/mayan-numeral", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"number": 429
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/math/mayan-numeral",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"number": 429
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/math/mayan-numeral", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"number":429}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"number":429}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/math/mayan-numeral", 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
{
"number": 429
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "math.mayan_numeral",
"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. |