Транзиты

Рассчитывайте планетарные транзиты и их аспекты к натальной карте за указанный период времени.

Расчёт транзитов

Расчёт транзитов для диапазона дат:

curl -X POST "https://api.astroapi.cloud/api/calc/transit" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-01T00:00",
    "transitDateEnd": "2024-01-31T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

Параметры

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

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

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

Ответ

Ответ включает переходы транзитов (когда планеты входят/выходят из знаков или домов), позиции транзитных планет в домах, аспекты между транзитными и натальными планетами, и URL карт.

{
  "data": {
    "crossings": [...],
    "transitHouses": [...],
    "aspects": [
      {
        "point1": "saturn",
        "point2": "sun",
        "aspect": "conjunction",
        "orb": 1.2,
        "applying": true
      }
    ],
    "charts": {
      "transit": {
        "title": "Transit Chart (Bi-wheel)",
        "url": "..."
      },
      "natal": {
        "title": "Natal Chart",
        "url": "..."
      }
    },
    "natalPoints": [...],
    "natalHouses": [...],
    "transitPoints": [...]
  }
}

Пользовательские орбы

Укажите пользовательские значения орбов для различных типов аспектов:

curl -X POST "https://api.astroapi.cloud/api/calc/transit" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-01T00:00",
    "transitDateEnd": "2024-01-31T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "orbs": {
      "conjunction": 3,
      "opposition": 3,
      "trine": 2,
      "square": 2
    }
  }'

С текстом интерпретации

Включите текст интерпретации в расчёты транзитов:

curl -X POST "https://api.astroapi.cloud/api/calc/transit" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-15T00:00",
    "transitDateEnd": "2024-01-15T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "includeText": true,
    "language": "en"
  }'

Экспорт в iCal

Экспортируйте события транзитов в виде файла iCal (.ics), который можно импортировать в календарные приложения, такие как Google Calendar, Apple Calendar или Outlook.

POST /api/calc/transit/ical

curl -X POST "https://api.astroapi.cloud/api/calc/transit/ical" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-01T00:00",
    "transitDateEnd": "2024-03-31T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }' --output transits.ics

Ответ представляет собой файл text/calendar с заголовком Content-Disposition: attachment; filename="transits.ics".

Параметры

Экспорт в iCal принимает те же параметры, что и стандартный эндпоинт транзитов, плюс:

Параметр	Тип	Обязателен	Описание
aspects	array	Нет	Фильтрация по типам аспектов (например, ["conjunction", "trine"])

TIP

Импортируйте скачанный файл .ics в ваше календарное приложение, чтобы видеть события транзитов как записи в календаре с описанием каждого аспекта.