Все периоды ретроградности за год в одном небольшом ответе. Ретроградное движение, или вакри, — это видимое попятное смещение планеты на фоне звёзд; в астрологической практике такие интервалы считаются особой фазой в поведении планеты.
Передайте только `year`. Ответ — `data.planets`: объект с ключами по названиям планет, в каждом — список меток `{start, end}` в UTC. Периоды, переходящие через границу года, обрезаются по 1 января и 31 декабря, так что окно, начинающееся в `01-01 00:00:00`, на самом деле началось в предыдущем году. Если планета в этом году ни разу не становится ретроградной, её список пуст.
Возвращается десять ключей: mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, rahu и ketu. Солнца и Луны в списке нет: с Земли они никогда не бывают ретроградными. Раху и Кету рассчитываются по среднему лунному узлу, который весь год равномерно движется назад без стационарных точек, поэтому у обоих всегда одно окно на весь год; с истинным узлом получились бы десятки ложных записей длиной в несколько дней.
Чтобы найти момент стационарной точки, сначала определяется день, когда скорость по долготе меняет знак, затем момент уточняется внутри этого дня; погрешность значительно меньше минуты. Те же данные есть в `/api/planetary_details/` вместе с восемью другими расчётами, а этот эндпоинт возвращает только ретроградность.
Поля запроса
| Поле | Тип | Обязательно | Примечания |
|---|
| year | integer | обязательный | Год рождения числом, например 1990. Четыре цифры. min 1800 · max 2400 |
Полный справочник по этому эндпоинту