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

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

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

bash

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",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

Параметры

Параметр	Тип	Обязателен	Описание
`dateTime`	string	Да	Дата и время в формате YYYY-MM-DDTHH:mm
`location.latitude`	number	Да	Широта (от -90 до 90)
`location.longitude`	number	Да	Долгота (от -180 до 180)
`location.timezone`	string	Да	Идентификатор часового пояса IANA
`houseSystem`	string	Нет	Система домов (по умолчанию: "placidus")
`points`	array	Нет	Небесные точки для расчёта (см. Доступные точки ниже)
`orbs`	object	Нет	Пользовательские значения орбов по типу аспекта (например, `{ "conjunction": 8, "opposition": 6 }`)
`language`	string	Нет	Код языка для текстового содержимого (по умолчанию: `"en"`)
`includeText`	boolean	Нет	Включить текст интерпретации (по умолчанию: `false`)
`includeReadableEntities`	boolean	Нет	Включить читаемые названия сущностей (по умолчанию: `false`)

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

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

Ответ

json

{
  "data": {
    "dateTime": "1990-06-15T12:30:00.000Z",
    "points": {
      "sun": {
        "pointId": "sun",
        "longitude": 84.5,
        "sign": "gemini",
        "signTitle": "Gemini",
        "degreesInSign": 24.5,
        "degreesInSignDms": [24, 30, 0],
        "houseNumber": 10,
        "houseId": "house-10",
        "retrograde": false,
        "pointTitle": "Sun",
        "houseTitle": "10th House"
      },
      "moon": {
        "pointId": "moon",
        "longitude": 245.2,
        "sign": "sagittarius",
        "signTitle": "Sagittarius",
        "degreesInSign": 5.2,
        "degreesInSignDms": [5, 12, 0],
        "houseNumber": 4,
        "houseId": "house-4",
        "retrograde": false,
        "pointTitle": "Moon",
        "houseTitle": "4th House"
      }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": {
        "pointId": "descendant",
        "longitude": 0.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "aries"
      },
      "midheaven": {
        "pointId": "midheaven",
        "longitude": 270.2,
        "degreesInSign": 0.2,
        "degreesInSignDms": [0, 12, 0],
        "sign": "capricorn"
      },
      "imumCoeli": {
        "pointId": "imumCoeli",
        "longitude": 90.2,
        "degreesInSign": 0.2,
        "degreesInSignDms": [0, 12, 0],
        "sign": "cancer"
      }
    },
    "houses": {
      "cusps": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 210.3, "longitudeDms": { "degrees": 210, "minutes": 18, "seconds": 0 }, "sign": "scorpio" }
      ],
      "ascmc": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 270.2, "longitudeDms": { "degrees": 270, "minutes": 12, "seconds": 0 }, "sign": "capricorn" }
      ]
    },
    "aspects": [
      {
        "pointA": "sun",
        "pointB": "moon",
        "aspect": "opposition",
        "angle": 160.7,
        "orb": 0.7,
        "applying": false,
        "pointATitle": "Sun",
        "pointBTitle": "Moon",
        "aspectTitle": "Opposition"
      }
    ],
    "chart": {
      "url": "https://api.astroapi.cloud/api/chart2/natal.svg?..."
    }
  }
}

Куспиды домов

Каждый объект куспида содержит longitude (эклиптические градусы), longitudeDms (градусы/минуты/секунды) и sign (идентификатор знака зодиака). Первый куспид (cusps[0]) — это Асцендент. Массив ascmc содержит Асцендент, MC, ARMC и Вертекс.

Доступные точки

Используйте параметр points, чтобы выбрать, какие небесные точки рассчитывать. Если параметр не указан, используется набор по умолчанию.

Точки по умолчанию

sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, meanNode, trueNode, meanApogee, osculatingApog

Все доступные точки

Point ID	Описание
`sun`	Солнце
`moon`	Луна
`mercury`	Меркурий
`venus`	Венера
`mars`	Марс
`jupiter`	Юпитер
`saturn`	Сатурн
`uranus`	Уран
`neptune`	Нептун
`pluto`	Плутон
`meanNode`	Средний Северный Узел
`trueNode`	Истинный Северный Узел
`meanApogee`	Средняя Чёрная Луна (Лилит)
`osculatingApog`	Истинная Чёрная Луна (Лилит)
`chiron`	Хирон
`pholus`	Фол
`ceres`	Церера
`pallas`	Паллада
`juno`	Юнона
`vesta`	Веста
`interpolatedLunarApogee`	Интерполированный Лунный Апогей
`interpolatedLunarPerigee`	Интерполированный Лунный Перигей (Приап)
`earth`	Земля

Пример: рассчитать только Солнце и Марс

bash

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",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "points": ["sun", "mars"]
  }'

В ответе объект points будет содержать только sun и mars, а объект angles — все четыре угла:

json

{
  "data": {
    "points": {
      "sun": { "pointId": "sun", "longitude": 84.5, "sign": "gemini", "..." : "..." },
      "mars": { "pointId": "mars", "longitude": 12.3, "sign": "aries", "..." : "..." }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": { "pointId": "descendant", "longitude": 0.5, "sign": "aries", "..." : "..." },
      "midheaven": { "pointId": "midheaven", "longitude": 270.2, "sign": "capricorn", "..." : "..." },
      "imumCoeli": { "pointId": "imumCoeli", "longitude": 90.2, "sign": "cancer", "..." : "..." }
    },
    "houses": { "..." : "..." },
    "aspects": [ "..." ]
  }
}

Углы

Все четыре угла (ascendant, descendant, midheaven, imumCoeli) всегда включаются в объект angles, независимо от параметра points. Углы вычисляются на основе домов, а не эфемерид, поэтому имеют более простую структуру (без данных о скорости и ретроградности). Массив ascmc в ответе houses также всегда содержит необработанные долготы углов.

Луна и Солнце

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

POST `/api/calc/moon-sun`

bash

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.

Ответ

json

{
  "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 напрямую читает эфемериды JPL DE442 от NASA для субмиллисекундной точности планетных позиций. Подробности на странице Точность расчётов.

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

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

Параметры ​

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

Ответ ​

Доступные точки ​

Точки по умолчанию ​

Все доступные точки ​

Пример: рассчитать только Солнце и Марс ​

Луна и Солнце ​

POST /api/calc/moon-sun ​

Параметры ​

Ответ ​

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

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

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

Параметры

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

Ответ

Доступные точки

Точки по умолчанию

Все доступные точки

Пример: рассчитать только Солнце и Марс

Луна и Солнце

POST `/api/calc/moon-sun`

Параметры

Ответ

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