curl -X POST https://api.occultapi.com/api/astro/tamil_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}'Tamil takvimi kameri değil güneş takvimidir; onu buradaki bölgesel takvimlerin çoğundan ayıran da budur. Bir ay, Güneş yeni bir sideral burca girdiği anda başlar; bu yüzden on iki ay (Chithirai, Vaikasi, Aani, Aadi, Aavani, Purattasi, Aippasi, Karthigai, Margazhi, Thai, Maasi ve Panguni) Güneş'in konumunu izler ve her yıl yaklaşık aynı Gregoryen tarihlerde başlar; yılı 14 Nisan civarında Chithirai ayı açar. Bir ayın ilk günü gün batımı kuralıyla belirlenir: Güneş'in burca girişi gün doğumu ile gün batımı arasına düşerse o takvim günü ayın ilk günüdür; gün batımından sonraya düşerse ertesi gün ilk gün olur. Buna karşılık Telugu, Marathi, Gujarati ve Kannada takvimleri ayları yeni aydan veya dolunaydan sayar. `year` değerini `latitude`, `longitude` ve `timezone_as_float` ile birlikte POST edin. Her dini günün belirlenmesinde kullanılan gün doğumu ve gün batımı bu koordinatlar için hesaplanır; bu yüzden konumu değiştirirseniz bir olay bir gün kayabilir. Yanıt `{year, events}` biçimindedir; her olay `{name, date, tamil_month, tamil_day}` biçimindedir (Gregoryen tarih ve Tamil ayı içindeki konum) ve liste tüm Gregoryen yılı kapsar. Pongal, Puthandu, Thai Pusam, Masi Magam, Panguni Uthiram, Aadi Perukku, Karadaiyan Nombu, Ayutha Poojai ve diğerleri Tamil adlarıyla yer alır. Bu bayramların bir kısmı, ana Hindu bayram motorunun hesapladığı kameri tithilerin aynısıdır; Tamil adıyla aranır ve ardından kendi dini gün kuralına (sunrise, madhyahna, aparahna, nishita, pradosha veya purvahna) göre belirlenir. Bunlar önceden hesaplanmış bayram tablosundan geldiği için bu endpoint 2006-2046 yıllarıyla sınırlıdır. Birkaç giriş tahminle doldurulmak yerine bilerek dışarıda bırakılmıştır; bunlar arasında Agni Nakshatram, Vedaya özgü üç Avani Avittam tarihi, Gayathri Japam ve Agastya Arghya vardır.
| Alan | Tür | Zorunlu | Notlar |
|---|---|---|---|
| latitude | number (double) | zorunlu | Yerin enlemi, ondalık derece cinsinden. Pozitif değer kuzeyi, negatif değer güneyi gösterir. Örnek: Jaipur için 26.9124, New York için 40.7128. Dakika ve saniye kabul edilmez - önce ondalık dereceye çevirin. |
| longitude | number (double) | zorunlu | Yerin boylamı, ondalık derece cinsinden. Pozitif değer doğuyu, negatif değer batıyı gösterir. Örnek: Jaipur için 75.7873, New York için -74.0060. İşarete dikkat edin: eksi işaretini unutursanız New York Çin'e düşer. |
| timezone_as_float | number (double) | zorunlu | Yerin UTC farkı, saat cinsinden ondalık sayı olarak. Örnek: Hindistan için 5.5 (UTC+05:30), kışın New York için -5, Nepal için 5.75. Bu değer date_time ile karşılaştırılıp DOĞRULANMAZ - ikisi birbirini tutmazsa yanlış an için başarılı bir yanıt alırsınız; bu yüzden ikisini de aynı kaynaktan alın. Bugünkü farkı değil, o tarihte geçerli olan farkı kullanın: yaz saati uygulayan bir ülkede yaz aylarında doğan biri için yaz saati farkı gerekir. |
| year | integer | zorunlu | Doğum yılı, sayı olarak; ör. 1990. Dört basamaklı. min 2006 · max 2046 |