Йога панчанги — именованное качество дня, хорошее или плохое, которое возникает из сочетания лунного дня (титхи), дня недели (вары) и лунной стоянки (накшатры). Самые известные — Sarvartha Siddhi («все цели достигаются»), Amrit Siddhi, Tripushkara, Dagdha, Mrityu и Yamaghanta. В мухурте их используют как первый фильтр: выбирают день с благотворным сочетанием и избегают дня с неблаготворным.
Здесь сканируются целые дни. Эндпоинт проходит каждый календарный день запрошенного года, один раз определяет йоги на восходе этого дня и возвращает только дни, в которых есть хотя бы одна йога. Ответ — `data.days`, список `{date, yogas}`, где `date` — `YYYY-MM-DD`, а `yogas` — список названий; дни без йог в ответ не попадают. У большинства названий в скобках указана исходная конвенция, например "Amrit Yoga (Vaara Tithi Yoga)" или "Padma Yoga (Vashishta Samhita Yogas)": несколько классических текстов определяют частично совпадающие наборы.
Йоги определяются на момент восхода, поэтому широта, долгота и `timezone_as_float` влияют на результат. `use_28_nakshatras` по умолчанию равно true и добавляет Abhijit как самостоятельную накшатру; некоторые йоги, например понедельничная Kaana Yoga, определяются через Abhijit и без неё появиться не могут. Чтобы использовать обычный список из 27 накшатр, передайте false.
Этот эндпоинт не связан с `/api/astro/yogas/`, который ищет сочетания планет в натальной карте; натальная карта здесь вообще не используется. Если нужна именно рави-йога, `/api/astro/ravi_yoga/` даёт точное время начала и конца, а не отметку на весь день.
Поля запроса
Поле
Тип
Обязательно
Примечания
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: если значения расходятся, вы получите успешный ответ для неверного момента, поэтому берите оба из одного источника. Используйте смещение, действовавшее на эту дату, а не сегодняшнее: для рождения летом в стране с летним временем нужно летнее смещение.