Playground lädt
curl -X POST https://api.occultapi.com/api/astro/telugu_calendar/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year":2026}'Der Telugu-Kalender ist ein lunisolarer Amanta-Kalender: Die Monate laufen von einem Neumond zum nächsten und tragen Telugu-Namen (Chaithramu, Vaisakhamu, Jyesthamu, Ashadhamu, Sravanamu, Bhadhrapadamu, Asvayujamu, Karthikamu, Margasiramu, Pushyamu, Maghamu und Phalgunamu); das Jahr wird in Shaka Samvat gezählt und beginnt mit Ugadi am Chaithramu Shukla Padyami. Die zugrunde liegende Monatsarithmetik, einschließlich der Erkennung von Adhika-Monaten, ist dieselbe wie beim Marathi- und Kannada-Kalender – die drei unterscheiden sich in Monatsnamen und Festliste, nicht in der Astronomie. Dem solaren Schema von Zeichen zu Zeichen, das der tamilische und der Malayalam-Kalender nutzen, folgt er nicht. Sende per POST `year` mit `latitude`, `longitude` und `timezone_as_float`. Die Antwort ist `{year, events}`, und jedes Ereignis ist nur `{name, date}`; anders als beim tamilischen Kalender gibt es keine Felder für Monat oder Monatstag. Rechne mit etwa neunzig Einträgen pro Jahr: die vierundzwanzig Ekadashis (sechsundzwanzig in einem Adhika-Jahr) unter ihren Telugu-Namen, zusammen mit den Gauna- und Vaishnava-Alternativen am Folgetag, die die meisten anderen Regionalkalender weglassen, rund fünfundzwanzig nach Wochentagen benannte Pradosh Vrats (Ravi, Soma, Bhauma, Budha, Guru, Shukra, Shani), die zwölf Sankashtahara Chaturthis, die zwölf Shukla-Dwadashi-Vratas und die wichtigsten Feste. Sonnenaufgang, Sonnenuntergang und das Pradosha-Zeitfenster werden für die gesendeten Koordinaten berechnet; in einer anderen Stadt kann sich ein Datum daher um einen Tag verschieben. Insbesondere die Pradosh-Vrat-Regel ordnet jede Trayodashi dem bürgerlichen Tag zu, mit dessen Pradosha-Zeitfenster nach Sonnenuntergang sie sich am stärksten überschneidet. Feste, die der Telugu-Kalender mit dem zentralen Hindu-Kalender teilt, stammen aus der vorberechneten Tabelle, die nur 2006-2046 abdeckt.
| Feld | Typ | Pflicht | Hinweise |
|---|---|---|---|
| latitude | number (double) | Pflicht | Breitengrad des Ortes in Dezimalgrad. Positiv ist Nord, negativ ist Süd. Beispiel: 26.9124 für Jaipur, 40.7128 für New York. Minuten und Sekunden werden nicht akzeptiert – vorher umrechnen. |
| longitude | number (double) | Pflicht | Längengrad des Ortes in Dezimalgrad. Positiv ist Ost, negativ ist West. Beispiel: 75.7873 für Jaipur, -74.0060 für New York. Achte auf das Vorzeichen: Ein fehlendes Minus verlegt New York nach China. |
| timezone_as_float | number (double) | Pflicht | UTC-Offset des Ortes in Stunden, als Dezimalzahl. Beispiel: 5.5 für Indien (UTC+05:30), -5 für New York im Winter, 5.75 für Nepal. Wird NICHT gegen date_time validiert – stimmen beide nicht überein, erhältst du eine erfolgreiche Antwort für den falschen Zeitpunkt; leite daher beide aus derselben Quelle ab. Nutze den an diesem Datum gültigen Offset, nicht den heutigen: Eine Sommergeburt in einem Land mit Sommerzeit braucht den Sommer-Offset. |
| year | integer | Pflicht | Geburtsjahr als Zahl, z. B. 1990. Vier Ziffern. min 2006 · max 2046 |