Onam ist kein einzelner Tag, sondern eine Folge von Tagen, die an aufeinanderfolgende Nakshatras gebunden ist und von Atham (Hasta) über Thiruvonam bis Chathayam reicht. Dieser Endpoint liefert den ganzen Zeitraum für ein bestimmtes Jahr, eine Zeile pro bürgerlichem Tag.
Jede Zeile enthält day_number, das gregorianische Datum, den Wochentag auf Englisch und in Malayalam-Schrift, das maßgebliche Nakshatra, Monat und Tag nach dem Malayalam-Kalender mit dem Jahr der Kollam-Ära, eine Liste captions mit dem, was an diesem Tag begangen wird (Atthachamayam, Athapoo Pookalam, Vallam Kali und so weiter), ein Flag is_repeat_day und segments mit den genauen Anfangs- und Endzeitpunkten des Nakshatras in Ortszeit.
Die Zahl der Tage steht nicht fest. Reicht ein Nakshatra über zwei Sonnenaufgänge, entsteht ein Wiederholungstag – gleicher Name, leere captions, Beginn und Ende null –, und die Folge verlängert sich. Ein kurzes Nakshatra kann dagegen mit dem folgenden Tag zusammengelegt werden, der dann zwei Namen in captions hat. Zwölf oder dreizehn Zeilen sind normal.
Übergib das Jahr mit Breitengrad, Längengrad und UTC-Offset; das Jahr muss zwischen 2006 und 2046 liegen. Für Onam als einzelnen datierten Eintrag in einem ganzen Jahr keralesischer Feste nutze /api/astro/malayalam_calendar/.
Felder der Anfrage
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.