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}'Календар телугу — місячно-сонячний за системою аманта: місяці тривають від одного молодика до наступного й мають назви телугу (Chaithramu, Vaisakhamu, Jyesthamu, Ashadhamu, Sravanamu, Bhadhrapadamu, Asvayujamu, Karthikamu, Margasiramu, Pushyamu, Maghamu і Phalgunamu), а роки лічать за Шака Самват, і рік починається з Ugadi на Chaithramu Shukla Padyami. Арифметика місяців, зокрема визначення адхіка-місяця, та сама, що й у календарях маратхі й каннада: ці три календарі відрізняються назвами місяців і списком свят, а не астрономією. Сонячної схеми переходу від знака до знака, як у тамільському календарі й календарі малаялам, тут немає. Надішліть `year` разом із `latitude`, `longitude` і `timezone_as_float`. Відповідь — `{year, events}`, і кожна подія — це лише `{name, date}`; на відміну від тамільського календаря, полів місяця чи дня місяця тут немає. Очікуйте близько дев’яноста записів на рік: двадцять чотири екадаші (двадцять шість в адхіка-рік) під назвами телугу разом із варіантами Gauna і Vaishnava на наступний день, яких немає в більшості інших регіональних календарів, приблизно двадцять п’ять Pradosh Vrat, названих за днями тижня (Ravi, Soma, Bhauma, Budha, Guru, Shukra, Shani), дванадцять Sankashtahara Chaturthi, дванадцять врат Shukla Dwadashi та основні свята. Схід і захід Сонця та вікно прадоші обчислюються для надісланих координат, тож в іншому місті дата може зсунутися на день; зокрема, правило Pradosh Vrat відносить кожну трайодаші до того цивільного дня, з вікном прадоші якого (після заходу Сонця) вона перетинається найбільше. Свята, спільні з основним індуським календарем, беруться з попередньо обчисленої таблиці, яка охоплює лише 2006-2046.
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| latitude | number (double) | обов’язковий | Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. |
| longitude | number (double) | обов’язковий | Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. |
| timezone_as_float | number (double) | обов’язковий | Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення. |
| year | integer | обов’язковий | Рік народження числом, напр. 1990. Чотири цифри. min 2006 · max 2046 |