Maya-Zahlen in Punkte und Balken umrechnen
Der Maya-Zahlen-Umrechner überträgt eine nicht negative Dezimalzahl in eine übersichtliche Darstellung zur Basis zwanzig, die aus Punkten, Balken und dem Muschelsymbol für null besteht.
Im Browser ausführen – kostenlos
Das Ergebnis führt jede Stellenzeile von der höchsten Zwanzigerpotenz bis zu den Einern auf. Es eignet sich damit für Unterricht, die Prüfung handschriftlicher Aufgaben und eigene Zahlengrafiken. Jede Zeile enthält ihre Potenz, den Ziffernwert und die symbolischen Bestandteile. Die Umrechnung erfolgt deterministisch und privat im Browser; automatisierte API-Anfragen kosten jeweils $0.002.
Lesen Sie eine Maya-Zahl als Zahl zur Basis zwanzig
Maya-Zahlen verwenden wie alltägliche Dezimalzahlen ein Stellenwertsystem, doch jede Stelle ist zwanzigmal so viel wert wie die darunterliegende. Die unterste beziehungsweise unwichtigste Zeile steht für Einer, die nächste für Gruppen zu zwanzig, die folgende für Gruppen zu vierhundert und so weiter. Dieser Umrechner gibt die Zeilen in der bei Datenformaten üblichen Reihenfolge aus: Die höchstwertige Zeile steht zuerst, die Einerzeile zuletzt. Dadurch lässt sich die Liste von links nach rechts verarbeiten, während die vertikale Beziehung der geschriebenen Zahl erhalten bleibt. Innerhalb einer Zeile steht ein Punkt für eins und ein Balken für fünf. Werte von eins bis neunzehn kombinieren bis zu drei Balken mit höchstens vier Punkten. Null wird als Muschel dargestellt, damit eine unbesetzte Stelle sichtbar bleibt. Das Feld power nennt die jeweilige Zwanzigerpotenz, value liefert die Ziffer von null bis neunzehn und symbols enthält alle Bestandteile, mit denen sich die Ziffer ohne Rückrechnung zeichnen oder beschreiben lässt.
Wählen und prüfen Sie die Dezimaleingabe
Geben Sie genau ein Feld namens number mit einer JSON-Ganzzahl größer oder gleich null an. Null ist gültig und erzeugt eine Zeile mit einer Muschel, niemals ein leeres Ergebnis. Negative Werte werden abgelehnt, weil diese Darstellung hier ausschließlich für nicht negative Ganzzahlen festgelegt ist. Brüche, Zahlentext wie "429", fehlende Werte, Unendlichkeiten und Zahlen außerhalb des sicheren JavaScript-Ganzzahlbereichs werden ebenfalls zurückgewiesen, statt unbemerkt gerundet oder umgedeutet zu werden. Diese Strenge ist wichtig, wenn eine Umrechnung bewertet, gespeichert oder für eine Grafik verwendet wird: Ein Wert, der nur wie eine Zahl aussieht, darf nicht versehentlich zu einer anderen Maya-Zahl führen. Bei Erfolg wiederholt die Antwort die ursprüngliche Zahl, nennt zwanzig als Basis und liefert die Zeilen von der größten bis zur kleinsten Potenz. Auch eine innere Nullstelle bleibt enthalten, da das Entfernen einer Muschel zwischen zwei belegten Zeilen den Wert verändern würde. Sie können die Struktur daher maschinell prüfen oder die Zeichen nach eindeutigen Regeln übertragen.
Zeichnen, prüfen und verwenden Sie die Ergebniszeilen
Für die traditionelle senkrechte Darstellung setzen Sie die erste zurückgegebene Zeile nach oben und fahren in Listenreihenfolge nach unten fort. Zeichnen Sie in jeder von null verschiedenen Zeile die Punkte über die Balken. Die Liste symbols enthält bei Bedarf zuerst einen zusammengefassten Punkt-Token und danach für jede Fünfergruppe einen Balken-Token; für null steht allein die Muschel. Das Feld value hilft bei barrierefreien Beschriftungen und bei der Fehlersuche, während power die Stellenwerte neben einer Lehrgrafik ausweisen kann. Zur Kontrolle multiplizieren Sie jeden Zeilenwert mit zwanzig hoch seiner Potenz und addieren die Produkte. Die Summe muss number entsprechen. Der Algorithmus nutzt ausschließlich Ganzzahldivision und Reste, ohne Netzwerk, Zufall, Uhrzeit, Gebietsschemata oder veränderlichen Zustand. Daher entsteht aus derselben Eingabe stets dasselbe JSON. Das ist zuverlässig für Arbeitsblätter, Museumsstationen, statische Website-Builds und Gestaltungswerkzeuge. Einzelne Umrechnungen gelingen bequem im Browser; in automatisierten Abläufen kostet jede API-Anfrage $0.002.
Anwendungsfälle
Erstellen Sie ein Unterrichtsbeispiel
Wandeln Sie den Dezimalwert einer Aufgabe in klare Stellenzeilen um, die Lernende zeichnen und prüfen können.
Gestalten Sie historische Zahlengrafiken
Nutzen Sie geordnete Punkte, Balken und Muscheln als deterministische Daten für eine visuelle Komposition.
Prüfen Sie eine manuelle Umrechnung
Vergleichen Sie handgeschriebene Ziffern zur Basis zwanzig mit den ausgegebenen Werten und Potenzen.
Häufige Fragen
Welche Eingaben werden akzeptiert?
Das Feld number muss eine nicht negative JSON-Ganzzahl im sicheren Ganzzahlbereich enthalten.
Wie wird null dargestellt?
Null ergibt eine Einerzeile mit dem Wert null, deren Liste symbols eine Muschel enthält.
Welche Zeile steht zuerst?
Die Ausgabe reicht von der höchsten Zwanzigerpotenz bis zur Potenz null; die höchstwertige Zeile steht zuerst.
Wird die Kalenderanpassung der Langen Zählung genutzt?
Nein. Die Umrechnung verwendet die reine Basis zwanzig und keine kalenderspezifischen Stellenwerte.
Was kostet eine Umrechnung per API?
Jede API-Anfrage kostet $0.002; im Browser läuft dieselbe deterministische Umrechnung lokal.
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem 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)Beispiel-Anfrage
{
"number": 429
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "math.mayan_numeral",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |