Онам — не один день, а послідовність днів, прив’язана до накшатр, що йдуть одна за одною: від Atham (Hasta) через Thiruvonam до Chathayam. Цей ендпоінт повертає все це вікно для заданого року, по одному рядку на цивільний день.
Кожен рядок містить day_number, григоріанську дату, день тижня англійською й письмом малаялам, накшатру цього дня, місяць і день за календарем малаялам із роком ери Коллам, список captions із назвами того, що відзначають цього дня (Atthachamayam, Athapoo Pookalam, Vallam Kali тощо), прапорець is_repeat_day і segments із точними моментами початку й кінця накшатри за місцевим часом.
Кількість днів не фіксована. Накшатра, що триває через два сходи Сонця, дає повторний день — та сама назва, порожні captions, null для початку й кінця — і розтягує послідовність; коротка, навпаки, може приєднатися до наступного дня, і тоді в його captions буде дві назви. Зазвичай виходить дванадцять чи тринадцять рядків.
Передайте year разом із latitude, longitude і зміщенням від UTC; рік має бути в межах від 2006 до 2046. Щоб отримати Онам одним записом із датою серед повного року свят Керали, використовуйте /api/astro/malayalam_calendar/.
Поля запиту
Поле
Тип
Обов’язкове
Примітки
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: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення.