Солярный и лунный возврат

Расчёт карт солярного (карты именинника) и лунного возврата. Карты возврата показывают положения планет в точный момент возвращения планеты на её натальную позицию, давая прогностическое понимание на предстоящий год или месяц.

---

Солярный возврат

Карта солярного возврата рассчитывается для точного момента возвращения Солнца к его натальной степени каждый год, что происходит вблизи дня рождения. Используется для прогнозирования тем на предстоящий год.

Необходимый модуль

Требуется модуль solar-return:calc.

curl -X POST "https://api.astroapi.cloud/api/calc/solar-return" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDateTime": "1990-06-15T14:30",
    "birthLocation": {
      "longitude": -0.1278,
      "latitude": 51.5074,
      "timezone": "Europe/London"
    },
    "returnYear": 2024,
    "houseSystem": "placidus",
    "language": "en",
    "includeText": true,
    "includeReadableEntities": true
  }'

Параметры

Параметр	Тип	Обязателен	Описание
birthDateTime	string	Да	Дата и время рождения в формате YYYY-MM-DDTHH:mm
birthLocation	object	Да	Место рождения (см. объект местоположения ниже)
returnYear	number	Нет	Год солярного возврата (по умолчанию: текущий год)
houseSystem	string	Нет	Система домов (по умолчанию: "placidus")
language	string	Нет	Код языка для текстового контента (по умолчанию: "en")
includeText	boolean	Нет	Включить текст интерпретации (по умолчанию: false)
includeReadableEntities	boolean	Нет	Включить читаемые названия сущностей (по умолчанию: false)
points	array	Нет	Небесные точки для включения в расчёт
orbs	object	Нет	Пользовательские значения орбов по типу аспекта

Объект местоположения

{
    "longitude": -0.1278,
    "latitude": 51.5074,
    "timezone": "Europe/London"
}

Ответ

{
    "data": {
        "returnYear": 2024,
        "returnDate": "2024-06-15T08:42:17Z",
        "aspects": [
            {
                "point1": "sun",
                "point2": "moon",
                "aspect": "trine",
                "orb": 1.8,
                "applying": false
            }
        ],
        "points": {
            "sun": {
                "longitude": 84.71,
                "latitude": 0.0,
                "sign": "gemini",
                "house": 10,
                "retrograde": false
            },
            "moon": {
                "longitude": 324.15,
                "latitude": -2.3,
                "sign": "aquarius",
                "house": 6,
                "retrograde": false
            }
        },
        "houses": {
            "1": { "cusp": 195.4, "sign": "libra" },
            "10": { "cusp": 84.5, "sign": "gemini" }
        },
        "charts": {
            "solarReturn": {
                "title": "Solar Return Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "biWheel": {
                "title": "Solar Return / Natal Bi-wheel",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "natal": {
                "title": "Natal Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            }
        }
    }
}

Поля ответа

Поле	Тип	Описание
returnYear	number	Год данного солярного возврата
returnDate	string	Точный момент UTC солярного возврата
aspects	array	Аспекты в карте солярного возврата
points	object	Положения планет в карте солярного возврата
houses	object	Куспиды домов карты солярного возврата
charts.solarReturn	object	URL изображения карты солярного возврата
charts.biWheel	object	Двойная карта: солярный возврат наложен на натальную карту
charts.natal	object	URL изображения натальной карты

---

Лунный возврат

Карта лунного возврата рассчитывается для точного момента возвращения Луны к её натальной степени каждый месяц (приблизительно каждые 27,3 дня). Используется для прогнозирования тем на предстоящий месяц.

Необходимый модуль

Требуется модуль lunar-return:calc.

curl -X POST "https://api.astroapi.cloud/api/calc/lunar-return" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDateTime": "1990-06-15T14:30",
    "birthLocation": {
      "longitude": -0.1278,
      "latitude": 51.5074,
      "timezone": "Europe/London"
    },
    "returnDate": "2024-06-01",
    "houseSystem": "placidus",
    "language": "en",
    "includeText": true,
    "includeReadableEntities": true
  }'

Параметры

Параметр	Тип	Обязателен	Описание
birthDateTime	string	Да	Дата и время рождения в формате YYYY-MM-DDTHH:mm
birthLocation	object	Да	Место рождения (долгота, широта, часовой пояс)
returnDate	string	Нет	Начальная дата (YYYY-MM-DD) для поиска следующего лунного возврата (по умолчанию: сейчас)
houseSystem	string	Нет	Система домов (по умолчанию: "placidus")
language	string	Нет	Код языка для текстового контента (по умолчанию: "en")
includeText	boolean	Нет	Включить текст интерпретации (по умолчанию: false)
includeReadableEntities	boolean	Нет	Включить читаемые названия сущностей (по умолчанию: false)
points	array	Нет	Небесные точки для включения в расчёт
orbs	object	Нет	Пользовательские значения орбов по типу аспекта

Ответ

{
    "data": {
        "returnDate": "2024-06-12T03:18:44Z",
        "aspects": [
            {
                "point1": "moon",
                "point2": "venus",
                "aspect": "sextile",
                "orb": 0.9,
                "applying": true
            }
        ],
        "points": {
            "moon": {
                "longitude": 245.2,
                "latitude": -3.1,
                "sign": "sagittarius",
                "house": 4,
                "retrograde": false
            }
        },
        "houses": {
            "1": { "cusp": 130.8, "sign": "leo" },
            "4": { "cusp": 240.5, "sign": "sagittarius" }
        },
        "charts": {
            "lunarReturn": {
                "title": "Lunar Return Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "biWheel": {
                "title": "Lunar Return / Natal Bi-wheel",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "natal": {
                "title": "Natal Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            }
        }
    }
}

Поля ответа

Поле	Тип	Описание
returnDate	string	Точный момент UTC лунного возврата
aspects	array	Аспекты в карте лунного возврата
points	object	Положения планет в карте лунного возврата
houses	object	Куспиды домов карты лунного возврата
charts.lunarReturn	object	URL изображения карты лунного возврата
charts.biWheel	object	Двойная карта: лунный возврат наложен на натальную карту
charts.natal	object	URL изображения натальной карты

---

Системы домов

Оба эндпоинта поддерживают те же системы домов, что и расчёты натальной карты:

Значение	Название
placidus	Плацидус (по умолчанию)
koch	Кох
equal	Равные дома
whole	Целые знаки
campanus	Кампанус
regiomontanus	Региомонтан
porphyry	Порфирий

Местоположение для карт возврата

Многие астрологи используют местоположение, где человек физически находится в момент возврата, а не место рождения. Передайте текущее место проживания или поездки в birthLocation, если хотите получить карты возврата, привязанные к конкретному местоположению.