Натальные карты

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

Базовый расчёт

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "datetime": "1990-06-15T14:30:00",
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": "Europe/London"
  }'

Параметры

Параметр	Тип	Обязателен	Описание
datetime	string	Да	Дата и время в формате ISO 8601
latitude	number	Да	Широта (от -90 до 90)
longitude	number	Да	Долгота (от -180 до 180)
timezone	string	Да	Идентификатор часового пояса IANA
houseSystem	string	Нет	Система домов (по умолчанию: "placidus")

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

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

Ответ

{
  "data": {
    "type": "natal-chart",
    "attributes": {
      "planets": {
        "sun": { "longitude": 84.5, "latitude": 0, "sign": "gemini", "house": 10 },
        "moon": { "longitude": 245.2, "latitude": -3.1, "sign": "sagittarius", "house": 4 }
      },
      "houses": {
        "1": { "cusp": 180.5, "sign": "libra" },
        "2": { "cusp": 210.3, "sign": "scorpio" }
      },
      "aspects": [
        { "planet1": "sun", "planet2": "moon", "aspect": "opposition", "orb": 0.7 }
      ]
    }
  }
}

Включаемые объекты

По умолчанию включены следующие небесные тела:

• Солнце, Луна
• Меркурий, Венера, Марс, Юпитер, Сатурн, Уран, Нептун, Плутон
• Северный узел, Южный узел
• Хирон, Лилит (Чёрная Луна)
• Часть Судьбы

Луна и Солнце

Рассчитывайте фазу Луны, освещённость, время восхода/захода и данные о позиции Солнца.

POST /api/calc/moon-sun

curl -X POST "https://api.astroapi.cloud/api/calc/moon-sun" \
  -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"
    }
  }'

Параметры

Параметр	Тип	Обязателен	Описание
dateTime	string	Да	Дата и время в формате YYYY-MM-DDTHH:mm
location.latitude	number	Да	Широта (от -90 до 90)
location.longitude	number	Да	Долгота (от -180 до 180)
location.timezone	string	Да	Идентификатор часового пояса IANA

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

Этот эндпоинт требует модуль module:moon.

Ответ

{
  "data": {
    "moon": {
      "phaseName": "Waxing Gibbous",
      "phase": 0.62,
      "illumination": 0.78,
      "age": 9.2,
      "distance": 384400,
      "diameterDegrees": 0.52,
      "rise": "2024-06-15T14:23:00Z",
      "set": "2024-06-16T02:15:00Z"
    },
    "sun": {
      "rise": "2024-06-15T05:18:00Z",
      "set": "2024-06-15T22:03:00Z",
      "transit": "2024-06-15T13:40:00Z",
      "distance": 151820000,
      "diameterDegrees": 0.524,
      "twilight": {
        "civil": {
          "begin": "2024-06-15T04:38:00Z",
          "end": "2024-06-15T22:43:00Z"
        },
        "nautical": {
          "begin": "2024-06-15T03:32:00Z",
          "end": "2024-06-15T23:49:00Z"
        },
        "astronomical": {
          "begin": null,
          "end": null
        }
      }
    }
  }
}

Точность расчётов

AstroAPI использует Swiss Ephemeris для высокоточных расчётов. Все позиции вычисляются с точностью до угловой секунды.

Бета: альтернативный движок расчётов

Экспериментальная функция

Эта функция находится в бета-версии и может иметь проблемы с точностью. Используйте с осторожностью в production-среде.

AstroAPI предлагает альтернативный движок расчётов (calc2), который использует собственную реализацию для прямого чтения и оценки файлов данных Swiss Ephemeris SE1, вместо использования официальной библиотеки Swiss Ephemeris. Этот движок оптимизирован для скорости и может обеспечивать более быстрое время ответа.

Чтобы использовать альтернативный движок, включите заголовок X-Use-Calc2 в ваш запрос:

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "X-Use-Calc2: true" \
  -H "Content-Type: application/json" \
  -d '{
    "datetime": "1990-06-15T14:30:00",
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": "Europe/London"
  }'

Ключевые отличия

Аспект	Стандартный движок	Движок Calc2 (бета)
Реализация	Swiss Ephemeris	Собственная реализация
Источник данных	Файлы эфемерид SE1	Файлы эфемерид SE1 (те же данные)
Скорость	Стандартная	Потенциально быстрее
Точность	Точность до угловой секунды (эталон)	Возможны незначительные отклонения
Статус	Готов к production	Бета

Когда использовать Calc2

• Рекомендуется для: приложений с высокой нагрузкой, где скорость важнее абсолютной точности
• Не рекомендуется для: приложений, требующих максимальной астрономической точности

Известные ограничения

• Собственная реализация может давать несколько иные результаты по сравнению с официальной библиотекой Swiss Ephemeris
• Находится в активной разработке и тестировании
• Для критически важных приложений результаты следует сверять со стандартным движком