Лунный календарь

Рассчитывайте информацию о фазах Луны, периоды «пустого хода» Луны (Void of Course), переходы по знакам и предстоящие лунные аспекты.

Детали дня

Получение подробной лунной информации для конкретного дня:

curl -X POST "https://api.astroapi.cloud/api/calc/moon-calendar/day" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "2024-06-15T12:00",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    },
    "aspects": ["conjunction", "sextile", "square", "trine", "opposition"]
  }'

Диапазон дат

Обзор лунного календаря для диапазона дат (максимум 31 день):

curl -X POST "https://api.astroapi.cloud/api/calc/moon-calendar/range" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": "2024-06-01",
    "endDate": "2024-06-30",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    },
    "aspects": ["conjunction", "sextile", "square", "trine", "opposition"]
  }'

Параметры

Эндпоинт дня

Параметр	Тип	Обязателен	Описание
dateTime	string	Да	Дата и время в формате YYYY-MM-DDTHH:mm
location	object	Да	Местоположение с широтой, долготой и часовым поясом
aspects	array	Нет	Аспекты для учёта при расчёте VOC

Эндпоинт диапазона

Параметр	Тип	Обязателен	Описание
startDate	string	Да	Начальная дата в формате YYYY-MM-DD
endDate	string	Да	Конечная дата в формате YYYY-MM-DD (максимум 31 день)
location	object	Да	Местоположение с широтой, долготой и часовым поясом
aspects	array	Нет	Аспекты для учёта при расчёте VOC

Доступные аспекты

• conjunction — 0 градусов
• sextile — 60 градусов
• square — 90 градусов
• trine — 120 градусов
• opposition — 180 градусов

Ответ для дня

{
  "data": {
    "date": "2024-06-15",
    "moon": {
      "sign": "leo",
      "signEntry": "2024-06-15T08:23:00Z",
      "signExit": "2024-06-17T14:45:00Z",
      "phase": {
        "name": "Waxing Gibbous",
        "illumination": 0.72,
        "age": 9.3
      }
    },
    "voidOfCourse": {
      "isVoid": true,
      "start": "2024-06-15T18:45:00Z",
      "end": "2024-06-17T14:45:00Z",
      "durationMinutes": 2640,
      "lastAspect": {
        "planet": "mars",
        "aspect": "trine",
        "exactTime": "2024-06-15T18:45:00Z"
      },
      "nextSign": "virgo"
    },
    "upcomingAspects": [
      {
        "planet": "venus",
        "aspect": "sextile",
        "exactTime": "2024-06-15T14:30:00Z",
        "applying": true
      },
      {
        "planet": "mars",
        "aspect": "trine",
        "exactTime": "2024-06-15T18:45:00Z",
        "applying": true
      }
    ]
  }
}

Ответ для диапазона

{
  "data": {
    "startDate": "2024-06-01",
    "endDate": "2024-06-30",
    "phases": [
      {
        "type": "new_moon",
        "date": "2024-06-06T12:37:00Z",
        "sign": "gemini"
      },
      {
        "type": "first_quarter",
        "date": "2024-06-14T05:18:00Z",
        "sign": "virgo"
      },
      {
        "type": "full_moon",
        "date": "2024-06-22T01:08:00Z",
        "sign": "capricorn"
      },
      {
        "type": "last_quarter",
        "date": "2024-06-28T21:53:00Z",
        "sign": "aries"
      }
    ],
    "signTransits": [
      {
        "sign": "gemini",
        "entry": "2024-06-01T03:15:00Z",
        "exit": "2024-06-03T08:45:00Z"
      },
      {
        "sign": "cancer",
        "entry": "2024-06-03T08:45:00Z",
        "exit": "2024-06-05T15:20:00Z"
      }
    ],
    "voidPeriods": [
      {
        "start": "2024-06-02T15:30:00Z",
        "end": "2024-06-03T08:45:00Z",
        "durationMinutes": 1035,
        "lastAspect": {
          "planet": "saturn",
          "aspect": "square"
        },
        "fromSign": "gemini",
        "toSign": "cancer"
      }
    ]
  }
}

Луна «в пустом ходе» (Void of Course)

«Пустой ход» Луны (VOC) — период, когда Луна больше не образует значимых аспектов с планетами до перехода в новый знак. Традиционно считается неблагоприятным для начала новых дел.

Как рассчитывается VOC

1. Определяется текущее положение и знак Луны
2. Вычисляется точное время входа Луны в следующий знак
3. Находятся все аспекты между Луной и основными планетами до смены знака
4. Последний аспект отмечает начало периода VOC
5. Период VOC заканчивается, когда Луна входит в новый знак

Поля данных VOC

Поле	Описание
isVoid	Находится ли Луна в данный момент в «пустом ходе»
start	Начало периода VOC (время последнего аспекта)
end	Окончание VOC (вход Луны в новый знак)
durationMinutes	Продолжительность периода VOC в минутах
lastAspect	Детали последнего образованного аспекта
nextSign	Знак, в который войдёт Луна следующим

Области применения

• Электив в астрологии: избегать начала важных дел во время «пустого хода» Луны
• Планирование по фазам Луны: отслеживать оптимальное время для деятельности по лунным фазам
• Астрологические календари: отображение транзитов Луны по знакам и фаз
• Планирование ритуалов: организация деятельности в соответствии с лунными циклами