Онам — не один день, а череда дней, привязанных к идущим подряд накшатрам: от Atham (Hasta) через Thiruvonam до Chathayam. Этот эндпоинт возвращает весь этот период для заданного года, по строке на каждый календарный день.
В каждой строке указаны day_number, григорианская дата, день недели на английском и письмом малаялам, управляющая накшатра, месяц и день по календарю малаялам с годом эры Коллам, список captions с тем, что отмечают в этот день (Atthachamayam, Athapoo Pookalam, Vallam Kali и так далее), флаг is_repeat_day и segments с точными моментами начала и конца накшатры по местному времени.
Число дней не фиксировано. Если накшатра длится так долго, что захватывает два восхода, появляется повторный день — с тем же названием, пустым captions и null вместо начала и конца, — и череда удлиняется. Короткая накшатра, наоборот, может слиться со следующим днём, и тогда в его captions будут два названия. Обычно получается двенадцать или тринадцать строк.
Передайте год, широту, долготу и смещение 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: если значения расходятся, вы получите успешный ответ для неверного момента, поэтому берите оба из одного источника. Используйте смещение, действовавшее на эту дату, а не сегодняшнее: для рождения летом в стране с летним временем нужно летнее смещение.
