Основные направления

Западное время

Основные направления

Рассчитайте временные ряды primary-direction из натальной карты за диапазон дат. По умолчанию используется метод Regiomontanus in-mundo, с доступными явными кампанусными, топоцентрическими, полудуговыми режимами Плацидуса, зодиакальными режимами Плацидуса under-the-pole и символическими зодиакальными режимами.

Поддерживаемые классические параметры включают точные даты и время событий, коррекцию вторичного движения Луны, элементы управления доктриной широты, сигнификаторы house-cusp, Лот Фортуны, антисию, contra-antiscia, границы Египта и Птолемея, сизигию, южный узел и мирские параллели opt-in.

Конечная точка

POST

https://api.freeastroapi.com/api/v1/western/directions/primary

Похожие маршруты

/directions/primary/exact-aspects/directions/primary/search/directions/primary/calendar

Поддержка классических методов

regiomontanus_in_mundo, campanus_in_mundo, topocentric_in_mundo, и placidus_semiarc_in_mundo возвращать мирские указания таблицы.
placidus_under_pole_zodiacal и zodiacal возвращают зодиакальные табличные направления.
Каждое событие сохраняет date и добавляет exact_datetime_utc плюс exact_datetime_local, когда можно использовать натальный часовой пояс.
Используйте явные варианты Плацидуса; двусмысленный placidus запросы отклоняются, поэтому клиенты выбирают доктрину намеренно.
Ограничение производственного реагирования составляет range.limit: 300. Используйте меньшие ограничения для виджетов временной шкалы и интерфейсов с разбивкой на страницы.

Ищете 1 год = 1 степень?

Используйте настройку символических направлений: method=zodiacal, direction=direct, и key=ptolemy. Он применяет фиксированный ключ Птолемея ровно на один градус в год.

Открыть символические направления

Примеры кода

curl -X POST "https://api.freeastroapi.com/api/v1/western/directions/primary" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "natal": {
    "name": "Documentation Sample",
    "datetime": "1990-01-01 12:00",
    "time_known": true,
    "location": {
      "city": "London",
      "lat": 51.5074,
      "lng": -0.1278,
      "tz_str": "Europe/London"
    }
  },
  "settings": {
    "method": "regiomontanus_in_mundo",
    "direction": "both",
    "key": "naibod",
    "secondary_motion": "moon",
    "latitude_doctrine": "both",
    "bounds_system": "egyptian",
    "include_bounds": true,
    "include_natal_reference": false,
    "promissors": [
      "sun",
      "moon",
      "mercury",
      "venus",
      "mars",
      "jupiter",
      "saturn"
    ],
    "significators": [
      "asc",
      "mc",
      "dc",
      "ic",
      "sun",
      "moon",
      "lot_of_fortune"
    ],
    "aspects": [
      "conjunction",
      "sextile",
      "square",
      "trine",
      "opposition"
    ],
    "orb_years": 1
  },
  "range": {
    "start_date": "2026-01-01",
    "end_date": "2030-12-31",
    "limit": 5
  }
}'

Параметры запроса

Parameter	Type	Req	Description
natal.datetime	string	Yes	Дата и время рождения. Наивные локальные строки интерпретируются с использованием natal.location.tz_str..
natal.time_known	boolean	No	Требуется, когда запрашиваются углы, куспиды домов или Лот Фортуны. По умолчанию: true.
natal.location	object	Yes	Город Натал и его координаты. Запросы City-only разрешаются, когда это возможно.
settings.method	string	No	regiomontanus_in_mundo, campanus_in_mundo, topocentric_in_mundo, placidus_semiarc_in_mundo, placidus_under_pole_zodiacal или зодиакальный. По умолчанию: regiomontanus_in_mundo.
settings.direction	string	No	прямое, обратное или и то, и другое. По умолчанию: прямой.
settings.key	string	No	найбод, птолемей, или обычай. По умолчанию: Наибод.
settings.custom_key_deg_per_year	number	No	Требуется, если settings.key является пользовательским.
settings.secondary_motion	boolean\|string	No	false/нет, true/луна. all_planets зарезервирован для будущего экспериментального режима.
settings.latitude_doctrine	string	No	нет, промисор, сигнификатор, оба или бьянкини. По умолчанию: оба для методов in-mundo, ни один для зодиакальных методов.
settings.bounds_system	string	No	египетский или птолемеевский. По умолчанию: египетский.
settings.include_bounds	boolean	No	Добавляет метаданные термина/связанного лорда для промиссора, сигнификатора и направленных позиций.
settings.include_bound_promissors	boolean	No	Генерирует промисоры точки возврата термина, такие как term_aries_1, используя выбранную систему границ.
settings.include_antiscia	boolean	No	Генерирует выбираемые точки antiscion_<point> для планет, Лота Фортуны, углов и сизигий, где это возможно.
settings.include_contra_antiscia	boolean	No	Генерирует выбираемые точки contra_antiscion_<point>.
settings.include_mundane_parallels	boolean	No	Включает параллельный и contra_parallel для методов in-mundo.
settings.include_natal_reference	boolean	No	Включите таблицу разрешенных натальных баллов. По умолчанию: true; установите false для компактных ответов API.
settings.promissors	array[string]	No	Направленные натальные точки. По умолчанию от Солнца до Сатурна. Поддерживает планеты, south_node, сизигии, lot_of_fortune, antiscia/contra-antiscia и дополнительные точки возврата терминов. Углы и куспиды домов не являются промиссорами.
settings.significators	array[string]	No	Эталонные натальные точки. Поддерживает asc, mc, dc, ic, от house_1 до house_12, планеты, south_node, syzygy, lot_of_fortune и сгенерированные классические точки.
settings.aspects	array[string]	No	соединение, секстиль, квадратура, тригон, оппозиция. При include_mundane_parallels=true: параллельно, contra_parallel.
settings.orb_years	number	No	Окно активации календаря вокруг точных направлений. По умолчанию: 1.
range.start_date	string	Yes	Поиск начинается с даты и времени YYYY-MM-DD или ISO.
range.end_date	string	Yes	Поиск заканчивается как дата-время YYYY-MM-DD или ISO.
range.limit	integer	No	Максимальное количество возвращаемых строк. По умолчанию: 100, максимум: 300.

Реальный запрос

В этом запросе checked-in используется временная натальная карта Лондона, Региомонтан in-mundo, вторичное движение Луны, доктрина both-latitude, египетские границы и компактный предел five-row.

{
  "natal": {
    "name": "Documentation Sample",
    "datetime": "1990-01-01 12:00",
    "time_known": true,
    "location": {
      "city": "London",
      "lat": 51.5074,
      "lng": -0.1278,
      "tz_str": "Europe/London"
    }
  },
  "settings": {
    "method": "regiomontanus_in_mundo",
    "direction": "both",
    "key": "naibod",
    "secondary_motion": "moon",
    "latitude_doctrine": "both",
    "bounds_system": "egyptian",
    "include_bounds": true,
    "include_natal_reference": false,
    "promissors": [
      "sun",
      "moon",
      "mercury",
      "venus",
      "mars",
      "jupiter",
      "saturn"
    ],
    "significators": [
      "asc",
      "mc",
      "dc",
      "ic",
      "sun",
      "moon",
      "lot_of_fortune"
    ],
    "aspects": [
      "conjunction",
      "sextile",
      "square",
      "trine",
      "opposition"
    ],
    "orb_years": 1
  },
  "range": {
    "start_date": "2026-01-01",
    "end_date": "2030-12-31",
    "limit": 5
  }
}

Реальный ответ

Этот ответ был сгенерирован из локальной серверной реализации с помощью приведенного выше запроса. Он показывает точные даты и время локальных событий в формате UTC, активные окна, мировые позиции Региомонтануса и метаданные привязанного лорда.

{
  "meta": {
    "endpoint": "primary_directions",
    "version": "v1",
    "method": "regiomontanus_in_mundo",
    "calculation_method": "regiomontanus_in_mundo_naibod_key_diurnal_armc_house_position_lunar_secondary_motion_both_latitude",
    "zodiac_type": "tropical",
    "direction": "both",
    "key": "naibod",
    "key_deg_per_year": 0.985647362,
    "range_start": "2026-01-01",
    "range_end": "2030-12-31",
    "generated_at": "2026-05-14T00:00:00Z",
    "warnings": [
      "In-mundo directions are computed as classical table rows with the selected primary-direction house system; zodiacal directions remain available with method=zodiacal.",
      "Secondary motion correction is applied astronomically to the Moon promissor using the directed arc converted from sidereal time to UT."
    ]
  },
  "input": {
    "birth_datetime": "1990-01-01 12:00",
    "birth_location": {
      "city": "London",
      "lat": 51.5074,
      "lng": -0.1278,
      "tz_str": "Europe/London"
    },
    "time_known": true,
    "promissors": [
      "sun",
      "moon",
      "mercury",
      "venus",
      "mars",
      "jupiter",
      "saturn"
    ],
    "significators": [
      "asc",
      "mc",
      "dc",
      "ic",
      "sun",
      "moon",
      "lot_of_fortune"
    ],
    "aspects": [
      "conjunction",
      "sextile",
      "square",
      "trine",
      "opposition"
    ],
    "orb_years": 1,
    "search_step_deg": 0.25,
    "secondary_motion": "moon",
    "latitude_doctrine": "both",
    "bounds_system": "egyptian",
    "include_bounds": true,
    "include_bound_promissors": false,
    "include_antiscia": false,
    "include_contra_antiscia": false,
    "include_mundane_parallels": false
  },
  "directions": [
    {
      "id": "pd.direct.saturn.trine.moon.2027-05-28T23:01:50.388898Z",
      "date": "2027-05-28",
      "exact_datetime_utc": "2027-05-28T23:01:50.388898Z",
      "exact_datetime_local": "2027-05-29T00:01:50.388898+01:00",
      "age_years": 37.4038,
      "direction": "direct",
      "promissor": "saturn",
      "significator": "moon",
      "aspect": {
        "name": "trine",
        "angle_deg": 120
      },
      "arc_deg": 36.866994,
      "arc_group_id": "pdg.mundane.direct.saturn.2027-05-28T23:01:50.388898Z.36.866994",
      "key": "naibod",
      "key_deg_per_year": 0.985647362,
      "promissor_natal_longitude_deg": 285.657498,
      "directed_longitude_deg": 285.657498,
      "significator_longitude_deg": 333.267655,
      "measurement": "mundane",
      "house_system": "regiomontanus",
      "promissor_natal_mundane_position": 282.675724,
      "directed_mundane_position": 214.161957,
      "significator_mundane_position": 334.161957,
      "promissor_bound": {
        "system": "egyptian",
        "sign": "capricorn",
        "index": 3,
        "lord": "venus",
        "start_deg": 284,
        "end_deg": 292
      },
      "significator_bound": {
        "system": "egyptian",
        "sign": "pisces",
        "index": 1,
        "lord": "venus",
        "start_deg": 330,
        "end_deg": 342
      },
      "directed_bound": {
        "system": "egyptian",
        "sign": "capricorn",
        "index": 3,
        "lord": "venus",
        "start_deg": 284,
        "end_deg": 292
      },
      "orb_years": 1,
      "active_window": {
        "from": "2026-05-28",
        "exact": "2027-05-28",
        "to": "2028-05-28",
        "from_datetime_utc": "2026-05-28T17:13:05.259298Z",
        "exact_datetime_utc": "2027-05-28T23:01:50.388898Z",
        "to_datetime_utc": "2028-05-28T04:50:35.518498Z",
        "from_datetime_local": "2026-05-28T18:13:05.259298+01:00",
        "exact_datetime_local": "2027-05-29T00:01:50.388898+01:00",
        "to_datetime_local": "2028-05-28T05:50:35.518498+01:00"
      },
      "interpretation_key": "primary_direction.direct.trine.saturn.moon"
    },
    {
      "id": "pd.converse.saturn.sextile.lot_of_fortune.2027-07-27T23:53:26.349170Z",
      "date": "2027-07-27",
      "exact_datetime_utc": "2027-07-27T23:53:26.349170Z",
      "exact_datetime_local": "2027-07-28T00:53:26.349170+01:00",
      "age_years": 37.5682,
      "direction": "converse",
      "promissor": "saturn",
      "significator": "lot_of_fortune",
      "aspect": {
        "name": "sextile",
        "angle_deg": 60
      },
      "arc_deg": 37.029008,
      "arc_group_id": "pdg.mundane.converse.saturn.2027-07-27T23:53:26.349170Z.37.029008",
      "key": "naibod",
      "key_deg_per_year": 0.985647362,
      "promissor_natal_longitude_deg": 285.657498,
      "directed_longitude_deg": 285.657498,
      "significator_longitude_deg": 77.397434,
      "measurement": "mundane",
      "house_system": "regiomontanus",
      "promissor_natal_mundane_position": 282.675724,
      "directed_mundane_position": 342.60122,
      "significator_mundane_position": 42.60122,
      "promissor_bound": {
        "system": "egyptian",
        "sign": "capricorn",
        "index": 3,
        "lord": "venus",
        "start_deg": 284,
        "end_deg": 292
      },
      "significator_bound": {
        "system": "egyptian",
        "sign": "gemini",
        "index": 4,
        "lord": "mars",
        "start_deg": 77,
        "end_deg": 84
      },
      "directed_bound": {
        "system": "egyptian",
        "sign": "capricorn",
        "index": 3,
        "lord": "venus",
        "start_deg": 284,
        "end_deg": 292
      },
      "orb_years": 1,
      "active_window": {
        "from": "2026-07-27",
        "exact": "2027-07-27",
        "to": "2028-07-27",
        "from_datetime_utc": "2026-07-27T18:04:41.219570Z",
        "exact_datetime_utc": "2027-07-27T23:53:26.349170Z",
        "to_datetime_utc": "2028-07-27T05:42:11.478770Z",
        "from_datetime_local": "2026-07-27T19:04:41.219570+01:00",
        "exact_datetime_local": "2027-07-28T00:53:26.349170+01:00",
        "to_datetime_local": "2028-07-27T06:42:11.478770+01:00"
      },
      "interpretation_key": "primary_direction.converse.sextile.saturn.lot_of_fortune"
    },
    {
      "id": "pd.converse.jupiter.trine.mc.2027-10-31T09:31:58.251733Z",
      "date": "2027-10-31",
      "exact_datetime_utc": "2027-10-31T09:31:58.251733Z",
      "exact_datetime_local": "2027-10-31T09:31:58.251733+00:00",
      "age_years": 37.8294,
      "direction": "converse",
      "promissor": "jupiter",
      "significator": "mc",
      "aspect": {
        "name": "trine",
        "angle_deg": 120
      },
      "arc_deg": 37.28646,
      "arc_group_id": "pdg.mundane.converse.jupiter.2027-10-31T09:31:58.251733Z.37.286460",
      "key": "naibod",
      "key_deg_per_year": 0.985647362,
      "promissor_natal_longitude_deg": 95.148794,
      "directed_longitude_deg": 95.148794,
      "significator_longitude_deg": 279.88249,
      "measurement": "mundane",
      "house_system": "regiomontanus",
      "promissor_natal_mundane_position": 78.877261,
      "directed_mundane_position": 150,
      "significator_mundane_position": 270,
      "promissor_bound": {
        "system": "egyptian",
        "sign": "cancer",
        "index": 1,
        "lord": "mars",
        "start_deg": 90,
        "end_deg": 97
      },
      "significator_bound": {
        "system": "egyptian",
        "sign": "capricorn",
        "index": 2,
        "lord": "jupiter",
        "start_deg": 277,
        "end_deg": 284
      },
      "directed_bound": {
        "system": "egyptian",
        "sign": "cancer",
        "index": 1,
        "lord": "mars",
        "start_deg": 90,
        "end_deg": 97
      },
      "orb_years": 1,
      "active_window": {
        "from": "2026-10-31",
        "exact": "2027-10-31",
        "to": "2028-10-30",
        "from_datetime_utc": "2026-10-31T03:43:13.122133Z",
        "exact_datetime_utc": "2027-10-31T09:31:58.251733Z",
        "to_datetime_utc": "2028-10-30T15:20:43.381333Z",
        "from_datetime_local": "2026-10-31T03:43:13.122133+00:00",
        "exact_datetime_local": "2027-10-31T09:31:58.251733+00:00",
        "to_datetime_local": "2028-10-30T15:20:43.381333+00:00"
      },
      "interpretation_key": "primary_direction.converse.trine.jupiter.mc"
    },
    {
      "id": "pd.converse.jupiter.sextile.ic.2027-10-31T09:31:58.251733Z",
      "date": "2027-10-31",
      "exact_datetime_utc": "2027-10-31T09:31:58.251733Z",
      "exact_datetime_local": "2027-10-31T09:31:58.251733+00:00",
      "age_years": 37.8294,
      "direction": "converse",
      "promissor": "jupiter",
      "significator": "ic",
      "aspect": {
        "name": "sextile",
        "angle_deg": 60
      },
      "arc_deg": 37.28646,
      "arc_group_id": "pdg.mundane.converse.jupiter.2027-10-31T09:31:58.251733Z.37.286460",
      "key": "naibod",
      "key_deg_per_year": 0.985647362,
      "promissor_natal_longitude_deg": 95.148794,
      "directed_longitude_deg": 95.148794,
      "significator_longitude_deg": 99.88249,
      "measurement": "mundane",
      "house_system": "regiomontanus",
      "promissor_natal_mundane_position": 78.877261,
      "directed_mundane_position": 150,
      "significator_mundane_position": 90,
      "promissor_bound": {
        "system": "egyptian",
        "sign": "cancer",
        "index": 1,
        "lord": "mars",
        "start_deg": 90,
        "end_deg": 97
      },
      "significator_bound": {
        "system": "egyptian",
        "sign": "cancer",
        "index": 2,
        "lord": "venus",
        "start_deg": 97,
        "end_deg": 103
      },
      "directed_bound": {
        "system": "egyptian",
        "sign": "cancer",
        "index": 1,
        "lord": "mars",
        "start_deg": 90,
        "end_deg": 97
      },
      "orb_years": 1,
      "active_window": {
        "from": "2026-10-31",
        "exact": "2027-10-31",
        "to": "2028-10-30",
        "from_datetime_utc": "2026-10-31T03:43:13.122133Z",
        "exact_datetime_utc": "2027-10-31T09:31:58.251733Z",
        "to_datetime_utc": "2028-10-30T15:20:43.381333Z",
        "from_datetime_local": "2026-10-31T03:43:13.122133+00:00",
        "exact_datetime_local": "2027-10-31T09:31:58.251733+00:00",
        "to_datetime_local": "2028-10-30T15:20:43.381333+00:00"
      },
      "interpretation_key": "primary_direction.converse.sextile.jupiter.ic"
    },
    {
      "id": "pd.direct.saturn.sextile.sun.2028-10-19T11:15:59.846321Z",
      "date": "2028-10-19",
      "exact_datetime_utc": "2028-10-19T11:15:59.846321Z",
      "exact_datetime_local": "2028-10-19T12:15:59.846321+01:00",
      "age_years": 38.7988,
      "direction": "direct",
      "promissor": "saturn",
      "significator": "sun",
      "aspect": {
        "name": "sextile",
        "angle_deg": 60
      },
      "arc_deg": 38.241964,
      "arc_group_id": "pdg.mundane.direct.saturn.2028-10-19T11:15:59.846321Z.38.241964",
      "key": "naibod",
      "key_deg_per_year": 0.985647362,
      "promissor_natal_longitude_deg": 285.657498,
      "directed_longitude_deg": 285.657498,
      "significator_longitude_deg": 280.814261,
      "measurement": "mundane",
      "house_system": "regiomontanus",
      "promissor_natal_mundane_position": 282.675724,
      "directed_mundane_position": 212.165018,
      "significator_mundane_position": 272.165018,
      "promissor_bound": {
        "system": "egyptian",
        "sign": "capricorn",
        "index": 3,
        "lord": "venus",
        "start_deg": 284,
        "end_deg": 292
      },
      "significator_bound": {
        "system": "egyptian",
        "sign": "capricorn",
        "index": 2,
        "lord": "jupiter",
        "start_deg": 277,
        "end_deg": 284
      },
      "directed_bound": {
        "system": "egyptian",
        "sign": "capricorn",
        "index": 3,
        "lord": "venus",
        "start_deg": 284,
        "end_deg": 292
      },
      "orb_years": 1,
      "active_window": {
        "from": "2027-10-20",
        "exact": "2028-10-19",
        "to": "2029-10-19",
        "from_datetime_utc": "2027-10-20T05:27:14.716721Z",
        "exact_datetime_utc": "2028-10-19T11:15:59.846321Z",
        "to_datetime_utc": "2029-10-19T17:04:44.975921Z",
        "from_datetime_local": "2027-10-20T06:27:14.716721+01:00",
        "exact_datetime_local": "2028-10-19T12:15:59.846321+01:00",
        "to_datetime_local": "2029-10-19T18:04:44.975921+01:00"
      },
      "interpretation_key": "primary_direction.direct.sextile.saturn.sun"
    }
  ]
}