Символические направления
Символические направления: 1 год = 1 степень.
Используйте эту страницу для изучения простой техники зодиакального направления, при которой каждый год жизни сдвигает точку ровно на один градус. В API это конечная точка основных направлений с method=zodiacal, direction=direct, и key=ptolemy.
Конечная точка
https://api.freeastroapi.com/api/v1/western/directions/primary/directions/primary/calendar/directions/primary/searchТочные настройки
Используйте символические зодиакальные дуги вместо мирских направлений in-mundo.
Переместите промистора вперед по зодиаку.
Примените фиксированный ключ Птолемея: 1,0 градуса в год.
Минимальный запрос
Это возвращает точные строки направления в запрошенном диапазоне дат. Запрос ниже представляет собой тот же образец checked-in, который использовался для живого ответа.
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": "Symbolic Directions 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": "zodiacal",
"direction": "direct",
"key": "ptolemy",
"promissors": [
"sun",
"moon",
"mercury",
"venus",
"mars"
],
"significators": [
"asc",
"mc",
"sun",
"moon"
],
"aspects": [
"conjunction",
"sextile",
"square",
"trine",
"opposition"
],
"orb_years": 1,
"include_natal_reference": false
},
"range": {
"start_date": "2026-01-01",
"end_date": "2030-12-31",
"limit": 20
}
}'Птолемей, Найбод, или Обычай
Для этой конкретной техники используйте key=ptolemy. Это точно 1.0 степени в год.
key=naibod близко, но не идентично. Он использует среднюю скорость солнечной дуги, примерно 0,9856 градусов в год. Используйте его только тогда, когда вы намеренно хотите рассчитать время Найбода.
Вы также можете явно выразить тот же фиксированный ключ с помощью специального ключа:
{
"settings": {
"method": "zodiacal",
"direction": "direct",
"key": "custom",
"custom_key_deg_per_year": 1.0
}
}Вариант календаря
Используйте маршрут календаря, когда пользовательскому интерфейсу требуется компактный поток точных символических направлений вместо полных строк событий. Приведенный ниже пример ответа создан на основе этого запроса.
curl -X POST "https://api.freeastroapi.com/api/v1/western/directions/primary/calendar" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"natal": {
"name": "Symbolic Directions 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": "zodiacal",
"direction": "direct",
"key": "ptolemy",
"promissors": [
"sun",
"moon",
"mercury",
"venus",
"mars"
],
"significators": [
"asc",
"mc",
"sun",
"moon"
],
"aspects": [
"conjunction",
"square",
"trine",
"opposition"
],
"orb_years": 1,
"include_natal_reference": false
},
"range": {
"start_date": "2026-01-01",
"end_date": "2026-12-31",
"limit": 20
}
}'Поля ответа для проверки
| Field | Meaning |
|---|---|
| meta.key_deg_per_year | Подтверждает примененную клавишу направления. Птолемей возвращает 1.0. |
| directions[].age_years | Возраст в точном совершенстве, полученный из дуги/ключа. |
| directions[].arc_deg | Направленная дуга в зодиакальных градусах. |
| directions[].directed_longitude_deg | Долгота обещания после символического направления. |
| directions[].active_window | Окно сферы вокруг точного направления, контролируемое orb_years. |
Реальный запрос
В этом запросе checked-in используется временная натальная карта Лондона и фиксированный ключ Птолемея. Он генерируется из той же полезной нагрузки, что и пример команды curl.
{
"natal": {
"name": "Symbolic Directions 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": "zodiacal",
"direction": "direct",
"key": "ptolemy",
"promissors": [
"sun",
"moon",
"mercury",
"venus",
"mars"
],
"significators": [
"asc",
"mc",
"sun",
"moon"
],
"aspects": [
"conjunction",
"sextile",
"square",
"trine",
"opposition"
],
"orb_years": 1,
"include_natal_reference": false
},
"range": {
"start_date": "2026-01-01",
"end_date": "2030-12-31",
"limit": 20
}
}Реальный ответ
Этот ответ был сгенерирован из локальной серверной реализации primary-directions с запросом выше. Это подтверждает key_deg_per_year: 1 и возвращает точные строки символьного направления.
{
"meta": {
"endpoint": "primary_directions",
"version": "v1",
"method": "zodiacal",
"calculation_method": "zodiacal_ptolemy_key_symbolic_zodiacal",
"zodiac_type": "tropical",
"direction": "direct",
"key": "ptolemy",
"key_deg_per_year": 1,
"range_start": "2026-01-01",
"range_end": "2030-12-31",
"generated_at": "2026-05-19T16:59:59.930337+00:00",
"warnings": [
"Zodiacal directions are symbolic arc directions unless a named zodiacal primary-direction method is selected."
]
},
"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"
],
"significators": [
"asc",
"mc",
"sun",
"moon"
],
"aspects": [
"conjunction",
"sextile",
"square",
"trine",
"opposition"
],
"orb_years": 1,
"search_step_deg": 0.25,
"secondary_motion": "none",
"latitude_doctrine": "none",
"bounds_system": "egyptian",
"include_bounds": false,
"include_bound_promissors": false,
"include_antiscia": false,
"include_contra_antiscia": false,
"include_mundane_parallels": false
},
"directions": [
{
"id": "pd.direct.moon.square.mc.2026-08-13T18:47:00.430412Z",
"date": "2026-08-13",
"exact_datetime_utc": "2026-08-13T18:47:00.430412Z",
"exact_datetime_local": "2026-08-13T19:47:00.430412+01:00",
"age_years": 36.6148,
"direction": "direct",
"promissor": "moon",
"significator": "mc",
"aspect": {
"name": "square",
"angle_deg": 90
},
"arc_deg": 36.614835,
"arc_group_id": "pdg.zodiacal.direct.moon.2026-08-13T18:47:00.430412Z.36.614835",
"key": "ptolemy",
"key_deg_per_year": 1,
"promissor_natal_longitude_deg": 333.267655,
"directed_longitude_deg": 9.88249,
"significator_longitude_deg": 279.88249,
"measurement": "zodiacal",
"orb_years": 1,
"active_window": {
"from": "2025-08-13",
"exact": "2026-08-13",
"to": "2027-08-14",
"from_datetime_utc": "2025-08-13T12:58:15.300812Z",
"exact_datetime_utc": "2026-08-13T18:47:00.430412Z",
"to_datetime_utc": "2027-08-14T00:35:45.560012Z",
"from_datetime_local": "2025-08-13T13:58:15.300812+01:00",
"exact_datetime_local": "2026-08-13T19:47:00.430412+01:00",
"to_datetime_local": "2027-08-14T01:35:45.560012+01:00"
},
"interpretation_key": "primary_direction.direct.square.moon.mc"
},
{
"id": "pd.direct.moon.square.sun.2027-07-20T02:30:41.783478Z",
"date": "2027-07-20",
"exact_datetime_utc": "2027-07-20T02:30:41.783478Z",
"exact_datetime_local": "2027-07-20T03:30:41.783478+01:00",
"age_years": 37.5466,
"direction": "direct",
"promissor": "moon",
"significator": "sun",
"aspect": {
"name": "square",
"angle_deg": 90
},
"arc_deg": 37.546606,
"arc_group_id": "pdg.zodiacal.direct.moon.2027-07-20T02:30:41.783478Z.37.546606",
"key": "ptolemy",
"key_deg_per_year": 1,
"promissor_natal_longitude_deg": 333.267655,
"directed_longitude_deg": 10.814261,
"significator_longitude_deg": 280.814261,
"measurement": "zodiacal",
"orb_years": 1,
"active_window": {
"from": "2026-07-19",
"exact": "2027-07-20",
"to": "2028-07-19",
"from_datetime_utc": "2026-07-19T20:41:56.653878Z",
"exact_datetime_utc": "2027-07-20T02:30:41.783478Z",
"to_datetime_utc": "2028-07-19T08:19:26.913078Z",
"from_datetime_local": "2026-07-19T21:41:56.653878+01:00",
"exact_datetime_local": "2027-07-20T03:30:41.783478+01:00",
"to_datetime_local": "2028-07-19T09:19:26.913078+01:00"
},
"interpretation_key": "primary_direction.direct.square.moon.sun"
},
{
"id": "pd.direct.mercury.conjunction.moon.2027-08-06T17:13:33.433592Z",
"date": "2027-08-06",
"exact_datetime_utc": "2027-08-06T17:13:33.433592Z",
"exact_datetime_local": "2027-08-06T18:13:33.433592+01:00",
"age_years": 37.5948,
"direction": "direct",
"promissor": "mercury",
"significator": "moon",
"aspect": {
"name": "conjunction",
"angle_deg": 0
},
"arc_deg": 37.594829,
"arc_group_id": "pdg.zodiacal.direct.mercury.2027-08-06T17:13:33.433592Z.37.594829",
"key": "ptolemy",
"key_deg_per_year": 1,
"promissor_natal_longitude_deg": 295.672825,
"directed_longitude_deg": 333.267655,
"significator_longitude_deg": 333.267655,
"measurement": "zodiacal",
"orb_years": 1,
"active_window": {
"from": "2026-08-06",
"exact": "2027-08-06",
"to": "2028-08-05",
"from_datetime_utc": "2026-08-06T11:24:48.303992Z",
"exact_datetime_utc": "2027-08-06T17:13:33.433592Z",
"to_datetime_utc": "2028-08-05T23:02:18.563192Z",
"from_datetime_local": "2026-08-06T12:24:48.303992+01:00",
"exact_datetime_local": "2027-08-06T18:13:33.433592+01:00",
"to_datetime_local": "2028-08-06T00:02:18.563192+01:00"
},
"interpretation_key": "primary_direction.direct.conjunction.mercury.moon"
}
]
}Реальный ответ календаря
Этот компактный канал событий создается на основе приведенного выше запроса календаря и полезен для интерфейсов временной шкалы или alert-style.
{
"meta": {
"endpoint": "primary_directions",
"version": "v1",
"method": "zodiacal",
"calculation_method": "zodiacal_ptolemy_key_symbolic_zodiacal",
"zodiac_type": "tropical",
"direction": "direct",
"key": "ptolemy",
"key_deg_per_year": 1,
"range_start": "2026-01-01",
"range_end": "2026-12-31",
"generated_at": "2026-05-19T16:59:59.931677+00:00",
"warnings": [
"Zodiacal directions are symbolic arc directions unless a named zodiacal primary-direction method is selected."
]
},
"events": [
{
"date": "2026-08-13",
"exact_datetime_utc": "2026-08-13T18:47:00.430412Z",
"exact_datetime_local": "2026-08-13T19:47:00.430412+01:00",
"type": "primary_direction",
"title": "Moon direct square Midheaven",
"direction_id": "pd.direct.moon.square.mc.2026-08-13T18:47:00.430412Z",
"interpretation_key": "primary_direction.direct.square.moon.mc"
}
]
}Записка астролога
На этой странице документирован рабочий процесс timing-row для фиксированных символических направлений one-degree-per-year. Если вам нужна полная карта, в которой каждая планета, угол и куспид дома заметно продвигаются вперед по одной и той же дуге, используйте эту конечную точку для определения времени и просмотрите соответствующие Quotidian документы диаграммы для текущего ответа диаграммы arc-based. Quotidian использует основу solar-arc, поэтому он не идентичен фиксированному ключу Птолемея.
Полные варианты классического и символического направления.
Вторичная, обратная, третичная, ежедневная и четверичная карты.